Revoke an Admin Portal link
DELETE /v1/admin-portal-links/{link_id} · permission admin-portal-links:write
Revokes the link; every portal session it opened ends at once. Revoking an already revoked link also returns 204 and writes no new audit record. The revocation is audited as admin_portal_link.revoked.
Request
| Field | Type | Required | Description |
|---|---|---|---|
link_id |
path | yes | Link ID (apl_…). |
No request body.
Response
204 No Content.
Errors
| HTTP | code | When |
|---|---|---|
| 404 | not_found |
The link does not exist in this environment. |
| 401 | unauthenticated |
The credential is missing, invalid or revoked. |
| 403 | insufficient_permissions |
The credential lacks the required permission. |
| 429 | rate_limited |
The rate limit was exceeded; retry after the Retry-After period. |
| 503 | service_unavailable |
A dependency is temporarily unavailable; retry after the Retry-After period. |
Example
curl -i -X DELETE "https://api.eu.keenauth.com/v1/admin-portal-links/apl_01j9xv2c4d6e8f0g2h4j6k8m0n" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"