List pending session work

List durable admitted session work not yet visible in projected history, ordered by admission. Includes unpromoted user and synthetic inputs and unhandled compaction barriers. The runner owns consumption; items disappear once promoted or handled.

GET/api/session/{sessionID}/pending

Path parameters

sessionIDobjectrequired

Responses

200Success

dataSessionPending.Info[]required

Show properties

Array of SessionPending.Info

Any of:

SessionPending.User

admittedSeqobjectrequired

Show properties

object

idobjectrequired

Show properties

object

sessionIDobjectrequired

Show properties

object

timeCreatednumberrequired

typestringrequired

Allowed:user

dataSessionPending.UserDatarequired

Show properties

textstringrequired

filesPrompt.FileAttachment[]

Show properties

Array of Prompt.FileAttachment

dataPrompt.Base64required

Show properties

object

mimestringrequired

sourcePrompt.FileSourcerequired

Show properties

Any of:

object

typestringrequired

Allowed:inline

object

typestringrequired

Allowed:uri

uristringrequired

namestring

descriptionstring

mentionPrompt.Mention

Show properties

startnumberrequired

endnumberrequired

textstringrequired

agentsPrompt.AgentAttachment[]

Show properties

Array of Prompt.AgentAttachment

namestringrequired

mentionPrompt.Mention

Show properties

startnumberrequired

endnumberrequired

textstringrequired

metadataobject

deliverystringrequired

Allowed:steerqueue

SessionPending.Synthetic

admittedSeqobjectrequired

Show properties

object

idobjectrequired

Show properties

object

sessionIDobjectrequired

Show properties

object

timeCreatednumberrequired

typestringrequired

Allowed:synthetic

dataSessionPending.SyntheticDatarequired

Show properties

textstringrequired

descriptionstring

metadataobject

deliverystringrequired

Allowed:steerqueue

SessionPending.Compaction

admittedSeqobjectrequired

Show properties

object

idobjectrequired

Show properties

object

sessionIDobjectrequired

Show properties

object

timeCreatednumberrequired

typestringrequired

Allowed:compaction

400InvalidRequestError

_tagstringrequired

Allowed:InvalidRequestError

messagestringrequired

kindstring | any

Show properties

Any of:

string

string

any

any

fieldstring | any

Show properties

Any of:

string

string

any

any

401UnauthorizedError

_tagstringrequired

Allowed:UnauthorizedError

messagestringrequired

404SessionNotFoundError

Any of:

SessionNotFoundError

_tagstringrequired

Allowed:SessionNotFoundError

sessionIDstringrequired

messagestringrequired

SessionNotFoundError

_tagstringrequired

Allowed:SessionNotFoundError

sessionIDstringrequired

messagestringrequired

Request

curl -X GET "/api/session/%5Bobject%20Object%5D/pending"

const response = await fetch("/api/session/%5Bobject%20Object%5D/pending", {
  method: "GET"
});

import requests

response = requests.get(
    "/api/session/%5Bobject%20Object%5D/pending",
)

Response

{
  "data": [
    {
      "admittedSeq": {},
      "id": {},
      "sessionID": {},
      "timeCreated": 0,
      "type": "user",
      "data": {
        "text": "string",
        "files": [
          {
            "data": {},
            "mime": "string",
            "source": {
              "type": "inline"
            },
            "name": "string",
            "description": "string",
            "mention": {
              "start": 0,
              "end": 0,
              "text": "string"
            }
          }
        ],
        "agents": [
          {
            "name": "string",
            "mention": {
              "start": 0,
              "end": 0,
              "text": "string"
            }
          }
        ],
        "metadata": {}
      },
      "delivery": "steer"
    }
  ]
}