Read one page of immutable Play Run row history
curl --request GET \
--url https://code.deepline.com/api/v2/plays/{name}/sheet/history \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://code.deepline.com/api/v2/plays/{name}/sheet/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://code.deepline.com/api/v2/plays/{name}/sheet/history"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"entries": [
{
"runId": "<string>",
"datasetId": "<string>",
"rowKey": "<string>",
"phase": "admitted",
"generation": "<string>",
"attemptSeq": 123,
"rowVersion": 123,
"inputIndex": 123,
"inputDigest": "<string>",
"status": "pending",
"data": {},
"source": {},
"recordedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>",
"coverage": {
"complete": true,
"expectedRows": 123,
"captureStartedAt": "2023-11-07T05:31:56Z",
"captureCompletedAt": "2023-11-07T05:31:56Z",
"reason": "storage_not_expanded"
}
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}Plays and runs
Read one page of immutable Play Run row history
Reads retained admitted and terminal row generations for a dataset owned by the requested Play Run in the authenticated workspace. Pass nextCursor as cursor to continue. Coverage explicitly reports legacy, unavailable, or in-progress capture; mutable sheet rows are never presented as historical snapshots.
GET
/
api
/
v2
/
plays
/
{name}
/
sheet
/
history
Read one page of immutable Play Run row history
curl --request GET \
--url https://code.deepline.com/api/v2/plays/{name}/sheet/history \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://code.deepline.com/api/v2/plays/{name}/sheet/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://code.deepline.com/api/v2/plays/{name}/sheet/history"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"entries": [
{
"runId": "<string>",
"datasetId": "<string>",
"rowKey": "<string>",
"phase": "admitted",
"generation": "<string>",
"attemptSeq": 123,
"rowVersion": 123,
"inputIndex": 123,
"inputDigest": "<string>",
"status": "pending",
"data": {},
"source": {},
"recordedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>",
"coverage": {
"complete": true,
"expectedRows": 123,
"captureStartedAt": "2023-11-07T05:31:56Z",
"captureCompletedAt": "2023-11-07T05:31:56Z",
"reason": "storage_not_expanded"
}
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"error": "Unauthorized"
}{
"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 |
|---|---|
| 400 | The request conflicts with current state or a retained request identity. |
| 401 | The request conflicts with current state or a retained request identity. |
| 403 | 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. |
| 503 | A required service is unavailable. Respect Retry-After when present. |
Authorizations
Create a workspace API key in the Deepline dashboard before calling authenticated endpoints.
Path Parameters
The name returned by the related Deepline API call.
Minimum string length:
1Query Parameters
Required Play Run identity owning the dataset.
Minimum string length:
1Required dataset table namespace within the Play Run.
Minimum string length:
1Page size from 1 through 1000; defaults to 200.
Required range:
1 <= x <= 1000Opaque nextCursor from the preceding history page.