Dashboard API
Routes that require a Cognito JWT from Architect.
These 18 routes are used by Architect and custom review tools. Organization secrets return 401.
| Endpoint | Credential | What it does |
|---|---|---|
POST /v1/organizations | Cognito JWT | Create an organization for the signed-in user who has no tenant yet. |
GET /v1/organizations/me | Cognito JWT | Return the caller's organization. |
PATCH /v1/organizations/me | Cognito JWT | Replace the organization display name. |
GET /v1/organizations/me/members | Cognito JWT | List active and invited organization members. |
POST /v1/organizations/me/members | Cognito JWT | Invite a user to the organization by email. |
POST /v1/organizations/me/secrets | Cognito JWT | Issue a new organization secret for CLI ingest. |
GET /v1/organizations/me/secrets | Cognito JWT | List organization secrets (metadata only — no plaintext). |
DELETE /v1/organizations/me/secrets/{secretId} | Cognito JWT | Revoke an organization secret. |
GET /v1/organizations/me/environments | Cognito JWT | List developer environments registered for the organization. |
GET /v1/organizations/me/environments/{environmentId} | Cognito JWT | Fetch one developer environment by id. |
DELETE /v1/organizations/me/environments/{environmentId} | Cognito JWT | Revoke a developer environment. |
GET /v1/agents | Cognito JWT | List supported agent definitions in the Relay catalog. |
GET /v1/organizations/me/agents | Cognito JWT | List agent installations for the organization. |
POST /v1/organizations/me/agents | Cognito JWT | Create an agent installation from the dashboard. |
PATCH /v1/organizations/me/agents/{installationId} | Cognito JWT | Update an agent installation's version, config, or status. |
GET /v1/organizations/me/sessions | Cognito JWT | List captured sessions for review in Architect. |
GET /v1/organizations/me/sessions/{sessionId} | Cognito JWT | Fetch one session with metadata for the review UI. |
GET /v1/organizations/me/sessions/{sessionId}/events | Cognito JWT | Page through events for a session. |
Ready to ship?
Get started free