Skip to content

HTTP API / Tenant

Tenant API ​

8 operations. Paths are relative to the API host (http://localhost:5080 in local development). Every operation accepts an OIDC bearer token (Authorization: Bearer …) or a workspace API key (X-Api-Key: keel_live_…); errors are RFC 9457 Problem Details with a code (error codes). Permissions: matrix.

MethodPathSummary
GET/api/v1/tenant/deletionWhether the organization is scheduled for deletion, and when (any member: the app shows a banner).
POST/api/v1/tenant/deletionOwner: delete the organization in 7 days (type its slug to confirm). It is read-only until then and the Owners are emailed; cancel before the date to keep it.
DELETE/api/v1/tenant/deletionOwner: cancel the scheduled deletion within its grace period; the organization is writable again.
GET/api/v1/tenant/product-analyticsWhether this tenant shares product usage analytics (hashed ids, no customer data).
PUT/api/v1/tenant/product-analyticsOpt the tenant out of product analytics, or back in (Owner). Applies within a minute on every instance.
GET/api/v1/tenant/support-accessSupport access (Owner): the active consent for Anchor support and every support session, newest first.
POST/api/v1/tenant/support-accessGrant Anchor support time-boxed, read-only access (1–168 hours, with a reason). Replaces an active grant.
DELETE/api/v1/tenant/support-accessWithdraw support access: open support sessions end at once.

GetTenantDeletion ​

http
GET /api/v1/tenant/deletion

Whether the organization is scheduled for deletion, and when (any member: the app shows a banner).

StatusDescriptionBody
200OKTenantDeletionStateDto

Response 200: TenantDeletionStateDto

FieldTypeNotes
scheduledTenantDeletionDto?

RequestTenantDeletion ​

http
POST /api/v1/tenant/deletion

Owner: delete the organization in 7 days (type its slug to confirm). It is read-only until then and the Owners are emailed; cancel before the date to keep it.

Request body (application/json): RequestTenantDeletionRequest

FieldTypeNotes
confirmSlugstring
StatusDescriptionBody
200OKTenantDeletionDto

Response 200: TenantDeletionDto

FieldTypeNotes
exportboolean
iduuid
purgeJobIduuid?
requestedAtdate-time
requestedByNamestring
requestedByTypestring
scheduledFordate-time

CancelTenantDeletion ​

http
DELETE /api/v1/tenant/deletion

Owner: cancel the scheduled deletion within its grace period; the organization is writable again.

StatusDescriptionBody
200OKTenantDeletionDto

Response 200: TenantDeletionDto

FieldTypeNotes
exportboolean
iduuid
purgeJobIduuid?
requestedAtdate-time
requestedByNamestring
requestedByTypestring
scheduledFordate-time

GetProductAnalyticsSetting ​

http
GET /api/v1/tenant/product-analytics

Whether this tenant shares product usage analytics (hashed ids, no customer data).

StatusDescriptionBody
200OKProductAnalyticsSettingDto

Response 200: ProductAnalyticsSettingDto

FieldTypeNotes
changedAtdate-time?
optedOutboolean

SetProductAnalyticsSetting ​

http
PUT /api/v1/tenant/product-analytics

Opt the tenant out of product analytics, or back in (Owner). Applies within a minute on every instance.

Request body (application/json): ProductAnalyticsRequest

FieldTypeNotes
optedOutboolean
StatusDescriptionBody
200OKProductAnalyticsSettingDto

Response 200: ProductAnalyticsSettingDto

FieldTypeNotes
changedAtdate-time?
optedOutboolean

GetSupportAccess ​

http
GET /api/v1/tenant/support-access

Support access (Owner): the active consent for Anchor support and every support session, newest first.

StatusDescriptionBody
200OKSupportAccessDto

Response 200: SupportAccessDto

FieldTypeNotes
activeSupportGrantDto?
sessionsSupportSessionDto[]

GrantSupportAccess ​

http
POST /api/v1/tenant/support-access

Grant Anchor support time-boxed, read-only access (1–168 hours, with a reason). Replaces an active grant.

Request body (application/json): GrantSupportAccessRequest

FieldTypeNotes
durationHoursint32
reasonstring
StatusDescriptionBody
200OKSupportGrantDto

Response 200: SupportGrantDto

FieldTypeNotes
expiresAtdate-time
grantedAtdate-time
grantedByuuid
iduuid
reasonstring

RevokeSupportAccess ​

http
DELETE /api/v1/tenant/support-access

Withdraw support access: open support sessions end at once.

StatusDescriptionBody
204No Content—

Anchor Keel is a working product name: one platform, a shared core and licensed modules (Keel Semantic, Keel Migrate). Documentation built from the repository — facts are derived from code, ADRs and the decisions log.