Skip to main content
Identities

Admin Identity を確保する

現在のアカウントの Admin Identity を取得し、存在しない場合は作成します。

POST /api/v1/forward/identities/admin/ensure リクエスト本文は不要です。繰り返し呼び出しても同じ Admin Identity が返されます。

リクエストヘッダー

Header必須説明
AuthorizationはいBearer <PAT または SAT>

リクエスト例

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

レスポンス例

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"
}

エラー

HTTPTypeCode発生条件
401authentication_errorauthentication_requiredPAT または SAT が無効、期限切れ、または指定されていません。
500api_error-Identity の作成または取得に失敗しました。

注意事項

Admin Identity はシステムによって管理され、通常の Identity の更新、削除、有効化、無効化 API では変更できません。
ベストプラクティス