Agents

Retrieve an agent's current status and the latest turn's conversation. The response carries id, spreadsheet_id, status, created_at, last_activity_at, number_of_turns, the effective models, the latest turn's error_message, and messages — the latest turn as a single ordered array (user messages, assistant messages, and tool calls with compact summaries). The full conversation across all turns is paginated via GET {id}/messages.

get/v1/{platform}/agents/{id}

Request

  • Base URL: https://api.autosheet.com
  • URL: https://api.autosheet.com/v1/{platform}/agents/{id}
  • Auth: none required

Path parameters

platformstring required
idstring required

Query parameters

include_intermediate_tool_failuresboolean

Set to false to omit a failed tool-call attempt when a later tool call in the latest turn succeeds. Terminal tool-call failures and the turn's error_message remain visible. Defaults to true for backward compatibility. This does not affect the paginated messages endpoint.

Response

Ok

idstring required
spreadsheet_idstring required
status'active' | 'idle' required
created_atstring required
last_activity_atstring nullable required
number_of_turnsnumber double required

Total number of turns in this agent's conversation, including the one in progress when the agent is active.

error_messagestring nullable required

The latest turn's error message (failure reason), or null when it has not errored. Always returned — errored turns produce no assistant message, so this is where the failure surfaces.

error_codestring nullable required

The latest turn's gpt-errors code, or null when it has not errored or the failure carried no code. Lets a client branch on the condition instead of matching the message (GPT-4710).

error_paramsRecordStringUnknown

Construct a type with a set of properties K of type T

Changes

No recorded changes to this operation across all 1 revision of this API.