Get a management client

GET /v1/management-clients/{application_id} · permission management-clients:read

Returns the management client record of one application. The response carries an ETag header; send it as If-Match to update or delete the record. Only an API key can call this endpoint.

Request

Parameter In Description
application_id path Application ID (app_…).

Response

200 OK

{
  "application_id": "app_01h455vb4pex5vsknk084sn02q",
  "permissions": ["users:read", "users:write"],
  "allowed_cidrs": ["203.0.113.0/24"]
}

Errors

HTTP code When
403 insufficient_permissions The credential lacks management-clients:read, or it is not an API key.
404 not_found The application has no record in this environment.

Example

curl -i https://api.eu.keenauth.com/v1/management-clients/app_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth management-clients get app_01h455vb4pex5vsknk084sn02q (the ETag is printed to stderr).