Delete Api-Key

delete/v1/api-key/{api_key_id}

Revokes an API key by id. Side effects: the key is deactivated and immediately stops authenticating any further requests. This cannot be undone, mint a fresh key if access is still needed. Returns 204 with no body on success.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

NameTypeRequiredDescription
api_key_idstring <uuid>YesUUID of the API key to revoke.e.g. d5e6f708-1a2b-4c3d-9e0f-1a2b3c4d5e6f

Request

cURL
curl -X DELETE https://api.wellapp.ai/v1/api-key/{api_key_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

204 — API key revoked. No content is returned.

401 — Missing or invalid bearer token.

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — No API key exists with the supplied id.

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}