List users

Get https://app.mk.io/api/v1/organization/users

This endpoint shows the details of all users with access to this organization in MK.IO.

RBAC Capability Required: core.user.get

Authentication

Authorization Bearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

200 OK

• kind string Required
  The kind of record.
• value list of objects [UserBriefSchema](https://docs.mediakind.com/api-reference/management-api/schemas/userbriefschema) Required
  List of users
  • kind string Optional
    The kind of record.
  • metadata object [UserMetadata](https://docs.mediakind.com/api-reference/management-api/schemas/usermetadata) Required
    Metadata.
    • id string Required format: uuid
      The unique identifier of the user.
    • spec object [UserBriefSpec](https://docs.mediakind.com/api-reference/management-api/schemas/userbriefspec) Required
      Specification.
      • avatar string Required <=200 characters
        Avatar.
      • email string Required 1-1024 characters
        Contact email address
      • name string Required 1-1024 characters
        Full name.

Errors

400 Bad Request

• error object [ErrorDetail](https://docs.mediakind.com/api-reference/management-api/schemas/errordetail) Required
  Pertinent information about the error
  • code string Required
  • detail string Required
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

401 Unauthorized
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error
Each of these error responses follows the same format as 400 Bad Request, with the respective error codes and messages.