How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Scott Ai

Scott Ai agent-loop API

The agent-loop API from Scott Ai — 16 operation(s) for agent-loop.

Documentation Provider Profile APIs.io OpenAPI GitHub

Scott Ai agent-loop API is one of 30 APIs that Scott Ai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include agent-loop. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 20 operations across 16 paths, and defines 64 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against the base URL https://api.tryscott.ai.

20 operations 16 paths 64 schemas 1 DELETE8 GET3 PATCH7 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.tryscott.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Scott Ai agent-loop API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 20

Across 16 paths, the API surfaces 20 operations — 1 DELETE, 8 GET, 3 PATCH, 7 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

agent-loop 20
GET
/agent-loop/workspaces
List Workspaces
list_workspaces → 200
POST
/agent-loop/workspaces
Create Workspace
create_workspace body → 200422
DELETE
/agent-loop/workspaces/{workspace_id}
Delete Workspace
delete_workspace 1 param → 200422
PATCH
/agent-loop/workspaces/{workspace_id}
Update Workspace
update_workspace 1 param body → 200422
POST
/agent-loop/workspaces/{workspace_id}/turns
Create Turn
create_turn 1 param body → 200422
PATCH
/agent-loop/turns/{turn_id}
Update Turn
update_turn 2 params body → 200422
GET
/agent-loop/workspaces/{workspace_id}/state
Get Workspace State
get_workspace_state 1 param → 200422
GET
/agent-loop/workspaces/{workspace_id}/events
Workspace Event Stream
workspace_event_stream 2 params → 200422
POST
/agent-loop/workspaces/{workspace_id}/wake
Wake Workspace
wake_workspace 1 param → 200422
GET
/agent-loop/workspaces/{workspace_id}/context
Get Workspace Context
get_workspace_context 4 params → 200422
POST
/agent-loop/workspaces/{workspace_id}/review-chat/turns
Create Review Chat Turn
create_review_chat_turn 1 param body → 200422
GET
/agent-loop/workspaces/{workspace_id}/review-chat/turns
List Review Chat Turns
list_review_chat_turns 2 params → 200422
GET
/agent-loop/workspaces/{workspace_id}/review-chat/context
Get Review Chat Context
get_review_chat_context 3 params → 200422
PATCH
/agent-loop/review-chat/turns/{turn_id}
Update Review Chat Turn
update_review_chat_turn 2 params body → 200422
POST
/agent-loop/workspaces/{workspace_id}/access-token
Mint Access Token
mint_access_token 1 param → 200422
GET
/agent-loop/internal/workspaces/{workspace_id}/connected-sources/{connected_source_id}/retrieval-details
Get Connected Source Retrieval Details
get_connected_source_retrieval_details 3 params → 200422
POST
/agent-loop/internal/agent-token/redeem
Redeem Handoff Code
redeem_handoff_code 1 param body → 200422
POST
/agent-loop/internal/sandbox/heartbeat
Sandbox Heartbeat
sandbox_heartbeat 1 param → 200422
PUT
/agent-loop/workspaces/{workspace_id}/cursor
Upsert Cursor
upsert_cursor 1 param body → 200422
GET
/agent-loop/workspaces/{workspace_id}/cursor
Get Cursor
get_cursor 1 param → 200422

Schemas 64

The contract defines 64 schemas that model the data the API accepts and returns. The most detailed are CommitReferenceSummary (17 properties), ScottPushSpec (15 properties), Turn (15 properties), TurnSummary (14 properties). Each schema is shown below with its type and property counts.

WorkspaceConfig
object
Agent-service hydration. Used in WorkspaceSnapshotResponse only.
8 properties 3 required
ChangeEntry
object
One semantic change emitted by the agent's writedocument tool. Field-name casing matches the agent's serialization (camelCase) so Pydantic round-trips without…
4 properties 3 required
UploadedFileSourceConfig
object
Configuration for an uploaded file source
1 property 1 required
PromptContextTurn
object
4 properties 3 required
RetrievalKind
string
Kind of retrieval method (git clone, file download, etc.)
CreateWorkspaceResponse
object
4 properties 2 required
ArtifactContent
object
Blocks + markdown to render. Selection rule lives in buildartifactsummaries (cursor-scoped latest capture, else creation node).
2 properties 2 required
ReviewChatContextResponse
object
Review-chat's snapshot-scoped context. Shape lives in SnapshotScopedContext; this subclass owns review-chat's name + OpenAPI id.
4 properties 3 required
TokenUsage
object
5 properties 5 required
ValidationError
object
5 properties 3 required
UpdateTurnRequest
object
6 properties
ReviewChatThreadTurn
object
One persisted review-chat turn for renderer rehydration. Mirrors the contributor TurnSummary fields the Chat tab paints: the reviewer's message and the final a…
6 properties 6 required
HTTPValidationError
object
1 property
RedeemHandoffRequest
object
1 property 1 required
WorkspaceListItem
object
GET /workspaces list entry. Adds turn aggregates.
13 properties 3 required
CreateReviewChatTurnResponse
object
2 properties 2 required
UploadedFileSourceMetadata
object
Metadata for an uploaded file source
3 properties 1 required
SourceVisibility
string
Visibility level of a source
ScottPushSpec
object
Optional sub-object on CreateWorkspaceRequest that turns the call into a Scott push. Idempotent on (capturedbyuserid, sourcekind, sourceid): same triple from t…
15 properties 3 required
ScottPushPayloadTotals
object
7 properties 7 required
ListWorkspacesResponse
object
1 property 1 required
ArtifactSummary
object
Server-materialized view of one document artifact. Identity + the boundary content to display. Content is picked by buildartifactsummaries: capture snapshots s…
7 properties 5 required
CanonicalMessageSpec
object
One message in the verbatim conversation transcript.
4 properties 2 required
CreateReviewChatTurnRequest
object
Renderer body for opening/extending a private review-chat thread. parentturnid is null for the thread's first message and the prior turn's id thereafter. id le…
4 properties 1 required
RetrievalResult
object
Result of retrieving a source (how to actually fetch it)
2 properties 2 required
GitHubSourceMetadata
object
Metadata for a GitHub source
2 properties 2 required
SubagentSummary
object
6 properties 5 required
RedeemHandoffResponse
object
1 property 1 required
AccessTokenResponse
object
3 properties 3 required
CacheBreak
object
6 properties 4 required
ConnectedSourceSelection
object
2 properties 2 required
WorkspaceStateResponse
object
Single call gives the renderer everything needed to paint the workspace page.
11 properties 2 required
TurnSummary
object
Renderer turn shape (GET /state). Strips LLM internals. Only DAG annotation emitted is activeartifactid. GitGraph layout fields (effectivedocparentid, docchild…
14 properties 8 required
SnapshotNode
object
12 properties 7 required
CommentSnapshot
object
Comment projection for agent context — derived from threadcomments joined with threads and the author's user profile. Replies share parentid = the thread's fir…
7 properties 4 required
PromptSummary
object
8 properties 7 required
CreateTurnResponse
object
2 properties 2 required
CreateWorkspaceRequest
object
10 properties 1 required
SnapshotInfo
object
3 properties 2 required
UpsertCursorRequest
object
2 properties
UploadedFileSourceSelection
object
User's selection when connecting an uploaded file source
2 properties 1 required
MemberCursor
object
4 properties 4 required
Suggestion
object
An unresolved agent suggestion sitting on a draft snapshot. An agent turn writes this onto the focused draft instead of committing a node; the human resolves i…
6 properties 4 required
ConnectedSource
object
6 properties 4 required
CommitReferenceSummary
object
Server-materialized view of one code-commit reference attached to a turn. Read-only; rows are immutable after a Scott push. Renderer groups by producedatturnid…
17 properties 11 required
FileRetrievalDetails
object
Details for retrieving source via file download
5 properties 2 required
GitHubSourceSelection
object
User's selection when connecting a GitHub source
2 properties 2 required
SlackSourceMetadata
object
Metadata for a Slack source
3 properties 1 required
Turn
object
Agent-service turn shape (GET /context). Includes LLM internals so the agent can rebuild context across the parentid chain.
15 properties 8 required
CursorResponse
object
5 properties 4 required
ScottPushPayload
object
Full structured session capture produced by scott push. Source of truth for the TS side is the orval-generated schema (derived from this Pydantic model). Bumpe…
10 properties 7 required
SessionSpan
object
4 properties 4 required
WakeWorkspaceResponse
object
1 property 1 required
GitHubSourceConfig
object
Configuration for a GitHub source
2 properties 2 required
ReviewChatThreadResponse
object
The caller's full private review-chat thread on one snapshot, oldest first. Scoped to (workspace, snapshot, reviewer); another reviewer's thread is never inclu…
1 property 1 required
SlackSourceConfig
object
Configuration for a Slack source
2 properties 2 required
GitRetrievalDetails
object
Details for retrieving source via git clone
6 properties 5 required
WorkspaceContextInfo
object
5 properties 1 required
SlackSourceSelection
object
User's selection when connecting a Slack source
2 properties 2 required
CreateTurnRequest
object
6 properties
ReviewerContextTurn
object
A snapshot-scoped thread turn for agent hydration. parentid is the linear chain pointer; user authorship is always the reviewer.
8 properties 4 required
WorkspaceSnapshotResponse
object
6 properties 2 required
AdapterType
string
Type of source adapter (github, uploadedfile, etc.)
UpdateWorkspaceRequest
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

scott-ai-agent-loop-api-openapi.yml Raw ↑

Other APIs Scott Ai publishes across the network.

Scott Ai access API
AE Profile APIs.io
Scott Ai agent-counsel API
AE Profile APIs.io
Scott Ai agent-counsel-internal API
AE Profile APIs.io
Scott Ai agent-loop-internal API
AE Profile APIs.io
Scott Ai artifacts API
AE Profile APIs.io
Scott Ai auth API
AE Profile APIs.io
Scott Ai billing API
AE Profile APIs.io
Scott Ai cli-version API
AE Profile APIs.io
Scott Ai connected-sources API
AE Profile APIs.io
Scott Ai conversations API
AE Profile APIs.io
Scott Ai documents API
AE Profile APIs.io
Scott Ai e2b API
AE Profile APIs.io
#agent-loop
← Back to S APIs
API Details
ID
scott-ai:scott-ai-agent-loop-api
Base URL
https://api.tryscott.ai
Docs
https://docs.tryscott.ai
Provider
Scott Ai
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=scott-ai-agent-loop-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/scott-ai-agent-loop-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Scott Ai agent-loop API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.