AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.
Conductor Get Session
Reads a Conductor agent session: details, whether the agent is idle, working or errored, and recent transcript messages. Requires your own Conductor API key, created at app.conductor.build/users/api-keys and added through AutoGPT’s credentials UI. Select that credential for each Conductor block; no server-wide default key is used.
Conductor Get Session
What it is
Get a Conductor agent session: its details, whether the agent is idle, working or errored, and recent transcript messages.
How it works
The block calls GET /v0/sessions/{id} and GET /v0/sessions/{id}/status, then reads the transcript through GET /v0/sessions/{id}/messages. The API only pages from the start in ascending order (100 rows per request at most), so by default the block locates the end of the transcript with cheap one-row probes and returns the newest message_limit messages; with after it instead reads the next message_limit messages following that message, which is how to poll incrementally (next_after is the row ID to pass on the next call). after takes a transcript row ID, such as next_after from Send Message, Create Session, Create Workspace or a previous Get Session call; the prompt ID those blocks return as message_id / initial_message_id is a different namespace that the API rejects with 404, so when it is passed the block locates the prompt's row itself (newest 300 rows, then up to 1000 older ones) and pages from there, reporting that row ID through next_after when nothing follows it yet. has_more reports whether older (default) or newer (after) messages exist beyond the slice; set message_limit to 0 to skip the transcript. latest_reply is the newest message with visible agent text, so trailing tool, lifecycle or status events do not hide the answer. The raw rows are only returned, in messages, when include_messages is on; by default message_count reports how many were read. Live rows are userMessage prompts and agent events wrapping the harness's raw payload; only Claude assistant text parts and completed Codex agentMessage items count as visible text. Pass message_id to also fetch one message via GET /v0/messages/{id} (a transcript row ID, not a send receipt).
Inputs
| Input | Description | Type | Required |
|---|---|---|---|
| session_id | Session ID | str | Yes |
| message_limit | How many transcript messages to return: the most recent ones, or the ones following after when it is set; 0 skips the transcript |
int | No |
| after | Read forward from this message (exclusive) instead of returning the most recent messages. Accepts a transcript row ID (next_after from a previous call or from Send Message / Create Session) or the prompt ID those blocks return as message_id / initial_message_id, which is resolved to the prompt's row | str | No |
| message_id | Also fetch this single message by its transcript row ID (not a prompt ID returned by Send Message) | str | No |
| include_messages | Also return the raw transcript rows in messages. Off by default: status, latest_reply and next_after cover a poll loop without the rows, which can be hundreds of kilobytes | bool | No |
Outputs
| Output | Description | Type |
|---|---|---|
| error | Error message if the operation failed | str |
| session | Session: id, name, model, resolvedModel, effort, fastMode, deepLink, archivedAt | Dict[str, Any] |
| status | idle, working or error | str |
| error_message | Last session error, if any | str |
| message_count | Number of transcript messages in the read slice | int |
| messages | Transcript messages, oldest first: id, sessionIndex, type, content, receivedAt; only emitted when include_messages is on | List[Dict[str, Any]] |
| latest_reply | Text of the newest agent message with visible text in the read transcript slice | str |
| has_more | True when the transcript has messages beyond the read slice: older ones by default, newer ones when after is set | bool |
| next_after | Transcript row ID of the last returned message (or the row after resolved to when nothing followed it); pass it as after to read what follows |
str |
| message | The single message requested by message_id | Dict[str, Any] |
| deep_link | Link that opens the session | str |
Possible use case
Poll a long task: Check status on a schedule and read latest_reply once it turns idle.
Incremental transcript: Keep the last message id and pass it as after to fetch only what is new.