Skip to main content
Identities

アイデンティティを削除する

Forward Identity を削除します。

DELETE /api/v1/forward/identities/{identity_id} 削除後、この Identity を使用して Session を作成したり、有効な Identity を必要とする操作を実行したりすることはできません。

Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT または SAT>

Path parameters

ParameterTypeRequiredDescription
identity_idstringYesForward Identity ID。

Example request

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

Example response

HTTP 200 OK
{
  "id": "idn_019eabc123",
  "deleted": true
}

Response fields

FieldTypeDescription
idstring削除された Identity ID。
deletedboolean削除が完了したかどうか。成功時は true

Errors

HTTPTypeCode発生条件
401authentication_errorauthentication_requiredPAT または SAT が無効または期限切れです。
404not_found_error-Identity が存在しないか、呼び出し元から参照できません。
409conflict_error-現在の状態では Identity を削除できません。

Notes

  • 削除された Identity は新しい Session の作成に使用できません。
  • 既存の Session、イベント、監査レコードはこの操作の影響を受けません。
ベストプラクティス