Orgs

Endpoints for organizations accessible to the authenticated user

List accessible organizations

get

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

application/json

org_idstringRequired

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

namestringRequired

Organization name

rolestring · enumRequired

User's role in the organization (e.g., admin, user, support, cloud_rep, restricted_user)

Possible values:

kindundefined · enumRequired

Type of membership: 'direct' (direct member), 'partnership' (via partner org), 'staff' (Archera staff)

Possible values:

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

500

Internal server error

application/json

default

Default error response

application/json

get/v1/orgs

HTTPcURLJavaScriptPython

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

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