監査

監査ログの検索と使用量

説明は公開 API の契約（OpenAPI）から生成しています。

エンドポイント

GET	/v1/audit/events
GET	/v1/audit/events/{seq}
GET	/v1/audit/dead-letters
POST	/v1/audit/dead-letters/{id}/retry

searchAudit

GET/v1/audit/events

パラメーター

名前	場所	型	必須	説明
type	query	string		前方一致
actor	query	string
engagement	query	string		運営者の委任を通した操作だけに絞る
scope	query	organization | project		project なら今のプロジェクトだけ
since	query	string
until	query	string
cursor	query	string
limit	query	integer

応答

• 200 — object: 監査の記録（新しい順）
• default — Problem: RFC 9457 Problem Details

getAuditRecord

GET/v1/audit/events/{seq}

パラメーター

名前	場所	型	必須	説明
seq	path	integer	はい

応答

• 200 — object: 記録と、R2 に置いた本体（前の記録のハッシュとつないだもの）
• default — Problem: RFC 9457 Problem Details

listDeadLetters

GET/v1/audit/dead-letters

audit:read が必要。届け直しても処理できなかったイベント（Queues の DLQ から受けたもの）を、受けた新しい順に返す

パラメーター

名前	場所	型	必須	説明
limit	query	integer

応答

• 200 — object: 届けられなかったイベント
• default — Problem: RFC 9457 Problem Details

retryDeadLetter

POST/v1/audit/dead-letters/{id}/retry

audit:dead-letters.retry が必要。イベントをキューに入れ直す。処理する側は event id で重複を捨てるので、2 回入れ直しても同じ結果になる。再送を使い切って失敗で終えた Agent の実行は、入れ直しても動かない

パラメーター

名前	場所	型	必須	説明
id	path	string	はい
Idempotency-Key	header	string		副作用を伴う POST ではサーバーが必須にする。SDK は無ければ自動で付けるので、型では省略できる

応答

• 200 — DeadLetter: 入れ直したイベント
• default — Problem: RFC 9457 Problem Details