Skip to content

Set operator-managed tenant flags (is_simulated)

PATCH
/api/v1/admin/tenants/{tenant_id}
curl --request PATCH \
--url https://api.ultimateteam.ai/api/v1/admin/tenants/example \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <X-API-Key>' \
--data '{ "is_simulated": true }'

Update operator-managed flags on a tenant (currently is_simulated).

Idempotent: patching a flag to its current value reports changed=[] and writes no audit entry.

Args: body: Flags to set; omitted flags are untouched. tenant_id: The tenant to update. user: The authenticated platform operator (injected).

Returns: The tenant’s resulting flag values and which ones changed.

Raises: HTTPException 400: Invalid tenant id, or an empty patch. HTTPException 404: Tenant not found.

tenant_id
required
Tenant Id

Target tenant UUID

string

Target tenant UUID

Media typeapplication/json
TenantFlagsPatch

Body for PATCH /admin/tenants/{tenant_id}.

Attributes: is_simulated: When set, marks the tenant as simulated (excluded from every cadence / trial-nurture / trial-expiry query) or clears the mark. Omitted = unchanged.

object
is_simulated
Any of:
boolean
Examplegenerated
{
"is_simulated": true
}

Successful Response

Media typeapplication/json
TenantFlagsResponse

Result of a tenant-flag PATCH.

object
changed
required
Changed
Array<string>
is_simulated
required
Is Simulated
boolean
tenant_id
required
Tenant Id
string
Examplegenerated
{
"changed": [
"example"
],
"is_simulated": true,
"tenant_id": "example"
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}