Skip to main content
GET
get_tenant

Authorizations

X-API-Key
string
header
required

Path Parameters

external_ref
string
required

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

Required string length: 1 - 128
Pattern: ^\S(.*\S)?$

Response

Successful Response

One of the partner's child tenants. Send X-NDI-Tenant: ext:<external_ref> to act for it.

created_at
string<date-time>
required

When the tenant was created.

data_retention
enum<string>
required

The data-retention setting in force for the tenant. A stored zero_retention reads as short while this deployment does not offer zero retention.

Available options:
short,
zero_retention
disabled
boolean
required

Whether the tenant is disabled. Its data is kept.

display_name
string | null
required

Human-readable name of the tenant.

external_ref
string
required

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

id
string<uuid>
required

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

limits
TenantLimits · object
required

The limits in force for the tenant.

retention_tier
enum<string>
required

The tenant's account tier for job retention: a paid tenant's job inputs, outputs and processing files are removed 48 hours after the job finishes, a free tenant's 7 days after. A failed or cancelled job counts from the failure or cancel.

Available options:
paid,
free