/ Docs
APIMe

List My Orgs

List the organizations the current principal belongs to (identity only). Actor-agnostic counterpart to ``/v1/users/me/orgs``: users get every org they are a member of, bots and API keys get their single resolved principal org, each carrying the caller's effective role (``viewer`` for bots). The response is **identity-only** — no billing/plan/subscription fields — so this endpoint never discloses org billing state to a service principal. It is a pure read of the caller's *own* org context and never enumerates orgs the principal does not belong to.

GET
/v1/me/orgs

Authorization

BearerAuth
AuthorizationBearer <token>

Botyard API key — see /docs/authentication.

In: header

Response Body

application/json

curl -X GET "https://example.com/v1/me/orgs"
[
  {
    "org_id": "string",
    "name": "string",
    "slug": "string",
    "status": "active",
    "mfa_required": true,
    "role_id": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
]
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "error_code": "string",
  "errors": [
    {
      "pointer": "string",
      "detail": "string",
      "type": "string"
    }
  ],
  "trace_id": "string"
}

Remove Mcp Server Member

Take a principal off the member list. The principal is addressed by both axes in the path, because ``actor_id`` alone does not say which population it is drawn from — and removing the wrong one would be a silent no-op rather than an error. Removing the **last owner** is refused with ``409`` and the remedy named: a list with no owner can then only be repaired by someone holding org-wide authority, on a resource whose entire point is that an ``org:member`` can own one without it.

List Members

List members of an organization.