Skip to main content
View as Markdown

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

NameTypeRequiredDescription
idstringyesAPI key id

Header parameters

NameTypeRequiredDescription
X-Organization-IdintegernoSelects 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"
}
}