このページでは、ドキュメント化された各Compliance APIエンドポイントが返すレスポンスメッセージ、その原因、および修正方法を一覧で示します。
Compliance APIは、標準のAnthropicエラー形式でエラーを返します。これは、2xx以外のステータスコード、request-idレスポンスヘッダー、およびtypeとmessageを含むerrorオブジェクトを持つJSONボディで構成されます。サポートにエスカレーションする際は、request-idヘッダーの値を含めてください。
{
"error": {
"type": "authentication_error",
"message": "The API key provided is invalid or has been revoked."
}
}メッセージ文字列ではなく、error.typeでマッチングしてください。メッセージはランブックにコピーできる程度には安定していますが、時間の経過とともに文言が変更される可能性があります。一方、type値はAPIコントラクトの一部です。ローカルセッションエンドポイントには、同じtypeを共有するレスポンスをメッセージで区別する、ドキュメント化された例外がいくつかあります。それぞれ該当箇所で説明しています。
次の表は、再試行すべきかどうかを一目で確認できるようにしたものです。その後の各セクションでは、エラーボディの原文と修正方法を示します。
| ステータス | 再試行? | 対応 |
|---|---|---|
| 400 Bad Request | いいえ | リクエストを修正して再送信します。 |
| 401 Unauthorized | いいえ | キーを修正またはローテーションしてから再送信します。 |
| 403 Forbidden | いいえ | 不足しているスコープを追加するか、正しいキータイプを使用してから再送信します。 |
| 404 Not Found | 通常はいいえ | リソースが削除されたか、存在しませんでした。キューから削除してください。例外:pendingステータスのままのリモートセッションは、セッションが開始されるまでメッセージエンドポイントで404を返します。リモートセッションが見つからないを参照してください。ローカルセッションエンドポイントでは、メッセージLocal sessions are not available.(リストを含むすべての呼び出しで返される)は、セッションが消えたのではなく、エンドポイントが現在親組織で利用できないことを意味します。キューに入れたIDを保持し、ローカルセッションが見つからないを参照してください。 |
| 409 Conflict | いいえ | リクエストがリソースの現在の状態と競合しています。競合を解決(子リソースのデタッチなど)してから再試行してください。 |
| 429 Too Many Requests | はい、retry-afterの後 | retry-afterの秒数だけ待機してから再試行します。カーソルを進めないでください。 |
| 500 Internal Server Error | x-should-retryに依存 | 再試行する前にx-should-retryレスポンスヘッダーを確認してください。 |
| 502, 503, 504, 529 | はい、バックオフ付きで | 一時的なエラーです。指数バックオフで再試行してください。例外:ローカルセッションの503の1つはデータ依存であり、継続する可能性があります。ローカルセッションが一時的に利用不可を参照してください。 |
リクエストは構文的には有効でしたが、サーバーが拒否したパラメータが含まれていました。パラメータを修正して再試行してください。
Type: invalid_request_error
The `created_at.gte` parameter contains an invalid timestamp format. Timestamps must be provided in RFC 3339 format e.g., "2024-03-01T00:00:00Z". Got "2024-01-01".原因: created_at.*またはupdated_at.*の値(.gte、.gt、.lte、.lt)を日時として解析できませんでした。メッセージには、失敗したパラメータ名と送信された値がそのまま示されます。
修正方法: 時刻とタイムゾーンを含む完全なRFC 3339タイムスタンプを送信してください。例:2024-03-01T00:00:00Zまたは2024-03-01T00:00:00+00:00。
ローカルセッションリスト(GET /v1/compliance/apps/sessions/local)も、両方の時間境界が指定され、かつcreated_at.ltがcreated_at.gteより厳密に後でない場合、400 invalid_request_errorを返します。ボディは次のとおりです。
created_at.lt must be strictly after created_at.gte.created_at.gteより後のcreated_at.ltを送信するか、いずれかの境界を省略してください。
Type: invalid_request_error
The limit parameter must be between 1 and 1000, inclusive. Got 1500.原因: limitクエリパラメータが許容範囲外でした。メッセージに示される上限は、呼び出された特定のエンドポイントの最大値を反映しています。
修正方法: エンドポイントが受け入れる範囲内のlimitを送信してください。各リストエンドポイントには独自のlimit範囲があります。対応するCompliance APIリファレンスページのパラメータ制約を参照してください。
セッショントランスクリプトエンドポイント(GET /v1/compliance/apps/sessions/remote/{session_id}/messagesおよびGET /v1/compliance/apps/sessions/local/{session_id}/messages)は、切り捨てパラメータを同じ方法で検証します。tool_use_input_max_bytesとtool_result_max_bytesはそれぞれ正のバイト数または-1(サーバー最大値)を受け入れるため、0などの値は同じ400 invalid_request_errorを返します。
Type: invalid_request_error
Invalid `after_id`. No activity found for `after_id` "activity_invalid123"原因: after_idまたはbefore_idカーソルを不透明なカーソルとしてデコードできなかったか、アクティビティIDとして解析できませんでした。
修正方法: ページネーションカーソルは不透明な文字列として扱ってください。常に前のページで返されたfirst_idまたはlast_idの値をコピーし、has_moreがfalseになったら停止してください。オブジェクトIDからカーソルを構築しないでください。
ディレクトリ、プロジェクト、セッションの各エンドポイント(組織、ユーザー、ロール、ロール権限、グループ、グループメンバー、プロジェクト、プロジェクト添付ファイル、ローカルおよびリモートセッション、セッションメッセージ)は、after_idとbefore_idではなく不透明なpageトークンでページネーションします。同じアドバイスが適用されます。前のレスポンスのnext_page値を変更せずに渡し、has_moreがfalseになったら(または、has_moreを返さないセッションエンドポイントではnext_pageがnullになったら)停止してください。不正な形式のpageトークンは、不正な形式のafter_idまたはbefore_idと同じ400 invalid_request_errorを返します。
両方のローカルセッションエンドポイント(リストとメッセージエンドポイント)は、デコードできないpage値に対して次の400 invalid_request_errorを返します。例えば、保存後に切り詰められたり変更されたりしたトークン、または別のエンドポイントや別の親組織で発行されたトークンなどです。ローカルセッションメッセージエンドポイント(GET /v1/compliance/apps/sessions/local/{session_id}/messages)では、各pageカーソルは発行されたセッションとorderにも紐付けられているため、別のセッションまたはソート順で発行されたカーソルは同じボディを返します。
The page parameter is not a valid cursor for this request.メッセージエンドポイントのカーソルは、ウォーク(ページを一巡する処理)が開始されてから24時間後に期限切れになります。期限切れのカーソルは次を返します。
The page cursor has expired. Restart the walk without a page parameter; results will reflect the current retention boundary.最初のボディの場合、前のレスポンスの変更されていないnext_page値を、それを発行したエンドポイントとセッションに再送信してください。期限切れのカーソルの場合、pageパラメータなしで再開してください。新しいウォークは開始時点で有効な保持期間の境界を反映するため、その間に保持期間を過ぎたメッセージは返されなくなります(ローカルセッショントランスクリプトの取得を参照)。
x-api-keyヘッダーが欠落しているか、既知のキーと一致しませんでした。スコープが間違っている有効なキーは、代わりに403 Forbiddenを返します。
Type: authentication_error
The API key provided is invalid or has been revoked.原因: x-api-keyのキーが存在しないか、削除されたか、無効化されています。x-api-keyヘッダーが欠落しているか空の場合も同じボディが返されるため、シークレットストアとキーの失効ステータスの両方を確認してください。
修正方法: キーの値を確認し、claude.ai(Compliance Access Keys)またはClaude Console(Admin APIキー)で削除されていないことを確認し、有効になっていることを確認してください。Compliance APIのセットアップを参照してください。
x-api-keyのキーは有効ですが、エンドポイントが必要とするスコープを持っていません。メッセージの原文には、キーが持つスコープ(Got:)とエンドポイントが必要とするスコープ(Needed:)が一覧表示されるため、Claude Consoleやclaude.aiを再確認しなくてもキーが持つスコープを確認できます。Compliance Access Keyのスコープは作成後に変更できないため、スコープ不足の各修正方法では、既存のキーを編集するのではなく新しいキーを作成するよう指示しています。
Type: permission_error
Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_activities']原因: read:compliance_activitiesを持たないキーでGET /v1/compliance/activitiesを呼び出しました。このエラーに至る一般的な経路は2つあります。
sk-ant-api01-...)がread:compliance_activitiesスコープなしで作成された。sk-ant-admin01-...)が作成された。Compliance APIが有効になっていない間に作成されたキーはこのスコープを持ちません。Compliance APIのセットアップを参照してください。修正方法: Compliance Access Keyのスコープは作成後に変更できません。read:compliance_activitiesを含む新しいキーを作成するか、Claude Console Admin APIキーを使用してください。Admin APIキーがこのスコープを持つ条件については、どのキーが必要ですか?を参照してください。
Type: permission_error
Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['read:compliance_org_data']原因: read:compliance_org_dataを持たないキーで、組織、ロール、グループ、または有効設定のエンドポイントを呼び出しました。このエラーに至る一般的な経路は2つあります。
sk-ant-api01-...)がread:compliance_org_dataスコープなしで作成された。sk-ant-admin01-...)が使用された。Admin APIキーはread:compliance_activitiesのみを持ち、組織メタデータを読み取ることはできません。修正方法: read:compliance_org_dataを選択して新しいCompliance Access Keyを作成してください。Admin APIキーは組織メタデータを読み取れないため、Compliance Access Keyが必要です。
Type: permission_error
Missing required scopes. Got: ['read:compliance_org_settings'] Needed: ['read:compliance_org_data']原因: read:compliance_org_settingsスコープは2026年6月30日に廃止されました。GET /v1/compliance/organizations/{organization_id}/settingsは現在、他の組織エンドポイントと同じスコープであるread:compliance_org_dataを必要とし、廃止済みスコープはもはや何も認可しません。read:compliance_org_settingsのみを持つCompliance Access Keyは、廃止前は機能していたとしても、設定エンドポイントへのすべての呼び出しでこのエラーを返します。廃止済みスコープは、キー作成時に選択または付与することができなくなりました。
修正方法: Compliance Access Keyのスコープは作成後に変更できません。read:compliance_org_dataを選択して新しいCompliance Access Keyを作成し、統合を更新してそれを使用するようにしてから、古いキーを削除してください。すでにread:compliance_org_dataを持つキーは、この廃止の影響を受けません。
Type: permission_error
Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']原因: read:compliance_user_dataを持たないキーで、チャット、メッセージ、ファイル、プロジェクト、セッション、組織ユーザー、またはグループメンバーのエンドポイントを呼び出しました。このエラーに至る一般的な経路は2つあります。
sk-ant-api01-...)がread:compliance_user_dataスコープなしで作成された。sk-ant-admin01-...)が使用された。Admin APIキーはread:compliance_activitiesのみを持ち、read:compliance_user_dataを付与できないため、チャット、ファイル、プロジェクト、プロジェクト添付ファイル、セッション、ユーザー、またはグループメンバーのエンドポイントを呼び出すことはできません。修正方法: claude.aiでread:compliance_user_dataを選択して作成したCompliance Access Keyを使用してください。リクエストが本当にActivity Feedのみであるべき場合は、Admin APIキーをGET /v1/compliance/activitiesに向けてください。
Type: permission_error
Missing required scopes. Got: ['read:compliance_user_data'] Needed: ['delete:compliance_user_data']原因: delete:compliance_user_dataを持たないCompliance Access Keyで、チャット、ファイル、またはプロジェクトのDELETEエンドポイントを呼び出しました。
修正方法: delete:compliance_user_dataを選択して新しいCompliance Access Keyを作成してください。削除スコープはread:compliance_user_dataとは別になっており、読み取り専用の監査キーがコンテンツを削除できないようになっています。
エンドポイントは解決されましたが、リソースIDが存在しないか、すでに削除されています。Compliance APIの削除は即時かつ永続的であるため、以前に既知だったIDに対する404は、通常、コンテンツがCompliance APIの削除呼び出しによってハード削除されたか、保持ポリシーによって削除されたことを意味します。1つの例外は、pendingステータスのままのリモートセッションで、そのメッセージエンドポイントはセッションが開始されるまで一時的に404を返します。リモートセッションが見つからないを参照してください。各修正方法で引用されているアクティビティタイプ文字列(例:claude_chat_created)は、Activity Feedのactivity_types[]フィルターに渡すことができる値です。サポートされているすべての値については、コンプライアンスアクティビティのクエリを参照してください。
ローカルセッションにはpending状態がないため、Local session not found.の404は一時的なものではありません。その原因と、セッションIDに依存せず一時的である可能性がある別のレスポンスLocal sessions are not available.については、ローカルセッションが見つからないを参照してください。
Type: not_found_error
Chat claude_chat_01H5CWunD7RpVJ5bHa8RCkja not found.原因: パス内のチャットIDが、Compliance APIを通じて読み取り可能なチャットと一致しません。チャットは、以前のCompliance API呼び出しによってハード削除されたか、組織の保持ポリシーによって削除された可能性があります。または、呼び出し元のキーが読み取れない組織に属している可能性があります。ユーザーがclaude.aiでソフト削除したチャットは404を返しません。deleted_atが設定された状態で読み取り可能なままです。
修正方法: 最近のclaude_chat_createdまたはclaude_chat_viewedアクティビティとチャットIDを照合してください。アクティビティが最近のもので、読み取りがまだ失敗する場合、チャットはハード削除された(このAPIを通じて、または保持ポリシーの期限切れによって)か、キーのスコープ外の組織に属しています。
Type: not_found_error
No file found with provided id, or it has already been deleted.原因: ファイルIDが存在しないか、削除されています。このエラーは、チャットに添付されたファイル(claude_file_...)とプロジェクトファイルの両方に適用されます。
修正方法: 最近のclaude_file_uploadedまたはclaude_file_deletedアクティビティと照合してください。ファイルが削除された場合、バイナリは消えています。アクティビティレコードは6年間の保持期間中、フィードに残ります。
Type: not_found_error
No project is found with the provided id.原因: プロジェクトIDが存在しないか、削除されています。
修正方法: 最近のclaude_project_createdまたはclaude_project_deletedアクティビティと照合してください。Activity Feedは、プロジェクト自体が消えた後も、プロジェクトのライフサイクルイベントを公開し続けます。
Type: not_found_error
No project document found with provided id, or it has already been deleted.原因: プロジェクトドキュメントIDが存在しないか、削除されています。このエラーは、テキストプロジェクトドキュメント(claude_proj_doc_...)に適用され、プロジェクトファイルには適用されません。
修正方法: GET /v1/compliance/apps/projects/{project_id}/attachmentsを使用して現在の添付ファイルを一覧表示してください。ドキュメントが見つからない場合、削除されています。メタデータのみが必要な場合は、claude_project_document_uploadedアクティビティレコードを通じて取得してください。
Type: not_found_error
Remote session not found.原因: GET /v1/compliance/apps/sessions/remote/{session_id}/messagesに渡されたセッションIDが、Compliance APIを通じて読み取り可能なセッショントランスクリプトと一致しません。これは、セッションID(cse_...)が存在しないかセッションが削除された場合、セッションがキーで読み取れない組織に属している場合、またはセッションのstatusがまだpendingの場合に発生します。保留中のセッションにはまだトランスクリプトがないため、メッセージエンドポイントはセッションが開始されるまで404を返します。正しい形式のcse_識別子でないセッションIDは、代わりに400 Bad Requestを返します。
修正方法: GET /v1/compliance/apps/sessions/remoteでセッションIDとそのstatusを確認してください。リモートセッションの取得を参照してください。セッションがpendingの場合、そのステータスを抜けた後に再試行してください。セッションがリストに表示されなくなった場合、削除されており、トランスクリプトは取得できません。
Type: not_found_error
Local session not found.原因: GET /v1/compliance/apps/sessions/local/{session_id}またはGET /v1/compliance/apps/sessions/local/{session_id}/messagesに渡されたセッションIDが、Compliance APIを通じて読み取り可能なローカルセッションと一致しません。両方のエンドポイントは、原因を区別せずにこの1つのメッセージを返します。これは、IDがキーで読み取れる組織のセッションでない場合(別の親組織に属するIDを含む)、セッションが存在しなかった場合、セッションにゼロデータ保持が適用されている場合、またはセッションのすべてのアクティビティが、それを実行した組織に適用される保持期間を過ぎた場合に発生します。リモートセッションとは異なり、ローカルセッションにはpending状態がないため、Local session not found.レスポンスに一時的な形式はありません。正しい形式のclls_識別子でないセッションIDは、代わりに400 Bad Requestを返します。
ローカルセッションエンドポイント(リストエンドポイントを含む)は、エンドポイント自体が親組織で利用できない間、別の404メッセージLocal sessions are not available.を返します。そのレスポンスはセッションIDに依存しません。顧客側のキー、スコープ、設定では変更できず、一時的である可能性があります。両方のレスポンスはnot_found_errorタイプを持つため、メッセージテキストがそれらを区別するものです。
修正方法: GET /v1/compliance/apps/sessions/localでセッションIDを確認してください。ローカルセッションの取得を参照してください。セッションがリストに表示されなくなった場合、そのコンテンツは保持期間を過ぎている(またはセッションがキーで読み取れる組織にもはや存在しない)ため、トランスクリプトは取得できません。IDをキューから削除してください。リストを含むすべての呼び出しがLocal sessions are not available.を返す場合、キューに入れたセッションIDを保持し、次のスケジュールされた実行で再試行してください。レスポンスが継続する場合は、Anthropicの担当者に連絡し、request-idレスポンスヘッダーを含めてください。
Type: not_found_error
The "ce86b5f3-7c16-48b3-a9f3-e1d2c4b8a0f1" organization does not exist or the requester is not authorized to access it.組織、ロール、グループの各エンドポイントは、標準のエラー形式で404 not_found_errorを返します。組織メッセージはorg_uuidを示します。ロールとグループのメッセージは汎用的です(Role not found.、Group not found.)。これは、パスID(org_uuid、role_id、またはgroup_id)が存在しないか、呼び出し元のキーが読み取れるツリーにもはや属していない場合に発生します。
原因: パス内のIDが、Compliance APIを通じて読み取り可能なレコードと一致しません。ロールとグループは削除される可能性があり、組織は親ツリーからリンク解除される可能性があります。
修正方法: 対応するリストエンドポイントでIDを確認し、Activity Feedの最近の組織、ロール、またはグループのアクティビティと照合してください。
Type: not_found_error
organization `91012d09-e48b-438e-a489-1bebfd8fa6f9` not found in this organization's hierarchy原因: GET /v1/compliance/organizations/{organization_id}/settingsは、組織が存在するかどうかをレスポンスが明らかにしないように意図的に同じボディを共有する3つのケースでこの404を返します。organization_idが親のリンクされた組織の1つでない場合、値が有効なUUIDでない場合、または設定エンドポイントが親組織でまだ有効になっていない場合です。
修正方法: 組織の一覧表示でIDを確認してください。既知の正しい組織IDでも404が返される場合、設定エンドポイントは親組織でまだ有効になっていません。Anthropicの担当者にお問い合わせください。
リクエストは正しい形式で認可されていますが、リソースの現在の状態と競合しています。
Type: conflict_error
The "claude_proj_01KGp4eZNug9ri4kE35RSppq" project cannot be deleted as it has chats attached to it. Delete or detach all chats, and try deleting the project again.原因: まだチャットが添付されているプロジェクトに対してDELETE /v1/compliance/apps/projects/{project_id}が呼び出されました。
修正方法: GET /v1/compliance/apps/chats?user_ids[]={user_id}&project_ids[]={project_id}でプロジェクトのチャットを一覧表示し(project_ids[]フィルターには少なくとも1つのuser_ids[]値が必要です。組織ユーザーの一覧表示でIDを列挙してください)、DELETE /v1/compliance/apps/chats/{claude_chat_id}で各チャットを削除してから、プロジェクトの削除を再試行してください。
Compliance APIへのリクエストは、親組織ごとに1分あたり600リクエストに制限されています。この制限は、親の下のすべてのキー(Compliance Access Keyおよびリンクされたすべての組織のAdmin APIキー)と、すべての/v1/compliance/*エンドポイントで共有される1つのバジェットです。リモートセッションエンドポイントには、これに加えて2つ目のリクエストバジェットがあります。親組織を持たないスタンドアロンのClaude Console組織の場合、同じバジェットが組織自体に適用され、そのAdmin APIキー間で共有されます。統合により高い制限が必要な場合は、Anthropicの担当者にお問い合わせください。
APIキーが認証されると、Compliance APIレスポンスは標準のレート制限レスポンスヘッダーを通じて共有バジェットを報告するため、クライアントは429を待つのではなく、事前にスロットリングできます。
anthropic-ratelimit-requests-limitは、1分あたりのリクエストバジェットです。anthropic-ratelimit-requests-remainingは、現在のウィンドウで残っているバジェットです。anthropic-ratelimit-requests-resetは、ウィンドウがリセットされ、完全なバジェットが復元されるRFC 3339タイムスタンプです。429レスポンスには、次のリクエストを送信する前に待機する秒数を示すretry-afterヘッダーも含まれます。この値には、anthropic-ratelimit-requests-resetを超える小さな安全マージンが含まれる場合があります。retry-afterに従ってください。
HTTP/1.1 429 Too Many Requests
date: Tue, 21 Apr 2026 14:38:02 GMT
retry-after: 25
anthropic-ratelimit-requests-limit: 600
anthropic-ratelimit-requests-remaining: 0
anthropic-ratelimit-requests-reset: 2026-04-21T14:38:25Z{
"error": {
"type": "rate_limit_error",
"message": "Compliance API rate limit of 600 requests per minute per parent organization has been exceeded. Retry after the time indicated by the retry-after header. Quote the request-id response header when contacting Anthropic support."
}
}原因: 親組織(またはスタンドアロンのClaude Console組織)が、バジェットを共有するすべてのキーにわたって、1分間のウィンドウで/v1/compliance/*に600を超えるリクエストを送信したか、リモートセッションエンドポイントの2つ目のリクエストバジェット(このセクションの後半で説明)を使い果たしました。
修正方法: retry-afterヘッダーの秒数だけ待機してから再試行してください。ヘッダーがない場合(例えば、中間装置によって削除された場合)、指数バックオフにフォールバックしてください(1秒から開始し、60秒まで倍増)。429でページネーションカーソルを進めないでください。失敗したリクエストはデータを返さなかったため、最後に成功したページのカーソルがまだ正しいです。
認証に失敗したリクエスト(キーが欠落しているか認識されない、またはCompliance Access KeyやAdmin APIキーではなくClaude APIキー)は、レートリミッターの前に拒否され、クォータを消費しません。エンドポイントの必要なスコープを持たない有効なキーは、403が返される前に1クォータユニットを消費します。
リモートセッションエンドポイントは、共有制限に加えて、親組織にキー付けされた2つ目のリクエストバジェットを持ちます。そのバジェットからの429は、常に1のretry-afterヘッダーを持ちます(実際のリセット時間ではなく最小待機時間)。そのレスポンスのanthropic-ratelimit-*ヘッダーは、このバジェットではなく共有制限を示すため、429が繰り返される場合は指数的にバックオフしてください。ローカルセッションエンドポイントには2つ目のバジェットがなく、共有制限に対してのみカウントされます。
スケジュールに従ってActivity Feedをポーリングする場合、集約リクエストレート(すべてのキー、リンクされた組織、同時ワーカーにわたって)を共有制限未満に予算設定してください。anthropic-ratelimit-requests-remainingを監視して、制限に達する前に速度を落としてください。ウィンドウポーリングとカーソル駆動の取り込みの選択については、コンプライアンス統合の設計を参照してください。
Compliance APIからの500は、失敗が決定論的である場合、x-should-retry: falseレスポンスヘッダーを持ちます。Anthropic SDKはこのヘッダーを自動的に尊重します。すべての5xxで再試行する汎用HTTP再試行ライブラリを使用する場合、x-should-retryがfalseのときは再試行を抑制してください。このエラーを再試行しても、すべての試行で同じように失敗します。
x-should-retry: falseヘッダーのない500は一時的です。指数バックオフで再試行してください(1秒から開始し、60秒まで倍増)。502、503、504、529レスポンスにも同じことが適用されます。次に説明するローカルセッションの503の1つは、一時的ではなくデータ依存です。プラットフォーム全体の再試行セマンティクスについては、エラーを参照してください。
Type: overloaded_error
The local-sessions index is temporarily unavailable. Try again shortly.Captured content is temporarily unavailable. Try again shortly.The local-sessions index cannot currently evaluate retention overrides for this page. Try again later.原因: ローカルセッションエンドポイントは、これらのボディのいずれかで503を返します。最初の2つは、セッションリスト、またはセッションのキャプチャされたコンテンツが一時的に利用できないことを意味します。これは負荷またはバックエンドに関連する一時的な状態です。3つ目のボディ(取得およびメッセージエンドポイントではfor this pageではなくfor this sessionと表示されます)は、リクエストされた範囲内の1つ以上のセッションに適用される保持またはデータ処理設定がまだ評価できなかったことを意味します。これは負荷ではなく、セッションを実行した組織のデータと設定に依存し、長期間継続する可能性があります。3つのボディはすべてoverloaded_errorタイプを共有するため、これは、error.typeではなくメッセージテキストが、異なる処理を必要とする状態を区別する、このページの数少ないケースの1つです。
修正方法: 2つのTry again shortly.ボディの場合、指数バックオフで再試行し、pageカーソルを進めないでください。失敗したリクエストはデータを返さなかったためです。Try again later.ボディの場合、クリアされるのを待ってウォークを保持したままにしないでください。リストエンドポイントでは、pageパラメータなしで再開して後で再試行するか(24時間より古いリストページトークンは引き続き受け入れられますが、現在の保持境界に対して再評価されるため、保留されたウォークはセッションをスキップする可能性があります)、リクエストが成功するまでcreated_at.gteとcreated_at.ltのウィンドウを狭め、スキップされた範囲を後の実行で別途エクスポートしてください。取得およびメッセージエンドポイントでは、そのセッションIDをスキップし、残りのエクスポートを続行し、後の実行でセッションを再試行してください。メッセージページカーソルはウォークの最初のページから24時間後に期限切れになるため、戻ったときはpageなしでそのセッションのウォークを再開してください。状態が実行をまたいで再発する場合は、Anthropicの担当者に連絡し、request-idレスポンスヘッダーを含めてください。
サービス全体のインシデントについては、status.anthropic.comを確認してください。
アクセス、スコープ、保持、統合に関するよくある質問。
プラットフォーム全体のエラーカタログと再試行セマンティクス。
Was this page helpful?