Delete an API key
DELETE /api/v1/keys/{id}
Permanently deletes an API key in the organization. Any key in the organization can be deleted (not only the caller's own). Requires an interactive (JWT) session: an API key cannot delete keys. Requires a read/write or admin role; read-only members cannot delete keys. Use the X-Organization-Id header to choose the organization; otherwise the caller's default organization is used.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | API key id |
Header parameters
| Name | Type | Required | Description |
|---|---|---|---|
X-Organization-Id | integer | no | Selects which of the caller's organizations the request acts on. When omitted, the caller's default organization is used. |
Example request
curl https://api.mobilenexthq.com/api/v1/keys/{id} \
-X DELETE \
-H 'Authorization: Bearer mob_...'
Responses
204 — API key deleted
401 — Missing or invalid Bearer token
{
"error": {
"code": "string",
"message": "string"
}
}
403 — Caller lacks permission for this action (e.g. not an admin)
{
"error": {
"code": "string",
"message": "string"
}
}
404 — Resource not found
{
"error": {
"code": "string",
"message": "string"
}
}