Sign in

v1

latestOpenAPI 3.1.02026-07-13231960.5 KB
Sessions

Retrieve details about an existing session

Get information about the session's current status, timestamps, snapshot/playbook references, and any structured output.

get/v1/sessions/{session_id}

Path parameters

session_idstring required

The session ID

Response

Returns session details

session_idstring required

Unique identifier for the session

statusstring required

Current status of the session

titlestring nullable

Session title

created_atstring date-time

Creation timestamp (ISO 8601)

updated_atstring date-time

Last update timestamp (ISO 8601)

snapshot_idstring nullable

ID of the machine snapshot used

playbook_idstring nullable

ID of the playbook used

tagsstring[] nullable

List of tags associated with the session

pull_requestobject nullable

Pull request information (null if no PR is associated) containing url field

structured_outputobject nullable

Task-specific structured output

status_enum'working' | 'blocked' | 'expired' | 'finished' | 'suspend_requested' | 'suspend_requested_frontend' | 'resume_requested' | 'resume_requested_frontend' | 'resumed' nullable

Session status enumerations:

  • "working": Devin is actively working on a task
  • "blocked": Devin is waiting for user input or response
  • "expired": Session has expired
  • "finished": Session has completed
  • "suspend_requested": Request to suspend the session
  • "suspend_requested_frontend": Frontend-initiated suspend request
  • "resume_requested": Request to resume the session
  • "resume_requested_frontend": Frontend-initiated resume request
  • "resumed": Session has been resumed