# Chief API

> Programmatic access to Chief chats, assets, and labels via the public REST API.

## Docs

- [Create an asset upload](https://dev.chief.bot/api-reference/assets/create-an-asset-upload.md): Create an asset and get a signed upload URL.
- [Get asset state](https://dev.chief.bot/api-reference/assets/get-asset-state.md): Retrieve the current state of an asset.
- [List assets](https://dev.chief.bot/api-reference/assets/list-assets.md): List assets in the focused project.
- [Mark an asset upload complete](https://dev.chief.bot/api-reference/assets/mark-an-asset-upload-complete.md): Finalize an upload and start ingest.
- [Fetch a single message](https://dev.chief.bot/api-reference/chats/fetch-a-single-message.md): Retrieve a single message, including prompt and response when ready.
- [Fetch chat metadata](https://dev.chief.bot/api-reference/chats/fetch-chat-metadata.md): Retrieve metadata for a single chat.
- [List chats](https://dev.chief.bot/api-reference/chats/list-chats.md): List chats in the focused project.
- [List messages in a chat](https://dev.chief.bot/api-reference/chats/list-messages-in-a-chat.md): List message IDs for a chat.
- [Send a message on an existing chat](https://dev.chief.bot/api-reference/chats/send-a-message-on-an-existing-chat.md): Append a message to an existing chat.
- [Start a chat](https://dev.chief.bot/api-reference/chats/start-a-chat.md): Start a new chat and kick off the first assistant turn.
- [Errors](https://dev.chief.bot/api-reference/errors.md): Troubleshoot API failures with the error envelope and stable error codes.
- [Introduction](https://dev.chief.bot/api-reference/introduction.md): General concepts, response codes, and authentication for the Chief Public API.
- [Attach a label to an asset by name](https://dev.chief.bot/api-reference/labels/attach-a-label-to-an-asset-by-name.md): Attach a label to an asset by name.
- [Create a label](https://dev.chief.bot/api-reference/labels/create-a-label.md): Create a label in the focused project.
- [List labels](https://dev.chief.bot/api-reference/labels/list-labels.md): List labels in the focused project.
- [Pagination](https://dev.chief.bot/api-reference/pagination.md): Learn how cursor pagination works in the Chief Public API.
- [Assets](https://dev.chief.bot/guides/assets.md): Upload files with signed URLs, complete ingest, and poll until ready.
- [Chats](https://dev.chief.bot/guides/chats.md): Start chats, append turns, list history, and poll for assistant output.
- [Labels](https://dev.chief.bot/guides/labels.md): Create labels, list them, and attach labels to assets.
- [Chief API documentation](https://dev.chief.bot/index.md): Build integrations on Chief with the public REST API.
- [Quickstart](https://dev.chief.bot/quickstart.md): Send your first Chief API request in minutes.

## OpenAPI Specs

- [openapi](https://dev.chief.bot/openapi.yaml)

## Optional

- [Chief](https://chief.bot)
- [OpenAPI spec](https://api.storytell.ai/v1/openapi.yaml)