Memberships
Invite a user to a workspace
Creates a membership inviting a user to a workspace with the given role and initial operational policies. The invited user must accept before the membership becomes active.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/accounts.v1.Accounts/CreateMembership" \ -H "Content-Type: application/json" \ -d '{ "userId": "q83vq83vEjRWeBI0VniQqg==", "workspaceId": "AAECAwQFBgcICQoLDA0ODw==", "role": "MEMBERSHIP_ROLE_MEMBER", "inviterId": "EjRWeBI0VniQEjRWeBI0Vg==", "policies": [ "trading", "analytics" ] }'{
"membership": {
"id": "ICEiIyQlJicoKSorLC0uLw==",
"userId": "q83vq83vEjRWeBI0VniQqg==",
"workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
"role": "MEMBERSHIP_ROLE_MEMBER",
"status": "MEMBERSHIP_STATUS_INVITED",
"createdAt": "2026-06-29T12:00:00Z",
"updatedAt": "2026-06-29T12:00:00Z",
"policies": [
"trading",
"analytics"
]
}
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "not_found",
"message": "The requested resource does not exist in this workspace."
}{
"code": "already_exists",
"message": "The resource already exists."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}