# Athena | API Reference Docs

## 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://docs.athenaintel.com/_mcp/server

## Docs

- [Quickstart](https://docs.athenaintel.com/getting-started/athena-sdk-quickstart.md): Learn how to get started with Athena Python and TypeScript SDKs.
- [Database API](https://docs.athenaintel.com/database-api/database-filters-crud.md): Query, update, and delete data from your databases using PostgREST-style filters
- [Athena CLI](https://docs.athenaintel.com/cli/athena-cli.md)
- [Build with Agents](https://docs.athenaintel.com/python-guides/build-with-agents.md): Use the General Agent to perform long-running tasks with tool use.
- [Use Models Directly](https://docs.athenaintel.com/python-guides/use-models-directly.md): Access Athena's models directly for simple text generation
- [Load Data Frames](https://docs.athenaintel.com/python-guides/load-data-frames.md)
- [Upload Files](https://docs.athenaintel.com/python-guides/upload-files.md)
- [Create Assets](https://docs.athenaintel.com/python-guides/create-assets.md): Create spreadsheets, documents, and folders programmatically with the Python SDK
- [Handle Large Task Results](https://docs.athenaintel.com/python-guides/handle-large-task-results.md): Persist oversized task outputs as reusable assets instead of returning them inline
- [Structured Output](https://docs.athenaintel.com/python-guides/structured-output.md): Extract structured data from text using JSON schemas.
- [Long-Running AOP Execution](https://docs.athenaintel.com/python-guides/long-running-aop-execution.md): Execute AOPs asynchronously with proper polling for completion. Essential pattern for reliable AOP execution.
- [Build with Agents](https://docs.athenaintel.com/type-script-guides/build-with-agents.md): Use the General Agent to perform long-running tasks with tool use.
- [Working with Assets](https://docs.athenaintel.com/type-script-guides/working-with-assets.md): Learn how to list, retrieve, and work with assets using the Athena SDK.
- [Use Models Directly](https://docs.athenaintel.com/type-script-guides/use-models-directly.md): Access Athena's models directly with the TypeScript SDK
- [Execute AOPs](https://docs.athenaintel.com/type-script-guides/execute-ao-ps.md): Execute Agent Operating Procedures (AOPs) with the TypeScript SDK using asynchronous execution
- [Sheets API](https://docs.athenaintel.com/type-script-guides/sheets-api.md): Programmatically read and modify Athena Sheets using the TypeScript SDK
- [Embed Athena Assets](https://docs.athenaintel.com/type-script-guides/embed-athena-assets.md): Render native Athena assets inside your application
- [Browser JavaScript (ESM)](https://docs.athenaintel.com/type-script-guides/browser-java-script-esm.md): Use the Athena Intelligence SDK directly in the browser with ESM modules
- [UI Registry (Assistant.js)](https://docs.athenaintel.com/type-script-guides/ui-registry-assistant-js.md): Create interactive tools and dynamic instructions for AI-powered User Interface assets using the registry from Assistant.js
- [Upload Files](https://docs.athenaintel.com/type-script-guides/upload-files.md): Upload and manage files using the TypeScript SDK
- [Create Assets](https://docs.athenaintel.com/type-script-guides/create-assets.md): Create spreadsheets, documents, and folders programmatically with the TypeScript SDK
- [Structured Output](https://docs.athenaintel.com/type-script-guides/structured-output.md): Extract structured data using custom schemas with the TypeScript SDK
- [Changelog](https://docs.athenaintel.com/changelog.md)
- [Changelog (all entries)](https://docs.athenaintel.com/changelog/llms.txt)

## API Docs

- API Reference > Agents > General [Invoke](https://docs.athenaintel.com/api-reference/agents/general/invoke.md)
- API Reference > Aop [Get Batch Execution Status](https://docs.athenaintel.com/api-reference/aop/get-batch-status.md)
- API Reference > Aop [Create AOP](https://docs.athenaintel.com/api-reference/aop/create.md)
- API Reference > Aop [Execute Agent Operating Procedure](https://docs.athenaintel.com/api-reference/aop/execute.md)
- API Reference > Aop [Execute Agent Operating Procedure Asynchronously](https://docs.athenaintel.com/api-reference/aop/execute-async.md)
- API Reference > Aop [Execute a Batch of Agent Operating Procedures](https://docs.athenaintel.com/api-reference/aop/execute-batch.md)
- API Reference > Aop [Get AOP configuration](https://docs.athenaintel.com/api-reference/aop/get-config.md)
- API Reference > Aop [Overwrite AOP configuration](https://docs.athenaintel.com/api-reference/aop/update-config.md)
- API Reference > Assets [List assets](https://docs.athenaintel.com/api-reference/assets/list.md)
- API Reference > Assets [Convert an Excel asset to an Athena sheet](https://docs.athenaintel.com/api-reference/assets/convert-excel-to-sheet.md)
- API Reference > Assets [Create a new asset](https://docs.athenaintel.com/api-reference/assets/create.md)
- API Reference > Assets [Create Project](https://docs.athenaintel.com/api-reference/assets/create-project.md)
- API Reference > Assets [Duplicate an asset](https://docs.athenaintel.com/api-reference/assets/duplicate.md)
- API Reference > Assets [Get asset by ID](https://docs.athenaintel.com/api-reference/assets/get.md)
- API Reference > Assets [Rename an asset](https://docs.athenaintel.com/api-reference/assets/rename.md)
- API Reference > Assets [List an asset's activity log](https://docs.athenaintel.com/api-reference/assets/list-activity.md)
- API Reference > Assets [Get what changed in one or more activity items](https://docs.athenaintel.com/api-reference/assets/get-activity-delta.md)
- API Reference > Assets [Get what changed across several activity items in one call](https://docs.athenaintel.com/api-reference/assets/get-activity-deltas.md)
- API Reference > Assets [Archive an asset](https://docs.athenaintel.com/api-reference/assets/archive.md)
- API Reference > Assets [Create Collab Token](https://docs.athenaintel.com/api-reference/assets/create-collab-token.md)
- API Reference > Assets [Download an asset's file](https://docs.athenaintel.com/api-reference/assets/download.md)
- API Reference > Assets [Move an asset](https://docs.athenaintel.com/api-reference/assets/move.md)
- API Reference > Assets [Share an asset with users](https://docs.athenaintel.com/api-reference/assets/share.md)
- API Reference > Assets [Update workspace access for an asset](https://docs.athenaintel.com/api-reference/assets/update-workspace-access.md)
- API Reference > Collab Agents [Send Message to Collab Agent](https://docs.athenaintel.com/api-reference/collab-agents/send-message.md)
- API Reference > Computer [Deploy a computer asset to a preview URL](https://docs.athenaintel.com/api-reference/computer/deploy-computer.md)
- API Reference > Computer [Read a computer initialization attempt](https://docs.athenaintel.com/api-reference/computer/get-initialization.md)
- API Reference > Computer [Get the SSH connection target for a computer asset](https://docs.athenaintel.com/api-reference/computer/get-ssh-access.md)
- API Reference > Computer [Create SSH access for a computer asset](https://docs.athenaintel.com/api-reference/computer/create-ssh-access.md)
- API Reference > Computer [Revoke SSH access for a computer asset](https://docs.athenaintel.com/api-reference/computer/revoke-ssh-access.md)
- API Reference > Computer [Start a stopped computer asset](https://docs.athenaintel.com/api-reference/computer/start-computer.md)
- API Reference > Computer [Stop a running computer asset](https://docs.athenaintel.com/api-reference/computer/stop-computer.md)
- API Reference > Databases [Check database status](https://docs.athenaintel.com/api-reference/databases/get-status.md)
- API Reference > Databases [List tables in database](https://docs.athenaintel.com/api-reference/databases/list-tables.md)
- API Reference > Databases [Read rows from database table](https://docs.athenaintel.com/api-reference/databases/select.md)
- API Reference > Databases [Insert rows into database table](https://docs.athenaintel.com/api-reference/databases/insert.md)
- API Reference > Databases [Delete rows from database table](https://docs.athenaintel.com/api-reference/databases/delete.md)
- API Reference > Databases [Update rows in database table](https://docs.athenaintel.com/api-reference/databases/update.md)
- API Reference > Databases [Get table schema (columns and types)](https://docs.athenaintel.com/api-reference/databases/get-table-schema.md)
- API Reference > Databases [Execute SQL against database](https://docs.athenaintel.com/api-reference/databases/execute-sql.md)
- API Reference > Users [Get current user information](https://docs.athenaintel.com/api-reference/users/me.md)
- API Reference > Users [Get the caller's Microsoft 365 source readiness](https://docs.athenaintel.com/api-reference/users/me-sources.md)
- API Reference > Users [List the caller's SSH public keys](https://docs.athenaintel.com/api-reference/users/list-ssh-keys.md)
- API Reference > Users [Register an SSH public key](https://docs.athenaintel.com/api-reference/users/add-ssh-key.md)
- API Reference > Users [Delete one of the caller's SSH public keys](https://docs.athenaintel.com/api-reference/users/delete-ssh-key.md)
- API Reference > Meetings [List meetings](https://docs.athenaintel.com/api-reference/meetings/list.md)
- API Reference > Meetings [Get meeting by ID](https://docs.athenaintel.com/api-reference/meetings/get.md)
- API Reference > Meetings [Download meeting artifacts](https://docs.athenaintel.com/api-reference/meetings/download.md)
- API Reference > Query [Get Tabular Data from SQL snippet](https://docs.athenaintel.com/api-reference/query/execute-snippet.md)
- API Reference > Semantic Model [Generate Cube API Token](https://docs.athenaintel.com/api-reference/semantic-model/generate-token.md)
- API Reference > Semantic Model [Get Semantic Model Metadata](https://docs.athenaintel.com/api-reference/semantic-model/get-meta.md)
- API Reference > Semantic Model [Query Semantic Model](https://docs.athenaintel.com/api-reference/semantic-model/query.md)
- API Reference > Sessions [List sessions](https://docs.athenaintel.com/api-reference/sessions/list.md)
- API Reference > Sessions [Get session by ID](https://docs.athenaintel.com/api-reference/sessions/get.md)
- API Reference > Sessions [Download session history](https://docs.athenaintel.com/api-reference/sessions/download.md)
- API Reference > Sessions [Mark session as read](https://docs.athenaintel.com/api-reference/sessions/mark-read.md)
- API Reference > Sessions [Mark session as unread](https://docs.athenaintel.com/api-reference/sessions/mark-unread.md)
- API Reference > Threads [Batch Stop Thread Executions](https://docs.athenaintel.com/api-reference/threads/batch-stop-by-asset-id.md)
- API Reference > Threads [Get Status of Many Threads](https://docs.athenaintel.com/api-reference/threads/get-status-batch.md)
- API Reference > Threads [Batch Stop Threads](https://docs.athenaintel.com/api-reference/threads/batch-stop.md)
- API Reference > Threads [Get Thread Status](https://docs.athenaintel.com/api-reference/threads/get-status.md)
- API Reference > Threads [Stop Thread Execution](https://docs.athenaintel.com/api-reference/threads/stop.md)
- API Reference > Tools [List read capabilities for every asset type](https://docs.athenaintel.com/api-reference/tools/get-asset-capabilities.md)
- API Reference > Tools [Get the chunks of an asset by ID](https://docs.athenaintel.com/api-reference/tools/get-asset-chunks.md)
- API Reference > Tools [Get the content of an asset by ID](https://docs.athenaintel.com/api-reference/tools/get-asset-content.md)
- API Reference > Tools [Read one or more assets with anchors, formats, and pagination](https://docs.athenaintel.com/api-reference/tools/read-asset.md)
- API Reference > Tools [Get a screenshot of a specific page from an asset](https://docs.athenaintel.com/api-reference/tools/get-asset-screenshot.md)
- API Reference > Tools [List Contents](https://docs.athenaintel.com/api-reference/tools/list-contents.md)
- API Reference > Tools [Get Tabular Data from Object](https://docs.athenaintel.com/api-reference/tools/data-frame.md)
- API Reference > Tools [Get Raw File Data from Object](https://docs.athenaintel.com/api-reference/tools/raw-data.md)
- API Reference > Tools [Save file as an asset](https://docs.athenaintel.com/api-reference/tools/save-asset.md)
- API Reference > Tools > Calendar [List calendar events](https://docs.athenaintel.com/api-reference/tools/calendar/list-events.md)
- API Reference > Tools > Email [Create an email draft](https://docs.athenaintel.com/api-reference/tools/email/create-draft.md)
- API Reference > Tools > Email [Search emails](https://docs.athenaintel.com/api-reference/tools/email/search.md)
- API Reference > Tools > Sheets [Update Cell](https://docs.athenaintel.com/api-reference/tools/sheets/update-cell.md)
- API Reference > Tools > Sheets [Delete Cells](https://docs.athenaintel.com/api-reference/tools/sheets/delete-cells.md)
- API Reference > Tools > Sheets [Delete Column](https://docs.athenaintel.com/api-reference/tools/sheets/delete-column.md)
- API Reference > Tools > Sheets [Insert Column](https://docs.athenaintel.com/api-reference/tools/sheets/insert-column.md)
- API Reference > Tools > Sheets [Clear Formatting](https://docs.athenaintel.com/api-reference/tools/sheets/clear-formatting.md)
- API Reference > Tools > Sheets [Clear Range](https://docs.athenaintel.com/api-reference/tools/sheets/clear-range.md)
- API Reference > Tools > Sheets [Format Range](https://docs.athenaintel.com/api-reference/tools/sheets/format-range.md)
- API Reference > Tools > Sheets [Update Range](https://docs.athenaintel.com/api-reference/tools/sheets/update-range.md)
- API Reference > Tools > Sheets [Insert Row](https://docs.athenaintel.com/api-reference/tools/sheets/insert-row.md)
- API Reference > Tools > Sheets [Duplicate Sheet](https://docs.athenaintel.com/api-reference/tools/sheets/duplicate-sheet.md)
- API Reference > Tools > Sheets [Create Tab](https://docs.athenaintel.com/api-reference/tools/sheets/create-tab.md)
- API Reference > Tools > Sheets [Delete Table Column](https://docs.athenaintel.com/api-reference/tools/sheets/delete-table-column.md)
- API Reference > Tools > Sheets [Insert Table Column](https://docs.athenaintel.com/api-reference/tools/sheets/insert-table-column.md)
- API Reference > Tools > Sheets [Create Table](https://docs.athenaintel.com/api-reference/tools/sheets/create-table.md)
- API Reference > Tools > Sheets [Get Table](https://docs.athenaintel.com/api-reference/tools/sheets/get-table.md)
- API Reference > Tools > Sheets [Insert Table Row](https://docs.athenaintel.com/api-reference/tools/sheets/insert-table-row.md)
- API Reference > Tools > Sheets [Update Table](https://docs.athenaintel.com/api-reference/tools/sheets/update-table.md)
- API Reference > Tools > Structured Data Extractor [Invoke](https://docs.athenaintel.com/api-reference/tools/structured-data-extractor/invoke.md)
- API Reference > Tools > Tasks [Run Task](https://docs.athenaintel.com/api-reference/tools/tasks/run-task.md)
- API Reference > Workspaces [Get workspace configuration](https://docs.athenaintel.com/api-reference/workspaces/get-configuration.md)
- API Reference > Workspaces [Update workspace configuration](https://docs.athenaintel.com/api-reference/workspaces/update-configuration.md)
- API Reference > Workspaces [Get workspace Tool Registry configuration](https://docs.athenaintel.com/api-reference/workspaces/get-tool-registry.md)
- API Reference > Workspaces [Update workspace Tool Registry configuration](https://docs.athenaintel.com/api-reference/workspaces/update-tool-registry.md)

## OpenAPI Specification

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