Endpoints for organizations accessible to the authenticated user

List accessible organizations

GET /v1/orgs

Returns the list of organizations that the authenticated user has access to. This includes:

• Organizations where the user is a direct member (kind: 'direct')
• Child organizations if the user belongs to a partner organization (kind: 'partnership')
• All active organizations if the user is an Archera staff member (kind: 'staff')

Each organization includes the user's role and membership kind.

Responses

200 OK

{
  "org_id": "string",  
  "name": "string",  
  "role": "string",  
  "kind": "undefined"
}

• org_id (string, Required): Unique organization identifier
  • Pattern: [0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\Z
• name (string, Required): Organization name
• role (string, Enum, Required): User's role in the organization (e.g., admin, user, support, cloud_rep, restricted_user)
  • Possible values: user, admin, support, cloud_rep, restricted_user
• kind (undefined, Enum, Required): Type of membership: 'direct' (direct member), 'partnership' (via partner org), 'staff' (Archera staff)
  • Possible values: direct, staff, partnership

Error Responses

• 400 Bad request
• 401 Unauthorized
• 403 Forbidden
• 404 Not found
• 405 Method not allowed
• 409 Conflict
• 500 Internal server error
• default Default error response

Example Request

GET /v1/orgs HTTP/1.1
Accept: */*

Example Response

[
  {
    "org_id": "text",
    "name": "text",
    "role": "user",
    "kind": "direct"
  }
]