List user's organizations and any associated invitation – Management API – MediaKind
List user's organizations and any associated invitation
Get https://app.mk.io/api/v1/user/organizations
This endpoint returns a list of organizations that the user has access to, or is invited to.
Requires authentication; no additional RBAC permissions required.
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 [UserOrganizationSchema](https://docs.mediakind.com/api-reference/management-api/schemas/userorganizationschema)(Required)
List of organizations the user can access or has been invited to.
Show 3 properties
kind: string (Optional)
The kind of record.
metadata: object [UserOrganizationMetadataSchema](https://docs.mediakind.com/api-reference/management-api/schemas/userorganizationmetadataschema) (Optional)
Metadata.
id: string (Required format: uuid)
ID of the organization.
name: string (Required)
Name of the organization.
spec: object [UserOrganizationSpecSchema](https://docs.mediakind.com/api-reference/management-api/schemas/userorganizationspecschema) (Optional)
Specification.
invite: object [UserOrganizationPendingInviteSchema](https://docs.mediakind.com/api-reference/management-api/schemas/userorganizationpendinginviteschema) (Optional)
Pending invitation to work with this organization.
Show 3 properties
comment: string (Required)
Comment from the inviter.
invitedBy: string or null (Required)
Email of the user who sent the invite.
state: enum (Required)
State of the invite.
Allowed values: accepted, pending
Errors
400 Bad Request
- error:
object [ErrorDetail](https://docs.mediakind.com/api-reference/management-api/schemas/errordetail)(Required)
Pertinent information about the error
Show 3 properties
code: string (Required)
The error code.
detail: string (Required)
The error message.
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