Organizations

Organization management endpoints

Get user organizations

get

Retrieve all organizations for the current user

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Organizations retrieved successfully

application/json

401

Missing or invalid authentication token.

application/json

403

Insufficient permissions to list organizations.

application/json

404

No organizations found.

application/json

500

Internal server error occurred while retrieving organizations.

application/json

get

/api/v1/orgs

HTTPcURLJavaScriptPython

GET /api/v1/orgs HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "org-2Xk9mPqR",
      "name": "My Organization",
      "description": "Engineering team organization",
      "referral_code": "XTL2MprN",
      "status": "active"
    }
  ]
}

Get organization

get

Retrieve organization by ID

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

org_idstringRequired

Organization ID

Responses

200

Organization retrieved successfully

application/json

400

Invalid organization ID format.

application/json

401

Missing or invalid authentication token.

application/json

403

Insufficient permissions to view organization details.

application/json

404

Organization not found with the provided ID.

application/json

500

Internal server error occurred while retrieving organization.

application/json

get

/api/v1/orgs/{org_id}

HTTPcURLJavaScriptPython

GET /api/v1/orgs/{org_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "org-2Xk9mPqR",
  "name": "My Organization",
  "description": "Engineering team organization",
  "referral_code": "XTL2MprN",
  "status": "active"
}