Extend Task Life

Overview

Extend the maximum lifetime of an existing task when a game runs longer than expected. This updates the task’s max_life_hours value. The worker reads the updated value while the task is running, so the task can continue past the original lifetime without needing to create a new task or change the SRT URL. Use this endpoint before the task reaches its current maximum lifetime.

Path Parameters

Parameter	Type	Required	Description
`task_id`	string	Yes	The ID of the task to extend

Request Body Parameters

Parameter	Type	Required	Description
`max_life_hours`	number	Yes	New maximum task lifetime in hours. Must be greater than `0` and no more than `48`.

Example Request

curl -X POST "https://api.narrative-sports.com/v1/tasks/YOUR_TASK_ID/extend-life" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "max_life_hours": 12
  }'

Example Response

{
  "success": "success",
  "task_id": "YOUR_TASK_ID",
  "status": "Task life extended",
  "max_life_hours": 12.0,
  "previous_max_life_hours": 6.0
}

Response Fields

Field	Type	Description
`success`	string	Result status: `success` or `failure`
`task_id`	string	The task ID that was updated
`status`	string	Human-readable status message
`max_life_hours`	number \| null	Updated maximum lifetime in hours
`previous_max_life_hours`	number \| null	Previous maximum lifetime in hours

Error Responses

Task not found or not owned by caller

{
  "detail": "Task not found"
}

Invalid lifetime

{
  "detail": [
    {
      "type": "less_than_equal",
      "loc": ["body", "max_life_hours"],
      "msg": "Input should be less than or equal to 48"
    }
  ]
}

Notes

The limit is based on hours since task creation, not hours from the time you call this endpoint.
max_life_hours can be increased up to 48.
Use Get Task Info or List Tasks to confirm the updated task_payload.max_life_hours and time_remaining_hours.
Use Kill Task when the game is finished and the task should stop immediately.

Overview

Task Creation

Task Management

License Usage

Deprecated

Highlights

Highlight Packages (Early Beta)

Recaps

Overview

Path Parameters

Request Body Parameters

Example Request

Example Response

Response Fields

Error Responses

Task not found or not owned by caller

Invalid lifetime

Notes

​Overview

​Path Parameters

​Request Body Parameters

​Example Request

​Example Response

​Response Fields

​Error Responses

​Task not found or not owned by caller

​Invalid lifetime

​Notes

Overview

Path Parameters

Request Body Parameters

Example Request

Example Response

Response Fields

Error Responses

Task not found or not owned by caller

Invalid lifetime

Notes