agentRunnerSession

List an agent run's sessions

get/agent_runners/{agent_runner_id}/sessions

Request

  • Base URL
    https://api.netlify.com/api/v1
  • URL
    https://api.netlify.com/api/v1/agent_runners/{agent_runner_id}/sessions
  • Auth
    OAuth 2
    Implicit: https://app.netlify.com/authorize

Query parameters

pageinteger
per_pageinteger
statestring

Only sessions in this state: new, running, await_input, interrupted, error, done or cancelled.

frominteger

Unix timestamp. Only sessions created at or after this time.

tointeger

Unix timestamp. Only sessions created before this time.

order_by'asc' | 'desc'

Response

OK

idstring
agent_runner_idstring
dev_server_idstring
statestring

One of new, running, await_input, interrupted, error, done or cancelled.

created_atstring dateTime
updated_atstring dateTime
done_atstring dateTime
paused_atstring dateTime

When the session paused waiting on an interaction. Null once it resumes.

titlestring
promptstring
resultstring

The agent's summary of what it did.

result_diffstring
commit_shastring
deploy_idstring
deploy_urlstring

URL of the session's deploy preview.

durationinteger
interactionsobject

Questions and requests from the agent, keyed by reference ID. A pending one pauses the session in await_input until it's answered or skipped.

attached_file_keysstring[]
result_zip_file_namestring
is_publishedboolean

Changes

No recorded changes to this operation across all 65 revisions of this API.