Get organisation by ID
Returns the organisation details. The authenticated user must be a member of the organisation to access it. **Required scope:** `org:read`
Authorization
BearerAuth Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.
In: header
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/organisations/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "owner": "534359f7-5407-4b19-ba92-c71c370022a5", "config": { "table_constraints": null, "features": [ { "key": "string", "enabled": true, "phase": "string", "default_enabled": true } ] }, "userCount": 0, "createdAt": "string", "updatedAt": "string", "deletedAt": "string"}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}Query the audit trail
Returns a paginated, filterable audit log of user actions within the organisation. Useful for compliance (SOC 2) and governance reviews. **Required scope:** `org:audit:read`
Delete an organisation
Soft-deletes the organisation and all its memberships. Member accounts are untouched — they keep any other organisation memberships and can still sign in. Only the organisation owner can perform this action. **Required scope:** `org:admin`