ジョブ

ジョブのイベントを一覧表示

ジョブのイベントを一覧表示。

GET
/v1/creative/jobs/{id}/events
Alpha
curl --request GET 'https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/events' \  --header "Authorization: Bearer $ORCHESTOR_API_KEY"
{  "data": {    "request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",    "job_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",    "events": [      {        "id": "evt_6f1d0c2b",        "type": "job.queued",        "source": "orchestor",        "status": "pending",        "message": "生成の受付が完了しました。",        "created_at": "2026-11-06T00:00:00Z",        "data": {}      }    ]  }}

認証

次のいずれかの条件を満たしてください。

  • bearerAuth
  • x-api-key

認証の詳細

bearer
Authorization

外部 API キー。session は受け付けません。apiKey と同時に送ると 401 です。

パスパラメータ

idstringpath必須

操作対象のリソース ID。同じワークスペースに属するものを指定します。

例"job_7513b52d-3669-4ffe-b317-8b02000715eb"

クエリパラメータ

limitintegerquery

1 ページで取得する件数。上限と既定値はスキーマを参照してください。

値の範囲
≥ 1, ≤ 100

レスポンス

application/json

ジョブの受付、生成、終端、Webhook 配信の履歴を時系列で返します。

ヘッダー

x-orchestor-request-idstringheader

HTTP リクエストの相関 ID。ジョブの request_id とは別の値。

ratelimit-limitintegerheader

現在の期間で許可されるリクエスト数。

ratelimit-remainingintegerheader

現在の期間で残っているリクエスト数。

ratelimit-resetintegerheader

制限がリセットされるまでの秒数。

retry-afterintegerheader

再試行までの待機秒数。

{  "data": {    "request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",    "job_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",    "events": [      {        "id": "evt_6f1d0c2b",        "type": "job.queued",        "source": "orchestor",        "status": "pending",        "message": "生成の受付が完了しました。",        "created_at": "2026-11-06T00:00:00Z",        "data": {}      }    ]  }}
dataobject必須

この操作が返す結果。形状は以下の子フィールドを参照してください。

data.request_idstring必須

この生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。

data.job_idstring必須

状態・結果・イベントを取得する生成ジョブの ID。

data.eventsJobEvent[]必須

ジョブの状態遷移や配信試行を時系列で並べた記録。

data.events[]JobEvent
data.events[].idstring必須

取得・更新時に指定する、このリソースの一意な識別子。

data.events[].typestringenum<string>必須

対象の種類。ジョブでは生成種別、成果物ではメディア種別を示します。

許可される値
job.createdjob.queuedjob.startedgeneration.submittedgeneration.status_errorjob.completedjob.failedjob.canceledwebhook.delivery
data.events[].sourcestringenum<string>必須

イベントの発生元。orchestor はジョブ処理、webhook は通知の配信です。

許可される値
orchestorwebhook
data.events[].statusstringenum<string>必須

対象リソースの現在の処理状態。

許可される値
infopendingprocessingsucceededfailedcanceledretrying
data.events[].messagestring必須

利用者に表示できる処理結果または失敗理由の説明。

data.events[].created_atstring必須形式:date-time

このリソースを作成した日時。ISO 8601 形式。

data.events[].dataobject必須

この操作が返す結果。形状は以下の子フィールドを参照してください。