Tenants

A tenant is one of your customers — the employer you are hiring for. Each tenant has its own jobs, candidates and usage inside Aiviue, and one partner account can manage several tenants.

The X-Tenant-ID header

Send the tenant on every resource request:

X-Tenant-ID: <tenant id>

The value is the Aiviue tenant ID we give you when a tenant is set up — not an ID from your own system. Store the mapping between your customer and its Aiviue tenant ID on your side.

Requests that don't need a tenant:

• POST /v1/auth/token, POST /v1/auth/token/revoke, GET /v1/auth/.well-known/jwks.json
• GET /v1/integration/health and GET /v1/integration/health/detailed

Errors

Your own IDs

Your IDs live in the request bodies, not in headers. For example external_job_id on a job is your stable job ID, and external_client_id can carry your own customer reference.