# Scout API & SDK Reference

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ref.scoutos.com/_mcp/server


## API Docs

- Endpoints > Workflows [Create a new workflow revision](https://ref.scoutos.com/api-sdk/endpoints/workflows/create-revision.md)
- Endpoints > Workflows [List all workflows](https://ref.scoutos.com/api-sdk/endpoints/workflows/list.md)
- Endpoints > Workflows [Create a new workflow](https://ref.scoutos.com/api-sdk/endpoints/workflows/create.md)
- Endpoints > Workflows [Get a workflow by ID](https://ref.scoutos.com/api-sdk/endpoints/workflows/get.md)
- Endpoints > Workflows [Update a workflow](https://ref.scoutos.com/api-sdk/endpoints/workflows/update.md)
- Endpoints > Workflows [Delete a workflow](https://ref.scoutos.com/api-sdk/endpoints/workflows/delete.md)
- Endpoints > Workflows [Execute a workflow.](https://ref.scoutos.com/api-sdk/endpoints/workflows/run.md)
- Endpoints > Workflows [Execute a workflow with config](https://ref.scoutos.com/api-sdk/endpoints/workflows/run-with-config.md)
- Endpoints > Workflow Revisions [Update a workflow revision](https://ref.scoutos.com/api-sdk/endpoints/workflow-revisions/update.md)
- Endpoints > Revisions [Delete a revision](https://ref.scoutos.com/api-sdk/endpoints/revisions/delete.md)
- Endpoints > Revisions [List workflow revisions](https://ref.scoutos.com/api-sdk/endpoints/revisions/list.md)
- Endpoints > Revisions [Promote a workflow revision](https://ref.scoutos.com/api-sdk/endpoints/revisions/update.md)
- Endpoints > Environments [List workflow environments](https://ref.scoutos.com/api-sdk/endpoints/environments/list.md)
- Endpoints > Environments [Update a workflow environment](https://ref.scoutos.com/api-sdk/endpoints/environments/update.md)
- Endpoints > Usage [Get organization usage](https://ref.scoutos.com/api-sdk/endpoints/usage/get.md)
- Endpoints > Workflow Logs [Get logs for a workflow](https://ref.scoutos.com/api-sdk/endpoints/workflow-logs/list-logs.md)
- Endpoints > Workflow Logs [Get workflow log details](https://ref.scoutos.com/api-sdk/endpoints/workflow-logs/get-details.md)
- Endpoints > Copilots [List all copilots](https://ref.scoutos.com/api-sdk/endpoints/copilots/list.md)
- Endpoints > Copilots [Create a new copilot](https://ref.scoutos.com/api-sdk/endpoints/copilots/create.md)
- Endpoints > Copilots [Get a copilot](https://ref.scoutos.com/api-sdk/endpoints/copilots/get.md)
- Endpoints > Copilots [Update a copilot](https://ref.scoutos.com/api-sdk/endpoints/copilots/update.md)
- Endpoints > Copilots [Delete a copilot](https://ref.scoutos.com/api-sdk/endpoints/copilots/delete.md)
- Endpoints > Triggers [List all triggers](https://ref.scoutos.com/api-sdk/endpoints/triggers/list.md)
- Endpoints > Triggers [Create a new trigger](https://ref.scoutos.com/api-sdk/endpoints/triggers/create.md)
- Endpoints > Triggers [Update an existing trigger](https://ref.scoutos.com/api-sdk/endpoints/triggers/update.md)
- Endpoints > Triggers [Delete a trigger](https://ref.scoutos.com/api-sdk/endpoints/triggers/delete.md)
- Endpoints > Triggers [Handle Slack Events](https://ref.scoutos.com/api-sdk/endpoints/triggers/execute-slack.md)
- Endpoints > Triggers [Handle Telegram Webhook](https://ref.scoutos.com/api-sdk/endpoints/triggers/execute-telegram.md)
- Endpoints > Triggers [Handle crons](https://ref.scoutos.com/api-sdk/endpoints/triggers/execute-cron.md)
- Endpoints > Triggers [Update cron auth headers](https://ref.scoutos.com/api-sdk/endpoints/triggers/update-cron-auth-headers.md)
- Endpoints > Integrations [List integrations for a service](https://ref.scoutos.com/api-sdk/endpoints/integrations/list.md)
- Endpoints > Integrations [List Slack channels](https://ref.scoutos.com/api-sdk/endpoints/integrations/list-channels.md)
- Endpoints > Organizations [Delete a specific integration](https://ref.scoutos.com/api-sdk/endpoints/organizations/delete-integration.md)
- Endpoints > Collections [List all collections.](https://ref.scoutos.com/api-sdk/endpoints/collections/list.md)
- Endpoints > Collections [Create a collection.](https://ref.scoutos.com/api-sdk/endpoints/collections/create.md)
- Endpoints > Collections [Get a collection by ID.](https://ref.scoutos.com/api-sdk/endpoints/collections/get.md)
- Endpoints > Collections [Update a collection by ID.](https://ref.scoutos.com/api-sdk/endpoints/collections/update.md)
- Endpoints > Collections [Delete a collection by ID.](https://ref.scoutos.com/api-sdk/endpoints/collections/delete.md)
- Endpoints > Collections [List syncs for a collection](https://ref.scoutos.com/api-sdk/endpoints/collections/list-syncs.md)
- Endpoints > Collections [Get view state for a collection.](https://ref.scoutos.com/api-sdk/endpoints/collections/get-views.md)
- Endpoints > Collections [Update collection view state](https://ref.scoutos.com/api-sdk/endpoints/collections/update-views.md)
- Endpoints > Collections [Delete collection view state](https://ref.scoutos.com/api-sdk/endpoints/collections/delete-views.md)
- Endpoints > Collections [List collection views](https://ref.scoutos.com/api-sdk/endpoints/collections/list-individual-views.md)
- Endpoints > Collections [Create an individual view.](https://ref.scoutos.com/api-sdk/endpoints/collections/create-view.md)
- Endpoints > Collections [Update an individual view.](https://ref.scoutos.com/api-sdk/endpoints/collections/update-view.md)
- Endpoints > Collections [Delete an individual view.](https://ref.scoutos.com/api-sdk/endpoints/collections/delete-view.md)
- Endpoints > Tables [List all tables in a collection.](https://ref.scoutos.com/api-sdk/endpoints/tables/list.md)
- Endpoints > Tables [Create a table in a collection.](https://ref.scoutos.com/api-sdk/endpoints/tables/create.md)
- Endpoints > Tables [Get a table by ID.](https://ref.scoutos.com/api-sdk/endpoints/tables/get.md)
- Endpoints > Tables [Update a table by ID.](https://ref.scoutos.com/api-sdk/endpoints/tables/update.md)
- Endpoints > Tables [Delete a table by ID.](https://ref.scoutos.com/api-sdk/endpoints/tables/delete.md)
- Endpoints > Tables [Get a tables schema by ID.](https://ref.scoutos.com/api-sdk/endpoints/tables/get-schema.md)
- Endpoints > Tables [Sync a table with documents](https://ref.scoutos.com/api-sdk/endpoints/tables/sync.md)
- Endpoints > Documents [List all documents in a table.](https://ref.scoutos.com/api-sdk/endpoints/documents/list.md)
- Endpoints > Documents [Create a document in a table.](https://ref.scoutos.com/api-sdk/endpoints/documents/create.md)
- Endpoints > Documents [Update multiple documents](https://ref.scoutos.com/api-sdk/endpoints/documents/update-batch.md)
- Endpoints > Documents [Get a document by ID.](https://ref.scoutos.com/api-sdk/endpoints/documents/get.md)
- Endpoints > Documents [Update a document by ID.](https://ref.scoutos.com/api-sdk/endpoints/documents/update.md)
- Endpoints > Documents [Delete a document by ID.](https://ref.scoutos.com/api-sdk/endpoints/documents/delete.md)
- Endpoints > Documents [Delete multiple document by ID.](https://ref.scoutos.com/api-sdk/endpoints/documents/delete-batch.md)
- Endpoints > Sources [List supported source types](https://ref.scoutos.com/api-sdk/endpoints/sources/list.md)
- Endpoints > Syncs [Get all syncs](https://ref.scoutos.com/api-sdk/endpoints/syncs/list.md)
- Endpoints > Syncs [Create a source sync to execute](https://ref.scoutos.com/api-sdk/endpoints/syncs/create.md)
- Endpoints > Syncs [Get a sync by ID.](https://ref.scoutos.com/api-sdk/endpoints/syncs/get.md)
- Endpoints > Syncs [Update a source sync](https://ref.scoutos.com/api-sdk/endpoints/syncs/update.md)
- Endpoints > Syncs [Delete a sync](https://ref.scoutos.com/api-sdk/endpoints/syncs/delete.md)
- Endpoints > Syncs [Sync a source.](https://ref.scoutos.com/api-sdk/endpoints/syncs/execute.md)
- Endpoints > Agents [Interact with an agent (stream)](https://ref.scoutos.com/api-sdk/endpoints/agents/interact.md)
- Endpoints > Agents [Interact with an agent (sync)](https://ref.scoutos.com/api-sdk/endpoints/agents/interact-sync.md)
- Endpoints > Agents [Interact in a session (stream)](https://ref.scoutos.com/api-sdk/endpoints/agents/interact-with-session.md)
- Endpoints > Agents [Interact in a session (sync)](https://ref.scoutos.com/api-sdk/endpoints/agents/interact-sync-with-session.md)
- Endpoints > Agents [Interact with an agent (async)](https://ref.scoutos.com/api-sdk/endpoints/agents/interact-async.md)
- Endpoints > Agents [Interact in a session (async)](https://ref.scoutos.com/api-sdk/endpoints/agents/interact-async-with-session.md)
- Endpoints > Agents [List all agents.](https://ref.scoutos.com/api-sdk/endpoints/agents/list.md)
- Endpoints > Agents [Create or update an agent.](https://ref.scoutos.com/api-sdk/endpoints/agents/upsert.md)
- Endpoints > Agents [Get an agent's active revision](https://ref.scoutos.com/api-sdk/endpoints/agents/get.md)
- Endpoints > Agents [Delete an agent.](https://ref.scoutos.com/api-sdk/endpoints/agents/delete.md)
- Endpoints > Drive [Upload files to Drive.](https://ref.scoutos.com/api-sdk/endpoints/drive/upload.md)
- Endpoints > Drive [Download a file from Drive.](https://ref.scoutos.com/api-sdk/endpoints/drive/download.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://ref.scoutos.com/openapi.json)
- [OpenAPI YAML](https://ref.scoutos.com/openapi.yaml)