# Documentação - Quintus ## Docs - [Create a conversation](https://quintus.tec.br/docs/api-reference/conversations/create-a-conversation.md): Create a new conversation with an agent and receive a session token. - [Generate an inactivity message](https://quintus.tec.br/docs/api-reference/conversations/generate-an-inactivity-message.md): Emit an inactivity warning or final message. `final` may auto-close the conversation. - [Get conversation state](https://quintus.tec.br/docs/api-reference/conversations/get-conversation-state.md): Read the current state of a conversation. Use this to recover state after page reload. - [Refresh the session token of a conversation](https://quintus.tec.br/docs/api-reference/conversations/refresh-the-session-token-of-a-conversation.md): Issue a new short-lived session token for an existing conversation. Authenticate with the conversation's API key. The previous token stays valid until its own expiry. - [Terminate a conversation](https://quintus.tec.br/docs/api-reference/conversations/terminate-a-conversation.md): Explicitly close a conversation. Idempotent. - [Submit feedback for the conversation](https://quintus.tec.br/docs/api-reference/feedback/submit-feedback-for-the-conversation.md): Single feedback per conversation. POST is upsert. - [Delete file](https://quintus.tec.br/docs/api-reference/files/delete-file.md): Delete the file from the tenant pool. Sessions/messages that reference this file may surface broken pointers. - [Get file metadata](https://quintus.tec.br/docs/api-reference/files/get-file-metadata.md) - [List conversation files](https://quintus.tec.br/docs/api-reference/files/list-conversation-files.md) - [List files](https://quintus.tec.br/docs/api-reference/files/list-files.md): List files in the tenant pool with offset pagination. - [Upload a file to a conversation](https://quintus.tec.br/docs/api-reference/files/upload-a-file-to-a-conversation.md) - [Upload file](https://quintus.tec.br/docs/api-reference/files/upload-file.md): Upload a file to the tenant pool. Reusable across sessions and messages by referencing the returned id. Max 25 MB. - [Get a single message](https://quintus.tec.br/docs/api-reference/messages/get-a-single-message.md) - [Get message](https://quintus.tec.br/docs/api-reference/messages/get-message.md) - [List messages](https://quintus.tec.br/docs/api-reference/messages/list-messages.md): List messages with offset pagination and optional role filter. - [Send a message](https://quintus.tec.br/docs/api-reference/messages/send-a-message.md): Send a single message to the agent and receive the full exchange (user echo + assistant reply). For streamed responses, use `POST /conversations/{conversation_id}/messages/stream`. - [Send a message (streaming)](https://quintus.tec.br/docs/api-reference/messages/send-a-message-streaming.md): Same input as `POST /conversations/{id}/messages` but the response is an SSE (`text/event-stream`) byte stream of agent runtime events. Clients MUST ignore unknown event types - new event names may be added over time. - [Send message](https://quintus.tec.br/docs/api-reference/messages/send-message.md): Send a single message to the session's agent and receive the full exchange (user echo + assistant reply). For streamed responses, use `POST /sessions/{session_id}/messages/stream`. - [Send message (streaming)](https://quintus.tec.br/docs/api-reference/messages/send-message-streaming.md): Same input as `POST /sessions/{id}/messages` but the response is an SSE (`text/event-stream`) byte stream of agent runtime events. Clients MUST ignore unknown event types. - [Run agent (single-shot)](https://quintus.tec.br/docs/api-reference/runs/run-agent-single-shot.md): Execute the agent with one or more messages. By default a session is created and persisted. Pass `persist=false` for an ephemeral run that leaves no persisted session. - [Create session](https://quintus.tec.br/docs/api-reference/sessions/create-session.md): Create a stateful session bound to an agent. The optional `user` field references an existing user (use POST /users to create one). - [Get session](https://quintus.tec.br/docs/api-reference/sessions/get-session.md) - [List sessions](https://quintus.tec.br/docs/api-reference/sessions/list-sessions.md) - [Terminate session](https://quintus.tec.br/docs/api-reference/sessions/terminate-session.md): Explicitly close a session. Idempotent. - [Create user](https://quintus.tec.br/docs/api-reference/users/create-user.md): Create a new end-user. If `reference` is provided and already exists for this tenant, returns 409. Use PATCH to update existing users. - [Delete user](https://quintus.tec.br/docs/api-reference/users/delete-user.md): Soft-delete the user. Returns 204. - [Get user](https://quintus.tec.br/docs/api-reference/users/get-user.md) - [List users](https://quintus.tec.br/docs/api-reference/users/list-users.md): List users for the current tenant with offset pagination. Filter by reference (returns at most one user, since reference is unique), email, or creation date range. - [Update user](https://quintus.tec.br/docs/api-reference/users/update-user.md): Partial update. Any provided field replaces the stored value. Updating `reference` re-checks uniqueness for this tenant. - [Autenticação de agentes](https://quintus.tec.br/docs/pt-BR/public/api/agents/authentication.md): Como autenticar chamadas na API server-to-server de agentes. - [Visão geral](https://quintus.tec.br/docs/pt-BR/public/api/agents/overview.md): API para uso com sessões de agentes ou execuções únicas em integrações diversas. - [APIs da Quintus](https://quintus.tec.br/docs/pt-BR/public/api/introduction.md): Entenda a diferença entre a API de Agentes e a API de Chats Públicos. - [Autenticação de agentes públicos](https://quintus.tec.br/docs/pt-BR/public/api/public-agents/authentication.md): Como autenticar chamadas na API de agentes públicos. - [Visão geral](https://quintus.tec.br/docs/pt-BR/public/api/public-agents/overview.md): API para uso em ambientes públicos, como o chat widget fornecido pela Quintus. - [Contato e Suporte](https://quintus.tec.br/docs/pt-BR/public/platform/contato.md): Fale com o time da Quintus para contratar, tirar dúvidas ou obter suporte. - [Perguntas Frequentes](https://quintus.tec.br/docs/pt-BR/public/platform/faq.md): Dúvidas mais comuns sobre a Quintus. - [Funcionalidades](https://quintus.tec.br/docs/pt-BR/public/platform/features/overview.md): Tudo que a Quintus oferece para a sua empresa. - [O que é a Quintus?](https://quintus.tec.br/docs/pt-BR/public/platform/introduction.md): Plataforma centralizada de inteligência artificial generativa para empresas. - [Primeiros Passos](https://quintus.tec.br/docs/pt-BR/public/platform/quickstart.md): Como começar a usar a Quintus na sua empresa. ## OpenAPI Specs - [openapi](https://quintus.tec.br/docs/public/api/openapi.json)