---
search:
  tags:
    - 撮影
    - POST
seo:
  description: >-
    撮影ジョブを 1 回実行します。エッジPC が依頼を受け付けて保存した時点で… Reference for the POST
    /capture/jobs/{id}/run endpoint in the ThingsConnect REST API.
sidebar:
  label: 撮影ジョブを実行する
  badge: POST
title: 撮影ジョブを実行する
type: openapi-operation
---
撮影ジョブを 1 回実行します。エッジPC が依頼を受け付けて保存した時点で `202` を返すので、撮影と送信の結果は[実行結果](/docs/api/撮影/get-capture-run)で確かめてください。撮影の前にエッジPC が再起動しても、起動後に撮影します（依頼から 10 分を過ぎても撮り始められなかったものは撮らずに失敗にします）。

`payload` に入れた値は外部送信先へ写真と一緒に送られます（JSON で 4096 バイトまで）。API からの実行を許可していないジョブは `403`、無効にしたジョブは `409`、エッジPC に届かなかった場合は `502` を返します。スコープは `capture` が要ります。

`POST /capture/jobs/{id}/run`