/

/Reflex API

Changes Docs Sign in

Docs
History
Schema

Filter operations

activity1

agent-associations1

agent-drafts3

agent-groups6

agent-labels6

agent-personas3

agents41

get/agentsList the agents in the active organization.
post/agentsCreate and launch a new agent run.
get/agents/{id}Get a single agent by id.
delete/agents/{id}Delete the agent: force stop it, shut down its devbox, and hide the run.
patch/agents/{id}Update an agent's name or pinned state.
post/agents/{id}/archiveArchive the agent run.
post/agents/{id}/capability-requests/{requestId}/decisionAnswer an agent's capability request (allow once, for this agent, always, deny, never).
get/agents/{id}/commands/{commandId}Read the delivery status of a command sent to the agent.
post/agents/{id}/completeMark the agent's run as completed without shutting down its devbox.
post/agents/{id}/control-responseAnswer a pending control request from the agent.
get/agents/{id}/devbox-logsFetch the platform logs for the agent's devbox.
get/agents/{id}/devbox-statusGet the live status, size, and architecture of the agent's devbox.
post/agents/{id}/interruptInterrupt the agent's current turn.
get/agents/{id}/listenersList the listeners (timers, ref signals, watches) an agent has armed.
post/agents/{id}/listeners/{listenerId}/cancelCancel an armed or pending listener.
post/agents/{id}/listeners/{listenerId}/renewExtend an armed listener's lease.
post/agents/{id}/markSet or clear the agent's triage mark.
post/agents/{id}/mcp-serversAttach MCP servers to a running agent's devbox.
post/agents/{id}/messageSend a message to the agent's chat.
post/agents/{id}/pinPin the agent.
get/agents/{id}/queueList the messages queued for the agent.
post/agents/{id}/queueAdd a message to the agent's queue.
delete/agents/{id}/queue/{msgId}Remove a message from the agent's queue.
patch/agents/{id}/queue/{msgId}Edit a queued message.
put/agents/{id}/queue/orderReorder the agent's queued messages.
get/agents/{id}/refsList the refs (pull requests, issues) an agent holds, with each kind's signals and actions.
post/agents/{id}/resumeResume the agent's devbox if it is suspended.
post/agents/{id}/runtime-settingsRetarget a running agent's sticky runtime settings.
get/agents/{id}/services/{serviceId}/logsFetch the log for one service on the agent's devbox.
get/agents/{id}/services/statusGet the live status of every service on the agent's devbox.
get/agents/{id}/session-indexThe agent's session index: every prompt and turn boundary, for nav and paging.
post/agents/{id}/snapshotsCapture a reusable snapshot of the agent's devbox disk.
post/agents/{id}/stopStop the agent's run and shut down its devbox.
get/agents/{id}/streamGet the agent's event history: a turn-aligned window for indexed agents, the full array for legacy ones.
put/agents/{id}/subscriptionSwitch the model-provider subscription a running agent uses.
post/agents/{id}/unarchiveUnarchive the agent run.
post/agents/{id}/unpinUnpin the agent.
post/agents/{id}/unreadMark the agent unread for the current user.
post/agents/{id}/viewRecord that the current user has viewed the agent.
post/agents/archive-allArchive every matching agent run in the active organization.
get/agents/viewsList the current user's per-agent last-viewed timestamps.

auth10

blueprints7

company8

config3

device3

enterprise-identity9

flags8

invites5

mcp1

me17

org-setup13

organizations56

permissions1

plugins3

profile1

resource-grants5

secrets1

service-accounts6

share-requests4

snapshots4

status1

teams7

uploads2

user8

users3

agents

Changes to The agent's session index: every prompt and turn boundary, for nav and paging.

get/agents/{id}/session-index

Aug 26, 2026a72c6e2e7f71 Revision changes
- info
  endpoint added