Update directive for a running or paused job

curl --request POST \
  --url https://api.example.com/v1/send_interrupt_directive/{job_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "new_directive": "<string>"
}
'

{
  "status": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

Endpoints

Update directive for a running or paused job

Update the directive of a running, paused, or user-controlled browser agent job.

This allows you to change the task directive mid-execution. The agent will:

Update its directive to the new one
Add a note to the story about the directive change
Auto-resume if the job was paused

Requirements:

Job status must be ‘running’, ‘paused’, or ‘user_taken_over’
Only works for simple browser agent jobs (not workflow jobs)

Note: Workflow jobs (created via graph workflows) cannot have their directive interrupted as the directive is managed by the workflow definition.

POST

send_interrupt_directive

{job_id}

Update directive for a running or paused job

curl --request POST \
  --url https://api.example.com/v1/send_interrupt_directive/{job_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "new_directive": "<string>"
}
'

{
  "status": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

Authorizations

Authorization

string

header

required

API key for authentication. Get your API key at https://app.altrina.com/settings

Path Parameters

job_id

string

required

The unique job identifier to update

Body

application/json

Request to update the directive of a running or paused job

new_directive

string

required

The new directive to replace the current one

Response

Directive updated successfully

Generic API response wrapper

status

string

required

Response status - 'success' or 'error'

message

string | null

Human-readable message

data

any

Additional data payload

Resume a paused job Get job files

⌘I

Getting Started

Endpoints

Authorizations

Path Parameters

Body

Response