MspsOrgs

manageMspOrgs

PUT
/api/v1/msps/{msp_id}/orgs

Assign existing organizations to this MSP account or unassign organizations from it by providing the desired operation and org IDs.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

msp_id*string
Formatuuid

Request Body

application/json

Request Body

Request to assign or unassign orgs for an MSP account

op*msp_org_change_operation

Assignment operation to apply to the listed org IDs. enum: assign, unassign.

Value in

  • "assign"
  • "unassign"
org_ids*array<string>

List of org IDs to assign to or unassign from the MSP account

Response Body

curl -X PUT "https://example.com/api/v1/msps/000000ab-00ab-00ab-00ab-0000000000ab/orgs" \  -H "Content-Type: application/json" \  -d '{    "op": "assign",    "org_ids": [      "2b069b358-4c97-5319-1f8c-7c5ca64d6ab1"    ]  }'
Empty