Creative Jobs

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

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

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": {}      }    ]  }}

Authorizations

Satisfy one of these options:

  • bearerAuth
  • x-api-key

Authentication details

bearer
Authorization

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

Path Parameters

idstringpathrequired

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

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

Query Parameters

limitintegerquery

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

Value range
≥ 1, ≤ 100

Response

application/json

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

Headers

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": {}      }    ]  }}
dataobjectrequired

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

data.request_idstringrequired

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

data.job_idstringrequired

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

data.eventsJobEvent[]required

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

data.events[]JobEvent
data.events[].idstringrequired

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

data.events[].typestringenum<string>required

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

Allowed
job.createdjob.queuedjob.startedgeneration.submittedgeneration.status_errorjob.completedjob.failedjob.canceledwebhook.delivery
data.events[].sourcestringenum<string>required

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

Allowed
orchestorwebhook
data.events[].statusstringenum<string>required

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

Allowed
infopendingprocessingsucceededfailedcanceledretrying
data.events[].messagestringrequired

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

data.events[].created_atstringrequiredformat:date-time

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

data.events[].dataobjectrequired

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