Ensure an Admin Identity

POST /api/v1/forward/identities/admin/ensure This endpoint does not require a request body. Repeated calls return the same Admin Identity.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/identities/admin/ensure' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

Example response

HTTP 200 OK

{
  "id": "idn_admin",
  "external_id": "__qca_admin_identity__",
  "name": "QCA Console Admin",
  "identity_type": "admin",
  "enabled": true,
  "metadata": {},
  "created_at": "2026-07-14T10:00:00Z",
  "updated_at": "2026-07-14T10:00:00Z"
}

Errors

HTTP	Type	Code	Trigger
401	`authentication_error`	`authentication_required`	The PAT or SAT is invalid, expired, or missing.
500	`api_error`	-	The Identity could not be created or queried.

Notes

The Admin Identity is managed by the system and cannot be modified through the standard Identity update, delete, enable, or disable endpoints.

​Headers

​Example request

​Example response

​Errors

​Notes

Headers

Example request

Example response

Errors

Notes