Get one Play run status
curl --request GET \
--url https://code.deepline.com/api/v2/runs/{runId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://code.deepline.com/api/v2/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://code.deepline.com/api/v2/runs/{runId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"schemaVersion": 1,
"kind": "play_run",
"run": {
"id": "play/prebuilt/person-linkedin-to-email/run/example",
"playName": "person-linkedin-to-email",
"status": "running"
},
"steps": [],
"outputs": {},
"resultState": "not_returned",
"datasets": [],
"next": {
"inspect": {
"kind": "deepline_run_inspect",
"runId": "play/prebuilt/person-linkedin-to-email/run/example",
"command": "deepline runs get play/prebuilt/person-linkedin-to-email/run/example",
"api": {
"method": "GET",
"path": "/api/v2/runs/play%2Fprebuilt%2Fperson-linkedin-to-email%2Frun%2Fexample"
}
},
"billing": {
"kind": "deepline_run_billing",
"runId": "play/prebuilt/person-linkedin-to-email/run/example",
"command": "deepline billing usage --run-id play/prebuilt/person-linkedin-to-email/run/example",
"api": {
"method": "GET",
"path": "/api/v2/runs/play%2Fprebuilt%2Fperson-linkedin-to-email%2Frun%2Fexample?full=true"
}
},
"logs": {
"kind": "deepline_run_logs",
"runId": "play/prebuilt/person-linkedin-to-email/run/example",
"view": "tail",
"limit": 100,
"command": "deepline runs logs play/prebuilt/person-linkedin-to-email/run/example --limit 100",
"api": {
"method": "GET",
"path": "/api/v2/runs/play%2Fprebuilt%2Fperson-linkedin-to-email%2Frun%2Fexample/logs?limit=100"
}
}
}
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}Plays and runs
Get one Play run status
Returns the canonical status and completed output for one Play run. The additive watchSnapshot=true query returns the bounded no-store snapshot polled by SDK watch.
GET
/
api
/
v2
/
runs
/
{runId}
Get one Play run status
curl --request GET \
--url https://code.deepline.com/api/v2/runs/{runId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://code.deepline.com/api/v2/runs/{runId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://code.deepline.com/api/v2/runs/{runId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"schemaVersion": 1,
"kind": "play_run",
"run": {
"id": "play/prebuilt/person-linkedin-to-email/run/example",
"playName": "person-linkedin-to-email",
"status": "running"
},
"steps": [],
"outputs": {},
"resultState": "not_returned",
"datasets": [],
"next": {
"inspect": {
"kind": "deepline_run_inspect",
"runId": "play/prebuilt/person-linkedin-to-email/run/example",
"command": "deepline runs get play/prebuilt/person-linkedin-to-email/run/example",
"api": {
"method": "GET",
"path": "/api/v2/runs/play%2Fprebuilt%2Fperson-linkedin-to-email%2Frun%2Fexample"
}
},
"billing": {
"kind": "deepline_run_billing",
"runId": "play/prebuilt/person-linkedin-to-email/run/example",
"command": "deepline billing usage --run-id play/prebuilt/person-linkedin-to-email/run/example",
"api": {
"method": "GET",
"path": "/api/v2/runs/play%2Fprebuilt%2Fperson-linkedin-to-email%2Frun%2Fexample?full=true"
}
},
"logs": {
"kind": "deepline_run_logs",
"runId": "play/prebuilt/person-linkedin-to-email/run/example",
"view": "tail",
"limit": 100,
"command": "deepline runs logs play/prebuilt/person-linkedin-to-email/run/example --limit 100",
"api": {
"method": "GET",
"path": "/api/v2/runs/play%2Fprebuilt%2Fperson-linkedin-to-email%2Frun%2Fexample/logs?limit=100"
}
}
}
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}Authentication: workspace API key in
Authorization: Bearer <key>.
URL-encode path values, including / characters inside Play references and run IDs.
Errors
| Status | Meaning |
|---|---|
| 401 | The request conflicts with current state or a retained request identity. |
| 404 | The request conflicts with current state or a retained request identity. |
| 500 | The request conflicts with current state or a retained request identity. |
Authorizations
Create a workspace API key in the Deepline dashboard before calling authenticated endpoints.
Path Parameters
The runId returned by the related Deepline API call.
Minimum string length:
1Query Parameters
true selects the legacy detail wrapper: status and result are top-level, and the compact package is nested under package.
Optional comma-separated expansions: nodeStates, runInsights, configuration.
false omits billing enrichment from full or runInsights reads.
true returns the bounded status snapshot used by SDK watch.