Skip to content

Organizations API

Organizations are tenants in CertusOrdo. Each organization has agents, API keys, and isolated data.

Create Organization

Creates a new organization and returns an API key.

POST /v1/organizations

Request

{
  "name": "Acme Corp"
}

Response

{
  "id": "f9cc87c8-ed04-4fdb-bb2b-ed82702a55b8",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "api_key": "aa_E0V7sLJNKg7H4...",
  "created_at": "2025-01-16T14:30:00Z"
}

Save the API Key

The api_key is only returned once. Store it securely.

Example

import httpx

response = httpx.post(
    "https://web-production-b910f.up.railway.app/v1/organizations",
    json={"name": "Acme Corp"}
)
org = response.json()
api_key = org["api_key"]

curl -X POST \
  https://web-production-b910f.up.railway.app/v1/organizations \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Corp"}'

List Organizations

Returns organizations accessible with your API key.

GET /v1/organizations

Headers

Header Required Description
X-API-Key Yes Your API key

Response

[
  {
    "id": "f9cc87c8-ed04-4fdb-bb2b-ed82702a55b8",
    "name": "Acme Corp",
    "slug": "acme-corp",
    "is_active": true,
    "created_at": "2025-01-16T14:30:00Z"
  }
]

Example

from certusrodo import CertusOrdoClient

client = CertusOrdoClient(api_key="aa_your_key")
orgs = client.organizations.list()

curl -H "X-API-Key: aa_your_key" \
  https://web-production-b910f.up.railway.app/v1/organizations

Get Organization

Returns details for a specific organization.

GET /v1/organizations/{id}

Path Parameters

Parameter Type Description
id UUID Organization ID

Response

{
  "id": "f9cc87c8-ed04-4fdb-bb2b-ed82702a55b8",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "is_active": true,
  "created_at": "2025-01-16T14:30:00Z",
  "updated_at": "2025-01-16T14:30:00Z"
}

Example

org = client.organizations.get("f9cc87c8-ed04-4fdb-bb2b-ed82702a55b8")

curl -H "X-API-Key: aa_your_key" \
  https://web-production-b910f.up.railway.app/v1/organizations/f9cc87c8-ed04-4fdb-bb2b-ed82702a55b8