Observability Entitlement Grant Withheld
URI: https://docs.ankatech.co/errors/observability-entitlement-grant-withheld
HTTP Status: 409 Conflict
When you see this
A platform administrator asked to grant a tenant the observability-export entitlement, the permission to declare an observability destination of its own. In this release the grant is withheld, and nothing was written.
An export destination that answers with an HTTP redirect could make the collector send that tenant's telemetry, together with the headers carrying the destination's credentials, to a host the platform never validated. Until the collector refuses redirects, no tenant is newly entitled.
What stays available:
- Revoking the entitlement, so it can still be withdrawn from a tenant that holds it.
- Reading the entitlement.
- A tenant that already holds the entitlement keeps it until a platform administrator revokes it. Revoking only stops the tenant declaring or changing destinations: a destination already configured keeps exporting until it is disabled or deleted.
The refusal is recorded in the tenant's audit trail as a denied grant.
Response Example
{
"type": "https://docs.ankatech.co/errors/observability-entitlement-grant-withheld",
"title": "Observability Entitlement Grant Withheld",
"status": 409,
"detail": "Granting the observability-export entitlement is withheld in this release: an export destination that answers with a redirect could send a tenant's telemetry and its destination credentials to another host. Revoking and reading the entitlement remain available.",
"instance": "/api/v3/admin/platform/tenants/3f6c2a1e-8b4d-4e7a-9c15-2d8f0b6a7e41/observability/entitlement",
"timestamp": 1790000000,
"extensions": {
"requestId": "6a1f4c2e-93b8-4d0a-b7e5-1c2d3e4f5a6b"
}
}
Content-Type: application/problem+json — the response follows RFC 9457 Problem Details.
How to Resolve
- Do not retry the grant: it is refused on every attempt in this release.
- Review the observability destinations of tenants that already export telemetry to a destination of their own. Disable or delete any destination you do not trust: that is what stops its export. Revoke the entitlement as well, so the tenant cannot declare a new destination.
Operations that emit it
| Method | Endpoint |
|---|---|
| POST | /api/v3/admin/platform/tenants/{tenantId}/observability/entitlement |
Related Errors
- Observability Export Not Entitled - A tenant without the entitlement tried to declare a destination of its own
For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.