NAnace
tenants

put_tenant

Create the tenant, or update the one with this external_ref.

Answers 201 when it was created and 200 when it already existed, so it is safe to repeat. Limits above the partner's own are lowered to them. Cost class: write.

put/v1/tenants/{external_ref}

Request

Path parameters

external_refstring required

The partner's own reference for the tenant, such as its account id.

Request body

data_retention'short' | 'zero_retention'

Retention for document operations — a client setting, not a request field.

A data-handling guarantee a caller can accidentally opt out of on one endpoint is not a guarantee, so this is configured per client at onboarding and appears in no request body.

disabledboolean nullable

True disables the tenant (its requests answer tenant_disabled); false re-enables it.

display_namestring nullable

Human-readable name of the tenant.

workspace_storage_limit_bytesinteger nullable

Allowance for current source-file bytes across this tenant’s managed workspaces. Omit to preserve the allowance; null removes it. Enforcement requires WORKSPACE_STORAGE_LIMITS_ENABLED.

Response

Successful Response

created_atstring date-time required

When the tenant was created.

data_retention'short' | 'zero_retention' required

Retention for document operations — a client setting, not a request field.

A data-handling guarantee a caller can accidentally opt out of on one endpoint is not a guarantee, so this is configured per client at onboarding and appears in no request body.

disabledboolean required

Whether the tenant is disabled. Its data is kept.

display_namestring nullable required

Human-readable name of the tenant.

external_refstring required

The partner's own reference for the tenant, unique per partner.

idstring uuid required

NDI's id for the tenant; X-NDI-Tenant accepts it too.

Changes

No recorded changes to this operation across all 2 revisions of this API.