# MKA1: Brazilian Portuguese Referência da API

## Referência da API

- [Brazilian Portuguese / Referência da API / Tools and sandbox (56 pages)](https://docs.mka1.com/_llms/pt-br/referencia-da-api/tools-and-sandbox.txt): Documentation for Brazilian Portuguese / Referência da API / Tools and sandbox.
- [Brazilian Portuguese / Referência da API / Usage and budgets (45 pages)](https://docs.mka1.com/_llms/pt-br/referencia-da-api/usage-and-budgets.txt): Documentation for Brazilian Portuguese / Referência da API / Usage and budgets.

### Responses and conversations

#### Responses

- [Crie uma resposta impulsionada por agente com suporte de ferramentas](https://docs.mka1.com/api-reference/responses/crie-uma-resposta-impulsionada-por-agente-com-suporte-de-ferramentas.md): Cria uma nova resposta de agente de IA usando modelos de linguagem avançados com capacidades de uso autônomo de ferramentas.
- [Liste todas as respostas com paginação](https://docs.mka1.com/api-reference/responses/liste-todas-as-respostas-com-paginação.md): Recupera uma lista paginada de todas as respostas dos agentes para o usuário autenticado.
- [Recuperar resposta por ID com status e resultados](https://docs.mka1.com/api-reference/responses/recuperar-resposta-por-id-com-status-e-resultados.md): Recupera uma resposta de agente previamente criada pelo seu ID exclusivo. Quando stream=true, retorna Eventos Enviados pelo Servidor para atualizações em tempo real sobre respostas em andamento.
- [Atualizar uma resposta](https://docs.mka1.com/api-reference/responses/atualizar-uma-resposta.md): Atualizar os metadados de uma resposta.
- [Excluir permanentemente uma resposta e seus dados](https://docs.mka1.com/api-reference/responses/excluir-permanentemente-uma-resposta-e-seus-dados.md): Exclui permanentemente uma resposta de agente e todos os dados associados.
- [Cancelar uma resposta em progresso em segundo plano](https://docs.mka1.com/api-reference/responses/cancelar-uma-resposta-em-progresso-em-segundo-plano.md): Cancela uma resposta de agente que está atualmente sendo processada em segundo plano.
- [Despertar uma resposta em segundo plano adormecida](https://docs.mka1.com/api-reference/responses/despertar-uma-resposta-em-segundo-plano-adormecida.md): Interrompe uma chamada de ferramenta de sono curto em uma resposta em andamento em segundo plano, fornecendo uma entrada de acompanhamento. A entrega de ativação é verificada pelo agente em sono e pode levar até um segundo.
- [Liste os itens de entrada paginados para uma resposta](https://docs.mka1.com/api-reference/responses/liste-os-itens-de-entrada-paginados-para-uma-resposta.md): Recupera uma lista paginada de todos os itens de entrada fornecidos ao criar a resposta do agente especificado.
- [Resumir uma conversa](https://docs.mka1.com/api-reference/responses/resumir-uma-conversa.md): Cria um resumo compactado do histórico de conversas para uma resposta, reduzindo o tamanho do contexto enquanto preserva informações essenciais. Retorna um objeto de resposta compactado.

#### Conversations

- [Criar uma conversa](https://docs.mka1.com/api-reference/conversations/criar-uma-conversa.md): Crie uma conversa para armazenar e recuperar o estado da conversa em chamadas da API de Resposta.
- [Listar conversas](https://docs.mka1.com/api-reference/conversations/listar-conversas.md): Liste todas as conversas do usuário autenticado com suporte a paginação.
- [Recuperar uma conversa](https://docs.mka1.com/api-reference/conversations/recuperar-uma-conversa.md): Obtenha uma conversa pelo ID.
- [Atualizar uma conversa](https://docs.mka1.com/api-reference/conversations/atualizar-uma-conversa.md): Atualizar os metadados de uma conversa.
- [Excluir uma conversa](https://docs.mka1.com/api-reference/conversations/excluir-uma-conversa.md): Excluir uma conversa. Itens na conversa não serão excluídos.
- [Listar itens de conversa](https://docs.mka1.com/api-reference/conversations/listar-itens-de-conversa.md): Liste todos os itens para uma conversa com o ID fornecido.
- [Criar itens de conversa](https://docs.mka1.com/api-reference/conversations/criar-itens-de-conversa.md): Crie itens em uma conversa com o ID fornecido.
- [Excluir vários itens de conversa](https://docs.mka1.com/api-reference/conversations/excluir-vários-itens-de-conversa.md): Excluir múltiplos itens de uma conversa com o ID fornecido.
- [Recuperar um item de conversa](https://docs.mka1.com/api-reference/conversations/recuperar-um-item-de-conversa.md): Obtenha um único item de uma conversa com os IDs fornecidos.
- [Excluir um item de conversa](https://docs.mka1.com/api-reference/conversations/excluir-um-item-de-conversa.md): Excluir um item de uma conversa com o ID fornecido.

### Models and routing

#### Models

- [Listar modelos disponíveis](https://docs.mka1.com/api-reference/models/listar-modelos-disponíveis.md): Lista os modelos disponíveis atualmente. Fornece informações básicas sobre cada modelo, incluindo seu ID e proprietário.
- [Recuperar um modelo](https://docs.mka1.com/api-reference/models/recuperar-um-modelo.md): Recupera uma instância de modelo, fornecendo informações básicas sobre o modelo, como o proprietário e as capacidades suportadas.
- [Liste o catálogo de modelos da organização](https://docs.mka1.com/api-reference/models/liste-o-catálogo-de-modelos-da-organização.md): Lista todas as definições de BYO, serviço e acesso ao cluster com estado de ativação, bloqueador, integridade e prévia de preço.
- [Defina um modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/defina-um-modelo-de-catálogo-byo.md): Cria uma definição BYO de propriedade da API sem ativar seu nome.
- [Atualizar um modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/atualizar-um-modelo-de-catálogo-byo.md): Atualiza uma definição BYO de propriedade da API; entradas de origem yaml são gerenciadas por arquivo e imutáveis por meio desta API.
- [Remover um modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/remover-um-modelo-de-catálogo-byo.md): Revoga uma definição BYO e a desativa apenas quando o nome ativo é originado dessa linhagem BYO.
- [Verifique a integridade de um modelo de catálogo BYO](https://docs.mka1.com/api-reference/models/verifique-a-integridade-de-um-modelo-de-catálogo-byo.md): Investiga uma definição BYO disponível, esteja ela ativa ou não.
- [Liste o acesso ao modelo de cluster de uma organização](https://docs.mka1.com/api-reference/models/liste-o-acesso-ao-modelo-de-cluster-de-uma-organização.md): Visão do operador do cluster dos catálogos de cluster disponíveis de uma organização e seu estado de ativação.
- [Adicionar acesso ao modelo de cluster para uma organização](https://docs.mka1.com/api-reference/models/adicionar-acesso-ao-modelo-de-cluster-para-uma-organização.md): Adiciona disponibilidade de forma idempotente sem revogar nenhum nome de modelo. Defina activate como true para também ativar todos os modelos solicitados da fonte do cluster na organização de destino. Concessões e ativações são atômicas por solicitação; um nome ativo de outra fonte retorna 409 sem…
- [Substituir o acesso ao modelo de cluster de uma organização](https://docs.mka1.com/api-reference/models/substituir-o-acesso-ao-modelo-de-cluster-de-uma-organização.md): Substituição completa serializável; os nomes de clusters ativos revogados são desativados e suas linhas de preço da organização são encerradas.
- [Listar organizações com acesso a um modelo de cluster](https://docs.mka1.com/api-reference/models/listar-organizações-com-acesso-a-um-modelo-de-cluster.md): Consulta reversa do operador de cluster mostrando disponibilidade e ativação para um ID de catálogo de um cluster.
- [Liste o registro de modelos ativo da organização](https://docs.mka1.com/api-reference/models/liste-o-registro-de-modelos-ativo-da-organização.md): Visão única de gerenciamento de cada nome ativo com definição qualificada pela origem, saúde, preço e detalhes de auditoria de ativação.
- [Ativar uma entrada do catálogo](https://docs.mka1.com/api-reference/models/ativar-uma-entrada-do-catálogo.md): Reivindica um nome de modelo de uma fonte de catálogo. A reativação da mesma fonte é idempotente; um detentor diferente retorna 409.
- [Desativar um nome de registro de modelo](https://docs.mka1.com/api-reference/models/desativar-um-nome-de-registro-de-modelo.md): Remove de forma idempotente o nome ativo e encerra suas linhas de preço no escopo da organização sem tocar na definição do catálogo.
- [Liste as substituições de modelo automático desta organização.](https://docs.mka1.com/api-reference/models/liste-as-substituições-de-modelo-automático-desta-organização.md): Retorna todos os pontos finais para os quais esta organização definiu seu próprio alvo `"auto"`. Pontos finais não listados recaem nos padrões YAML do operador.
- [Defina a política automática desta organização para um endpoint](https://docs.mka1.com/api-reference/models/defina-a-política-automática-desta-organização-para-um-endpoint.md): Armazena o alias direto existente `{ endpoint → model_id }` ou uma política de juiz com modelos candidatos. O roteamento por juiz é suportado para respostas, conclusões, transcrições e TTS. Todos os modelos configurados devem estar ativos no momento da gravação; candidatos revogados são filtrados no…
- [Clear this org's auto-model override for an endpoint](https://docs.mka1.com/api-reference/models/clear-this-orgs-auto-model-override-for-an-endpoint.md): Remove a substituição por org para o endpoint. As solicitações subsequentes `model: "auto"` passam a utilizar o padrão YAML do operador novamente.
- [Obtenha a moeda do cluster](https://docs.mka1.com/api-reference/models/obtenha-a-moeda-do-cluster.md): Retorna o código de moeda ISO-4217 para todo o cluster (nulo se não estiver definido).
- [Defina a moeda do cluster](https://docs.mka1.com/api-reference/models/defina-a-moeda-do-cluster.md): Define a moeda para todo o cluster. Alterá-la não converte automaticamente os preços existentes.
- [Listar preços do modelo padrão de cluster](https://docs.mka1.com/api-reference/models/listar-preços-do-modelo-padrão-de-cluster.md): Sem `model`, lista o preço padrão atual de cada modelo. Com `model`, retorna o histórico completo datado daquele modelo.
- [Definir um preço de modelo padrão do cluster](https://docs.mka1.com/api-reference/models/definir-um-preço-de-modelo-padrão-do-cluster.md): Atualiza o preço padrão do cluster para um modelo como uma nova versão datada. `rates` é um mapa flexível de métrica→taxa; métricas omitidas não são cobradas.
- [Limpar o preço do modelo cluster-default](https://docs.mka1.com/api-reference/models/limpar-o-preço-do-modelo-cluster-default.md): Encerra o preço padrão do cluster. A linhagem ativa do cluster então usa uma substituição da organização ou passa a não ter preço ($0).
- [Liste as substituições de preço de uma organização](https://docs.mka1.com/api-reference/models/liste-as-substituições-de-preço-de-uma-organização.md): Sem `model`, lista as substituições atuais da organização. Com `model`, retorna o histórico datado dessa substituição.
- [Defina uma superação de preço da organização](https://docs.mka1.com/api-reference/models/defina-uma-superação-de-preço-da-organização.md): Faz upsert de um preço datado por organização. A linhagem do cluster recai para o padrão do cluster; a linhagem BYO e de serving fica sem preço quando não existe uma linha da organização.
- [Limpar uma sobreposição de preço da organização](https://docs.mka1.com/api-reference/models/limpar-uma-sobreposição-de-preço-da-organização.md): Fecha um preço por organização. Somente a linhagem de cluster ativa pode então recorrer ao padrão do cluster.
- [Liste os preços efetivos dos modelos do chamador](https://docs.mka1.com/api-reference/models/liste-os-preços-efetivos-dos-modelos-do-chamador.md): Para cada modelo ativo, retorna seu preço com reconhecimento do registro: uma linha da organização, um padrão do cluster para a linhagem do cluster, ou sem preço ($0). Também lista o alias de roteamento `auto`, precificado pelo máximo por métrica em todos os modelos pelos quais ele pode ser cobrado…

#### Embeddings

- [Listar modelos de embedding disponíveis](https://docs.mka1.com/api-reference/embeddings/listar-modelos-de-embedding-disponíveis.md): Retorna uma lista de modelos de embedding disponíveis com seus limites. Use este endpoint para descobrir quais modelos estão disponíveis e suas restrições (tamanho do lote, comprimento de entrada) antes de fazer solicitações de embedding.
- [Criar embeddings de texto](https://docs.mka1.com/api-reference/embeddings/criar-embeddings-de-texto.md): Gera embeddings vetoriais para entradas de texto únicas ou múltiplas. Retorna vetores em ponto flutuante juntamente com estatísticas de uso de token.

#### Text Classification

- [Classificar texto em categorias pré-definidas](https://docs.mka1.com/api-reference/text-classification/classificar-texto-em-categorias-pré-definidas.md): Classifica o conteúdo do texto em uma das etiquetas pré-definidas fornecidas.

### Images and audio

#### Images

- [Gerar imagens a partir de descrições em texto](https://docs.mka1.com/api-reference/images/gerar-imagens-a-partir-de-descrições-em-texto.md): Cria imagens geradas por IA a partir de descrições em texto.

#### Speech

- [Transcrição de fala para texto](https://docs.mka1.com/api-reference/speech/transcrição-de-fala-para-texto.md): Converta áudio em texto usando reconhecimento de fala avançado.
- [Texto para fala](https://docs.mka1.com/api-reference/speech/texto-para-fala.md): Converter texto em fala com detecção automática de idioma.
- [Texto de streaming para fala](https://docs.mka1.com/api-reference/speech/texto-de-streaming-para-fala.md): Converter texto em fala com entrega de áudio em streaming em tempo real.
- [Gerar token de sala LiveKit](https://docs.mka1.com/api-reference/speech/gerar-token-de-sala-livekit.md): Gera um token de acesso LiveKit para entrar em uma sala de voz em tempo real. O token inclui credenciais criptografadas e configuração de modelo para o agente de voz.
- [Lista do histórico de texto para fala](https://docs.mka1.com/api-reference/speech/lista-do-histórico-de-texto-para-fala.md): Liste as gerações de texto para fala armazenadas para o usuário autenticado, do mais recente para o mais antigo por padrão.
- [Recuperar item do histórico de texto para fala](https://docs.mka1.com/api-reference/speech/recuperar-item-do-histórico-de-texto-para-fala.md): Retorna metadados para uma geração de texto para fala armazenada.
- [Excluir item do histórico de texto para fala](https://docs.mka1.com/api-reference/speech/excluir-item-do-histórico-de-texto-para-fala.md): Exclui uma geração de texto para fala armazenada. O blob de áudio é endereçado por conteúdo e pode ser compartilhado, por isso fica armazenado.
- [Recuperar áudio de texto para fala](https://docs.mka1.com/api-reference/speech/recuperar-áudio-de-texto-para-fala.md): Retorna o áudio armazenado para uma geração de texto para fala como uma resposta binária.
- [Listar histórico de fala para texto](https://docs.mka1.com/api-reference/speech/listar-histórico-de-fala-para-texto.md): Liste as transcrições armazenadas para o usuário autenticado, sendo as mais recentes aparecendo primeiro por padrão.
- [Recuperar item de histórico de conversão de fala para texto](https://docs.mka1.com/api-reference/speech/recuperar-item-de-histórico-de-conversão-de-fala-para-texto.md): Retorna metadados para uma transcrição armazenada.
- [Excluir item do histórico de reconhecimento de voz](https://docs.mka1.com/api-reference/speech/excluir-item-do-histórico-de-reconhecimento-de-voz.md): Excluir uma transcrição armazenada. O blob de áudio é endereçado por conteúdo e pode ser compartilhado, portanto, é mantido no armazenamento.
- [Recuperar áudio de fala para texto](https://docs.mka1.com/api-reference/speech/recuperar-áudio-de-fala-para-texto.md): Retorna o áudio de entrada armazenado para uma transcrição como uma resposta binária.

### Files and retrieval

#### Files

- [Carregar arquivo](https://docs.mka1.com/api-reference/files/carregar-arquivo.md): Faça o upload de um arquivo que pode ser usado com Assistentes, Armazenamentos de Vetores e outros recursos. Os arquivos são enviados para o S3 para armazenamento durável.
- [Listar arquivos](https://docs.mka1.com/api-reference/files/listar-arquivos.md): Retorna uma lista de arquivos que foram enviados.
- [Recuperar arquivo](https://docs.mka1.com/api-reference/files/recuperar-arquivo.md): Retorna informações sobre um arquivo específico.
- [Excluir arquivo](https://docs.mka1.com/api-reference/files/excluir-arquivo.md): Exclui um arquivo do armazenamento. Primeiro, o arquivo é removido de todos os armazenamentos vetoriais aos quais está associado, incluindo os embeddings, para que ele não apareça mais nos resultados de busca do armazenamento vetorial ou de `file_search`. Se isso não puder ser concluído, o arquivo é…
- [Recuperar conteúdo do arquivo](https://docs.mka1.com/api-reference/files/recuperar-conteúdo-do-arquivo.md): Retorna o conteúdo binário bruto do arquivo especificado com o cabeçalho Content-Type apropriado.

#### Vector Stores

- [Criar um armazenamento de vetores](https://docs.mka1.com/api-reference/vector-stores/criar-um-armazenamento-de-vetores.md): Cria um novo repositório de vetores para armazenar e pesquisar através de embeddings de documentos.
- [Listar armazéns de vetores](https://docs.mka1.com/api-reference/vector-stores/listar-armazéns-de-vetores.md): Recupera uma lista paginada de todos os armazenamentos de vetores para o usuário autenticado.
- [Recuperar um repositório de vetores](https://docs.mka1.com/api-reference/vector-stores/recuperar-um-repositório-de-vetores.md): Recupera um armazenamento vetorial pelo seu ID. Retorna 410 quando o armazenamento vetorial tiver expirado.
- [Modificar um repositório de vetores](https://docs.mka1.com/api-reference/vector-stores/modificar-um-repositório-de-vetores.md): Atualiza as propriedades de um armazenamento vetorial existente. Retorna 410 quando o armazenamento vetorial tiver expirado.
- [Excluir um armazenamento de vetor](https://docs.mka1.com/api-reference/vector-stores/excluir-um-armazenamento-de-vetor.md): Exclui permanentemente um repositório de vetores e suas respectivas incorporações.
- [Pesquisar um armazenamento de vetores](https://docs.mka1.com/api-reference/vector-stores/pesquisar-um-armazenamento-de-vetores.md): Realiza uma busca semântica em um armazenamento vetorial para encontrar os trechos de documento mais relevantes para uma consulta. Retorna 410 assim que o armazenamento vetorial tiver expirado.
- [Adicionar um arquivo a um repositório de vetores](https://docs.mka1.com/api-reference/vector-stores/adicionar-um-arquivo-a-um-repositório-de-vetores.md): Adiciona um arquivo a um armazenamento vetorial para indexação de busca semântica. Retorna 410 assim que o armazenamento vetorial expirar.
- [Listar arquivos em um armazenamento vetorial](https://docs.mka1.com/api-reference/vector-stores/listar-arquivos-em-um-armazenamento-vetorial.md): Recupera uma lista paginada de todos os arquivos em um armazenamento vetorial específico. Retorna 410 quando o armazenamento vetorial tiver expirado.
- [Recuperar um arquivo de loja de vetores](https://docs.mka1.com/api-reference/vector-stores/recuperar-um-arquivo-de-loja-de-vetores.md): Recupera informações detalhadas sobre um arquivo específico dentro de um armazenamento vetorial. Retorna 410 quando o armazenamento vetorial tiver expirado.
- [Atualizar atributos de arquivo](https://docs.mka1.com/api-reference/vector-stores/atualizar-atributos-de-arquivo.md): Atualiza os atributos de metadados associados a um arquivo dentro de um repositório vetorial. Retorna 410 quando o repositório vetorial tiver expirado.
- [Remover arquivo do armazenamento de vetores](https://docs.mka1.com/api-reference/vector-stores/remover-arquivo-do-armazenamento-de-vetores.md): Remove um arquivo de um armazenamento vetorial e exclui os embeddings associados a ele. Se o arquivo não estiver mais anexado, mas o armazenamento vetorial ainda mantiver embeddings para ele (por exemplo, deixados por uma exclusão anterior do arquivo), esses embeddings são excluídos e a solicitação…
- [Recuperar conteúdo do arquivo analisado](https://docs.mka1.com/api-reference/vector-stores/recuperar-conteúdo-do-arquivo-analisado.md): Recupera o conteúdo completo analisado de um arquivo dentro de um armazenamento vetorial. Retorna 410 assim que o armazenamento vetorial tiver expirado.
- [Adicionar múltiplos arquivos em lote ao armazenamento vetorial](https://docs.mka1.com/api-reference/vector-stores/adicionar-múltiplos-arquivos-em-lote-ao-armazenamento-vetorial.md): Adiciona vários arquivos a um armazenamento vetorial em uma única operação em lote. Retorna 410 quando o armazenamento vetorial tiver expirado.
- [Recuperar status de lote de arquivo](https://docs.mka1.com/api-reference/vector-stores/recuperar-status-de-lote-de-arquivo.md): Recupera o status de uma operação específica de lote de arquivos dentro de um armazenamento vetorial. Retorna 410 assim que o armazenamento vetorial tiver expirado.
- [Cancelar o processamento do arquivo em lote](https://docs.mka1.com/api-reference/vector-stores/cancelar-o-processamento-do-arquivo-em-lote.md): Cancela uma operação de lote de arquivos em andamento. Retorna 410 quando o armazenamento vetorial tiver expirado.
- [Listar arquivos em um lote](https://docs.mka1.com/api-reference/vector-stores/listar-arquivos-em-um-lote.md): Recupera uma lista paginada de todos os arquivos dentro de uma operação de lote específica. Retorna 410 quando o armazenamento vetorial tiver expirado.

### Agents

#### Agents

- [Listar agentes](https://docs.mka1.com/api-reference/agents/listar-agentes.md)
- [Criar um agente](https://docs.mka1.com/api-reference/agents/criar-um-agente.md)
- [Recuperar um agente](https://docs.mka1.com/api-reference/agents/recuperar-um-agente.md)
- [Atualizar um agente](https://docs.mka1.com/api-reference/agents/atualizar-um-agente.md)
- [Excluir um agente](https://docs.mka1.com/api-reference/agents/excluir-um-agente.md)

#### Agent Versions

- [Listar versões do agente](https://docs.mka1.com/api-reference/agent-versions/listar-versões-do-agente.md): Lista o histórico de configuração de um agente. Cada alteração confirmada (criação, atualização, reversão) adiciona uma versão.
- [Recuperar uma versão do agente](https://docs.mka1.com/api-reference/agent-versions/recuperar-uma-versão-do-agente.md)
- [Reverter um agente para uma versão](https://docs.mka1.com/api-reference/agent-versions/reverter-um-agente-para-uma-versão.md): Restaura a configuração da versão de destino como uma nova versão atual. O histórico é preservado: a restauração é adicionada como uma nova versão em vez de excluir as versões posteriores.

#### Agent Runs

- [Lista de execuções para um agente](https://docs.mka1.com/api-reference/agent-runs/lista-de-execuções-para-um-agente.md)
- [Iniciar uma execução de agente salva](https://docs.mka1.com/api-reference/agent-runs/iniciar-uma-execução-de-agente-salva.md): Inicia uma execução assíncrona em segundo plano para um agente salvo e retorna o registro da execução enfileirada. Use o ponto de extremidade de recuperação de execução para consultar o status ou o ponto de extremidade de eventos para transmitir o progresso.
- [Eventos de execução do agente de streaming](https://docs.mka1.com/api-reference/agent-runs/eventos-de-execução-do-agente-de-streaming.md): Transmitir Eventos Enviados pelo Servidor para a resposta do gateway vinculada a esta execução de agente. Execuções de terminal emitem um único evento de terminal e encerram.
- [Acorde um agente adormecido execute](https://docs.mka1.com/api-reference/agent-runs/acorde-um-agente-adormecido-execute.md): Interrompe uma chamada de ferramenta de sono curto em uma execução em segundo plano, encaminhando a entrada de acompanhamento para a resposta do gateway.
- [Aprovar ou negar uma chamada de ferramenta MCP pendente](https://docs.mka1.com/api-reference/agent-runs/aprovar-ou-negar-uma-chamada-de-ferramenta-mcp-pendente.md): Cria uma execução de continuação para uma mcp_approval_request emitida pela execução de origem. O gateway vincula a decisão de uso único ao servidor, ferramenta e argumentos originais; negar nunca invoca a ferramenta MCP remota.
- [Recuperar uma execução de agente](https://docs.mka1.com/api-reference/agent-runs/recuperar-uma-execução-de-agente.md)

#### Agent Connectors

- [Listar conectores para um agente](https://docs.mka1.com/api-reference/agent-connectors/listar-conectores-para-um-agente.md): Lista os conectores de canal de mensagens configurados para o agente. As credenciais do conector nunca são retornadas.
- [Criar um conector](https://docs.mka1.com/api-reference/agent-connectors/criar-um-conector.md): Conecta o agente a um bot do Telegram ou a um número de telefone do WhatsApp Business, valida as credenciais do provedor e registra o webhook do agente. O suporte ao conector do WhatsApp está em beta. Texto, fotos e documentos compatíveis com o gateway podem invocar o agente; mídia de entrada também…
- [Configure um webhook do aplicativo WhatsApp (Beta)](https://docs.mka1.com/api-reference/agent-connectors/configure-um-webhook-do-aplicativo-whatsapp-beta.md): Beta. Retorna a URL de callback em nível de aplicativo e o token de verificação que devem ser salvos na Meta antes que o primeiro conector de telefone do WhatsApp seja criado. O chamador deve ter permissão para gerenciar o agente. O token de verificação estável é retornado apenas nesta resposta sem…
- [Recuperar um conector](https://docs.mka1.com/api-reference/agent-connectors/recuperar-um-conector.md): Recupera a configuração e o status do conector sem expor credenciais.
- [Excluir um conector](https://docs.mka1.com/api-reference/agent-connectors/excluir-um-conector.md): Cancela o registro do webhook do provedor específico do conector e exclui as credenciais armazenadas do conector. As atualizações pendentes do Telegram são descartadas; a exclusão do WhatsApp limpa apenas o callback do número de telefone e não cancela a inscrição de outros números na conta comercial…
- [Ativar um conector](https://docs.mka1.com/api-reference/agent-connectors/ativar-um-conector.md): Revalida as credenciais de provedor armazenadas e registra o webhook do provedor. Use isso para tentar novamente um conector que ficou em estado de erro. É necessária autenticação por chave de API com todos os escopos listados; a autenticação por sessão é rejeitada, e a chave deve pertencer ao usuár…

#### Agent Schedules

- [Listar horários para um agente](https://docs.mka1.com/api-reference/agent-schedules/listar-horários-para-um-agente.md)
- [Criar um cronograma de agentes](https://docs.mka1.com/api-reference/agent-schedules/criar-um-cronograma-de-agentes.md): Cria um agendamento único, de intervalo ou cron com suporte temporal que inicia execuções normais de agentes salvos.
- [Recuperar um cronograma de agente](https://docs.mka1.com/api-reference/agent-schedules/recuperar-um-cronograma-de-agente.md)
- [Atualizar a programação de um agente](https://docs.mka1.com/api-reference/agent-schedules/atualizar-a-programação-de-um-agente.md)
- [Excluir um cronograma de agente](https://docs.mka1.com/api-reference/agent-schedules/excluir-um-cronograma-de-agente.md)
- [Pausar um agendamento de agente](https://docs.mka1.com/api-reference/agent-schedules/pausar-um-agendamento-de-agente.md)
- [Retomar a programação de um agente](https://docs.mka1.com/api-reference/agent-schedules/retomar-a-programação-de-um-agente.md)

#### Memory Stores

- [Criar loja de memória](https://docs.mka1.com/api-reference/memory-stores/criar-loja-de-memória.md): Cria um armazenamento de memória para anotações persistentes do agente. Os armazenamentos são privados por padrão e podem ser compartilhados entre o espaço de trabalho.
- [Lista de armazéns de memória](https://docs.mka1.com/api-reference/memory-stores/lista-de-armazéns-de-memória.md)
- [Recuperar armazenamento de memória](https://docs.mka1.com/api-reference/memory-stores/recuperar-armazenamento-de-memória.md)
- [Atualizar armazenamento de memória](https://docs.mka1.com/api-reference/memory-stores/atualizar-armazenamento-de-memória.md)
- [Excluir armazenamento de memória](https://docs.mka1.com/api-reference/memory-stores/excluir-armazenamento-de-memória.md)
- [Criar entrada de memória](https://docs.mka1.com/api-reference/memory-stores/criar-entrada-de-memória.md)
- [Listar entradas de memória](https://docs.mka1.com/api-reference/memory-stores/listar-entradas-de-memória.md)
- [Recuperar entrada de memória](https://docs.mka1.com/api-reference/memory-stores/recuperar-entrada-de-memória.md)
- [Atualizar entrada de memória](https://docs.mka1.com/api-reference/memory-stores/atualizar-entrada-de-memória.md)
- [Excluir entrada de memória](https://docs.mka1.com/api-reference/memory-stores/excluir-entrada-de-memória.md)

### Evals and feedback

#### Evals

- [Criar um conjunto de avaliações](https://docs.mka1.com/api-reference/evals/criar-um-conjunto-de-avaliações.md): Cria um conjunto de avaliação declarativo com escopo de equipe. Os arquivos de dataset e o avaliador em Python devem ser enviados separadamente com o propósito 'evals'.
- [Listar suítes de avaliação](https://docs.mka1.com/api-reference/evals/listar-suítes-de-avaliação.md): Retorna as suítes de avaliação visíveis para o contexto da equipe autenticada.
- [Obtenha um conjunto de avaliação](https://docs.mka1.com/api-reference/evals/obtenha-um-conjunto-de-avaliação.md): Recupera um conjunto de avaliação pelo ID.
- [Excluir um conjunto de avaliações](https://docs.mka1.com/api-reference/evals/excluir-um-conjunto-de-avaliações.md): Apaga suavemente uma suíte de avaliação e todas as suas execuções de avaliação, para que não apareçam mais nas leituras voltadas para o usuário.
- [Criar uma versão da suíte de avaliação](https://docs.mka1.com/api-reference/evals/criar-uma-versão-da-suíte-de-avaliação.md): Cria uma versão imutável da suíte. Use este endpoint para edições em uma suíte de avaliação existente.
- [Listar versões do suite de avaliação](https://docs.mka1.com/api-reference/evals/listar-versões-do-suite-de-avaliação.md): Retorna versões imutáveis para um conjunto de avaliação, incluindo o manifesto de cada versão.
- [Obtenha uma versão do conjunto de avaliação](https://docs.mka1.com/api-reference/evals/obtenha-uma-versão-do-conjunto-de-avaliação.md): Recupera uma versão imutável do conjunto de avaliação e seu manifesto.
- [Listar execuções da tabela de classificação para uma suíte de avaliação](https://docs.mka1.com/api-reference/evals/listar-execuções-da-tabela-de-classificação-para-uma-suíte-de-avaliação.md): Retorna, em uma única requisição, as execuções concluídas mais recentes de cada grupo de ranking para uma suíte, com as atribuições de grupo em `groups`. Um grupo é (modelo, tarefa alvo) para execuções com restrição de task_ids e (modelo) para execuções sem restrição (task_id nulo). Monte os boards…
- [Obtenha o ranking do agente de codificação para um conjunto de avaliação](https://docs.mka1.com/api-reference/evals/obtenha-o-ranking-do-agente-de-codificação-para-um-conjunto-de-avaliação.md): Classifica as execuções concluídas do agente de codificação da suíte, uma linha por (agente, modelo, esforço). Apenas execuções que registraram um `agent_name` participam — uma execução de QA ou de transcrição da mesma suíte não tem um agente para atribuir uma pontuação e não é uma linha do board. `…
- [Conte tokens do texto armazenado para as amostras não medidas de uma suíte](https://docs.mka1.com/api-reference/evals/conte-tokens-do-texto-armazenado-para-as-amostras-não-medidas-de-uma-suíte.md): Backfill para linhas gravadas antes de o gateway registrar o uso. Para amostras das execuções concluídas da suíte que têm texto de resposta ou raciocínio, mas nenhum valor de tokens, conta tokens de prompt, raciocínio e resposta a partir do texto armazenado (tiktoken o200k_base, um contador para cad…
- [Criar uma execução de avaliação](https://docs.mka1.com/api-reference/evals/criar-uma-execução-de-avaliação.md): Inicia uma execução de avaliação durável sobre a versão selecionada do conjunto, tarefas e modelos.
- [Listar execuções de avaliação](https://docs.mka1.com/api-reference/evals/listar-execuções-de-avaliação.md): Retorna execuções de avaliação visíveis ao contexto autenticado da equipe. suite_version é um ordinal por suíte e deve ser combinado com suite_id; fornecê-lo isoladamente retorna 400.
- [Obtenha uma execução de avaliação](https://docs.mka1.com/api-reference/evals/obtenha-uma-execução-de-avaliação.md): Recupera uma execução de avaliação pelo ID.
- [Excluir uma execução de avaliação](https://docs.mka1.com/api-reference/evals/excluir-uma-execução-de-avaliação.md): Soft-deleta uma execução de avaliação para que ela não apareça mais nas listas de execução, detalhes ou placares de pontuação.
- [Cancelar uma execução de avaliação](https://docs.mka1.com/api-reference/evals/cancelar-uma-execução-de-avaliação.md): Solicita o cancelamento de uma execução de avaliação em fila ou em andamento.
- [Reexecutar amostras de avaliação com falha](https://docs.mka1.com/api-reference/evals/reexecutar-amostras-de-avaliação-com-falha.md): Cola uma execução de avaliação concluída para re-tentar apenas amostras com o status 'falhou'. Amostras re-tentadas mantêm o mesmo ID de execução e IDs de amostra, substituindo os resultados de amostras com erro no lugar.
- [Tentar novamente uma execução de avaliação](https://docs.mka1.com/api-reference/evals/tentar-novamente-uma-execução-de-avaliação.md): Coloca uma execução de avaliação falhada ou cancelada na fila para tentar novamente. Amostras concluídas mantêm seus resultados, amostras canceladas geradas, mas não pontuadas, retomam na pontuação, amostras não finalizadas são reenviadas para a fila, e execuções sem amostras persistidas são prepara…
- [Obtenha uma visão geral de uma execução de avaliação](https://docs.mka1.com/api-reference/evals/obtenha-uma-visão-geral-de-uma-execução-de-avaliação.md): Cabeçalho agregado para a visualização das tentativas de uma execução: contagem de tentativas, recompensa média, custo e a divisão de tokens de entrada/saída/cached. Sua própria rota em vez de campos no objeto de execução, porque ela varre as amostras da execução — incorporar isso em `GET /evals/run…
- [Listar amostras de avaliação](https://docs.mka1.com/api-reference/evals/listar-amostras-de-avaliação.md): Retorna o prompt, o alvo, a saída do modelo, a extração, a pontuação e os detalhes do juiz para uma execução de avaliação.
- [Obter áudio de amostra de avaliação](https://docs.mka1.com/api-reference/evals/obter-áudio-de-amostra-de-avaliação.md): Retorna `{ object, audio, sample_index, task_id, model }` para uma única amostra de transcrição — a referência do clipe (uma URI `data:` em base64 ou uma URL) lida do `dataset_row` sem redaction (as respostas em lista ocultam blobs `data:` inline), além da tarefa/modelo resolvidos. Prioriza a `audio…
- [Obter uma trajetória de amostra de avaliação](https://docs.mka1.com/api-reference/evals/obter-uma-trajetória-de-amostra-de-avaliação.md): Retorna a sessão de uma tentativa de um agente de programação — os passos que o agente executou, literalmente no formato de intercâmbio do harness (veja `schema_version`, por exemplo, `ATIF-v1.7`). Deliberadamente não faz parte da lista de amostras: uma trajetória tem em média ~92 KB e essa lista pa…
- [Faça o upload de uma trajetória de amostra para avaliação](https://docs.mka1.com/api-reference/evals/faça-o-upload-de-uma-trajetória-de-amostra-para-avaliação.md): Armazena a sessão de um ensaio de agente de codificação, em qualquer formato de intercâmbio produzido pelo harness (registre isso em `schema_version`, por exemplo, `ATIF-v1.7`). `steps` é armazenado literalmente e nunca é validado, então uma mudança no formato do harness não exige uma nova versão do…
- [Obter artefatos de execução de avaliação](https://docs.mka1.com/api-reference/evals/obter-artefatos-de-execução-de-avaliação.md): Retorna os IDs de arquivos de artefato de amostra e resultados gerados para uma execução de avaliação concluída.
- [Importar uma execução concluída do agente de codificação](https://docs.mka1.com/api-reference/evals/importar-uma-execução-concluída-do-agente-de-codificação.md): Envia diretamente um job de harness concluído — a execução e suas tentativas —, de modo que os resultados nunca fazem round-trip pelo armazenamento externo, como acontece com o importador do Hugging Face. Todo `task_id` já deve existir no manifesto da versão do conjunto de destino; IDs desconhecidos…
- [Anexar execuções a uma execução aberta de agente de codificação](https://docs.mka1.com/api-reference/evals/anexar-execuções-a-uma-execução-aberta-de-agente-de-codificação.md): Adiciona trials concluídos a uma execução aberta com `finalize: false`, para que um job iniciado a partir de MKA1 possa ser acompanhado enquanto executa, em vez de aparecer completo do nada no final. Cada trial fixa seu próprio `sample_index` e faz upsert em (task, model, sample_index): um harness n…
- [Importar resultados históricos de avaliação do Hugging Face](https://docs.mka1.com/api-reference/evals/importar-resultados-históricos-de-avaliação-do-hugging-face.md): Importa amostras históricas simplificadas no estilo jsonl de resultados de avaliação de um repositório de dataset da Hugging Face para um formato de execução de suíte de avaliação concluída. Os agregados são recalculados a partir das amostras e incluem métricas de pontuação canônicas para placares.
- [Criar um cronograma de avaliação](https://docs.mka1.com/api-reference/evals/criar-um-cronograma-de-avaliação.md): Agenda uma execução de avaliação para ser acionada em uma cadência de cron ou intervalo, com notificações de webhook opcionais sobre o status da execução.
- [Liste os cronogramas de avaliação](https://docs.mka1.com/api-reference/evals/liste-os-cronogramas-de-avaliação.md): Retorna os cronogramas de avaliação visíveis para o contexto da equipe autenticada.
- [Obter um cronograma de avaliação](https://docs.mka1.com/api-reference/evals/obter-um-cronograma-de-avaliação.md): Recupera uma programação de avaliação por ID, incluindo o próximo horário de execução programado do Temporal quando possível.
- [Atualizar um cronograma de avaliação](https://docs.mka1.com/api-reference/evals/atualizar-um-cronograma-de-avaliação.md): Atualiza a cadência, configuração de execução, webhook, política de sobreposição ou estado habilitado de um cronograma de avaliação.
- [Excluir um cronograma de avaliação](https://docs.mka1.com/api-reference/evals/excluir-um-cronograma-de-avaliação.md): Realiza a exclusão suave de um cronograma de avaliação e remove seu cronograma Temporal. Execuções históricas são preservadas.
- [Acione um cronograma de avaliação agora](https://docs.mka1.com/api-reference/evals/acione-um-cronograma-de-avaliação-agora.md): Dispara o cronograma imediatamente, além de sua cadência normal.
- [Lista de execuções criadas por um cronograma de avaliação](https://docs.mka1.com/api-reference/evals/lista-de-execuções-criadas-por-um-cronograma-de-avaliação.md): Retorna execuções de avaliação que foram criadas pelo agendamento informado. suite_version pode ser usado aqui sem suite_id, já que o agendamento já fixa a suíte; informar um suite_id que não seja o do agendamento retorna 400.

#### Feedback

- [Envie feedback sobre a conclusão do chat](https://docs.mka1.com/api-reference/feedback/envie-feedback-sobre-a-conclusão-do-chat.md): Envie feedback do usuário para uma conclusão de chat específica para rastrear a satisfação e o desempenho do modelo. Cada conclusão pode receber feedback apenas uma vez.
- [Listar feedback de conclusão de chat](https://docs.mka1.com/api-reference/feedback/listar-feedback-de-conclusão-de-chat.md): Recupera uma lista paginada de entradas de feedback registradas nas conclusões de chat do solicitante, ordenadas pela data de criação da conclusão. Suporta filtragem por avaliação. Um cursor `after` que não resolve mais para uma conclusão visível ao solicitante retorna 400; reinicie a paginação a pa…
- [Recupere o feedback pelo ID de conclusão](https://docs.mka1.com/api-reference/feedback/recupere-o-feedback-pelo-id-de-conclusão.md): Recupera a classificação de feedback existente e a descrição para uma conclusão de chat específica.
- [Atualizar feedback de conclusão existente](https://docs.mka1.com/api-reference/feedback/atualizar-feedback-de-conclusão-existente.md): Atualiza ou modifica o feedback existente para uma conclusão de chat específica. Útil para permitir que os usuários revisem suas submissões iniciais.
- [Recuperação em lote de feedback para múltiplas conclusões](https://docs.mka1.com/api-reference/feedback/recuperação-em-lote-de-feedback-para-múltiplas-conclusões.md): Recupera feedback para múltiplas conclusões de chat em uma única solicitação em lote.
- [Enviar feedback para resposta](https://docs.mka1.com/api-reference/feedback/enviar-feedback-para-resposta.md): Envie feedback do usuário para uma resposta de agente específica para acompanhar a satisfação e o desempenho do modelo. Cada resposta pode receber feedback apenas uma vez.
- [Resposta de lista
](https://docs.mka1.com/api-reference/feedback/resposta-de-lista.md): Recupera uma lista paginada de entradas de feedback registradas nas respostas do agente do solicitante, ordenada pela data de criação da resposta. Suporta filtragem por avaliação. Um cursor `after` que não resolve mais para uma resposta visível ao solicitante — incluindo respostas que tenham sido ex…
- [Recuperar feedback pelo ID da resposta](https://docs.mka1.com/api-reference/feedback/recuperar-feedback-pelo-id-da-resposta.md): Recupera a avaliação de feedback existente e a descrição para uma resposta de agente específica.
- [Atualizar feedback de resposta existente](https://docs.mka1.com/api-reference/feedback/atualizar-feedback-de-resposta-existente.md): Atualiza ou modifica o feedback existente para uma resposta específica do agente. Útil para permitir que os usuários revisem suas submissões iniciais.
- [Recuperar feedback em lote para múltiplas respostas](https://docs.mka1.com/api-reference/feedback/recuperar-feedback-em-lote-para-múltiplas-respostas.md): Recupera feedback para múltiplas respostas de agentes em uma única solicitação em lote.
- [Exportar feedback de conclusão como CSV](https://docs.mka1.com/api-reference/feedback/exportar-feedback-de-conclusão-como-csv.md): Exporta de forma síncrona as entradas de feedback de conclusão visíveis ao solicitante como um arquivo CSV, ordenadas pela data de criação da solicitação subjacente. A visibilidade corresponde ao endpoint de listagem: solicitantes veem seu próprio feedback; proprietários da organização e administrad…
- [Exportar feedback da resposta como CSV](https://docs.mka1.com/api-reference/feedback/exportar-feedback-da-resposta-como-csv.md): Exporta sincronicamente as entradas de feedback de resposta visíveis ao chamador como um arquivo CSV, ordenadas pela data de criação da solicitação subjacente. A visibilidade corresponde ao endpoint de listagem: chamadores veem seu próprio feedback; proprietários da organização e administradores vee…
- [Iniciar exportação de feedback](https://docs.mka1.com/api-reference/feedback/iniciar-exportação-de-feedback.md): Inicia um job em segundo plano para exportar todos os dados de feedback de todos os tenants para arquivos parquet no S3/R2. Apenas uma exportação pode ser executada simultaneamente. Restrito a administradores do cluster.
- [Obter status de exportação de feedback](https://docs.mka1.com/api-reference/feedback/obter-status-de-exportação-de-feedback.md): Verifica o status e o progresso do trabalho de exportação de feedback em execução no momento ou concluído mais recentemente. Restrito a administradores do cluster.

### Compute

#### Compute Jobs

- [Listar trabalhos](https://docs.mka1.com/api-reference/compute-jobs/listar-trabalhos.md)
- [Criar uma vaga](https://docs.mka1.com/api-reference/compute-jobs/criar-uma-vaga.md)
- [Conseguir um emprego](https://docs.mka1.com/api-reference/compute-jobs/conseguir-um-emprego.md)
- [Listar eventos de trabalho](https://docs.mka1.com/api-reference/compute-jobs/listar-eventos-de-trabalho.md)
- [Listar instâncias de trabalhos observadas](https://docs.mka1.com/api-reference/compute-jobs/listar-instâncias-de-trabalhos-observadas.md)
- [Listar logs de trabalho](https://docs.mka1.com/api-reference/compute-jobs/listar-logs-de-trabalho.md)
- [Finalizar uma tarefa](https://docs.mka1.com/api-reference/compute-jobs/finalizar-uma-tarefa.md)

#### Compute Services

- [Listar serviços](https://docs.mka1.com/api-reference/compute-services/listar-serviços.md)
- [Criar um serviço](https://docs.mka1.com/api-reference/compute-services/criar-um-serviço.md)
- [Obter um serviço](https://docs.mka1.com/api-reference/compute-services/obter-um-serviço.md)
- [Listar eventos de serviço](https://docs.mka1.com/api-reference/compute-services/listar-eventos-de-serviço.md)
- [Lista de instâncias de serviço observadas](https://docs.mka1.com/api-reference/compute-services/lista-de-instâncias-de-serviço-observadas.md)
- [Listar logs de serviço](https://docs.mka1.com/api-reference/compute-services/listar-logs-de-serviço.md)
- [Substituir uma política de dimensionamento de serviço](https://docs.mka1.com/api-reference/compute-services/substituir-uma-política-de-dimensionamento-de-serviço.md)
- [Encerrar um serviço](https://docs.mka1.com/api-reference/compute-services/encerrar-um-serviço.md)

#### Compute Catalog

- [Lista de aceleradores](https://docs.mka1.com/api-reference/compute-catalog/lista-de-aceleradores.md)
- [Obtenha um acelerador](https://docs.mka1.com/api-reference/compute-catalog/obtenha-um-acelerador.md)
- [Listar ofertas de provedores](https://docs.mka1.com/api-reference/compute-catalog/listar-ofertas-de-provedores.md): Administradores de cluster podem sempre ler esta rota. Administradores da organização podem lê-la apenas quando o anonimato do provedor está desativado.
- [Listar saúde do provedor](https://docs.mka1.com/api-reference/compute-catalog/listar-saúde-do-provedor.md): Administradores de cluster podem sempre ler esta rota. Administradores da organização podem lê-la apenas quando o anonimato do provedor está desativado.
- [Criar uma cotação](https://docs.mka1.com/api-reference/compute-catalog/criar-uma-cotação.md)

#### Compute Secrets

- [Listar segredos](https://docs.mka1.com/api-reference/compute-secrets/listar-segredos.md)
- [Criar um segredo](https://docs.mka1.com/api-reference/compute-secrets/criar-um-segredo.md)
- [Excluir um segredo](https://docs.mka1.com/api-reference/compute-secrets/excluir-um-segredo.md)
- [Obter um segredo](https://docs.mka1.com/api-reference/compute-secrets/obter-um-segredo.md)

#### Compute Volumes

- [Listar volumes da organização](https://docs.mka1.com/api-reference/compute-volumes/listar-volumes-da-organização.md)
- [Crie um volume compartilhado independente](https://docs.mka1.com/api-reference/compute-volumes/crie-um-volume-compartilhado-independente.md)
- [Excluir permanentemente um volume independente](https://docs.mka1.com/api-reference/compute-volumes/excluir-permanentemente-um-volume-independente.md): A exclusão ignora a habilitação do tenant e as barreiras de orçamento, mas é recusada enquanto existirem anexos não terminais.
- [Obtenha um volume independente](https://docs.mka1.com/api-reference/compute-volumes/obtenha-um-volume-independente.md)
- [Listar anexos de volume](https://docs.mka1.com/api-reference/compute-volumes/listar-anexos-de-volume.md)

#### Compute Usage

- [Obter uso](https://docs.mka1.com/api-reference/compute-usage/obter-uso.md)

#### Compute Tenants

- [Listar inquilinos](https://docs.mka1.com/api-reference/compute-tenants/listar-inquilinos.md): Somente administrador do cluster.
- [Obter um locatário](https://docs.mka1.com/api-reference/compute-tenants/obter-um-locatário.md): Somente administrador do cluster.
- [Atualizar um inquilino](https://docs.mka1.com/api-reference/compute-tenants/atualizar-um-inquilino.md): Upsert idempotente apenas para administrador do cluster.

#### Compute Pricing

- [Obtenha o preço de armazenamento contratado mais recente](https://docs.mka1.com/api-reference/compute-pricing/obtenha-o-preço-de-armazenamento-contratado-mais-recente.md): A versão mais recente pode estar agendada para a próxima hora UTC. Antes de a primeira versão ser gravada, esta rota retorna pricing_not_configured.
- [Criar uma versão imutável do preço de armazenamento](https://docs.mka1.com/api-reference/compute-pricing/criar-uma-versão-imutável-do-preço-de-armazenamento.md): Somente administradores do cluster. If-Match: 0 executa o bootstrap explícito. Cada versão é ativada no próximo limite de hora UTC; a repetição idempotente equivalente precede a comparação de versões.

#### Tracking Experiments

- [Criar](https://docs.mka1.com/api-reference/tracking-experiments/criar.md): Crie um experimento com namespace. As localizações dos artefatos são gerenciadas pelo serviço. Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Buscar](https://docs.mka1.com/api-reference/tracking-experiments/buscar.md): Requer `read:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Obter](https://docs.mka1.com/api-reference/tracking-experiments/obter.md): Requer `read:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [ObterPorNome](https://docs.mka1.com/api-reference/tracking-experiments/obterpornome.md): Requer `read:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Excluir](https://docs.mka1.com/api-reference/tracking-experiments/excluir.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.

#### Tracking Runs

- [Criar](https://docs.mka1.com/api-reference/tracking-runs/criar.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Obter](https://docs.mka1.com/api-reference/tracking-runs/obter.md): Requer `read:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Buscar](https://docs.mka1.com/api-reference/tracking-runs/buscar.md): IDs de experimento explícitos são necessários; cada experimento deve pertencer ao chamador. Requer `read:tracking`. Os resultados são restritos à organização e equipe da chave de API.
- [Atualização](https://docs.mka1.com/api-reference/tracking-runs/atualização.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Excluir](https://docs.mka1.com/api-reference/tracking-runs/excluir.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Restaurar](https://docs.mka1.com/api-reference/tracking-runs/restaurar.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [LogMetric](https://docs.mka1.com/api-reference/tracking-runs/logmetric.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [Parâmetro de log](https://docs.mka1.com/api-reference/tracking-runs/parâmetro-de-log.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [DefinirTag](https://docs.mka1.com/api-reference/tracking-runs/definirtag.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [ExcluirTag](https://docs.mka1.com/api-reference/tracking-runs/excluirtag.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [LogBatch](https://docs.mka1.com/api-reference/tracking-runs/logbatch.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [LogInputs](https://docs.mka1.com/api-reference/tracking-runs/loginputs.md): Requer `write:tracking`. Os resultados são restritos à organização e à equipe da chave de API.
- [ObterHistóricoDeMétricas](https://docs.mka1.com/api-reference/tracking-runs/obterhistóricodemétricas.md): Requer `read:tracking`. Os resultados são restritos à organização e à equipe da chave de API.

### Repositories

#### Repositories

- [Liste os repositórios da organização do chamador](https://docs.mka1.com/api-reference/repositories/liste-os-repositórios-da-organização-do-chamador.md): Retorna todos os repositórios da organização do chamador (apenas para proprietário/admin da organização). Somente leitura. Com `kind`, apenas repositórios desse tipo; um repositório sem tipo (legado, `kind: null`) aparece na listagem sem filtro apenas.
- [Criar um repositório](https://docs.mka1.com/api-reference/repositories/criar-um-repositório.md): Provisiona um repositório (apenas proprietário/admin da organização); uma provisionamento com falha é revertido da melhor forma possível (veja o `502`). O repositório pertence à organização do chamador. `kind` indica o que ele conterá e, por padrão, é `repo` (um repositório git simples); ele decide…
- [Excluir um repositório](https://docs.mka1.com/api-reference/repositories/excluir-um-repositório.md): Remove um repositório; somente proprietário/admin da organização. A exclusão é autoritativa; o conteúdo é limpo da melhor forma possível.
- [Obter um repositório](https://docs.mka1.com/api-reference/repositories/obter-um-repositório.md): Lê um único repositório após a verificação de acesso por org+função (apenas proprietário/admin da org do repositório).
- [Atualizar os rótulos de um repositório](https://docs.mka1.com/api-reference/repositories/atualizar-os-rótulos-de-um-repositório.md): Aplica uma atualização somente de rótulo (nome/descrição/tipo); apenas proprietário/admin da organização. O ID do repositório é estável, então uma renomeação não afeta nenhum conteúdo. Os campos omitidos permanecem inalterados.

#### Image tags

- [Liste as tags de um repositório de imagens](https://docs.mka1.com/api-reference/repositories/liste-as-tags-de-um-repositório-de-imagens.md): Lista as tags de imagens de contêiner que um repositório contém, mais recentes movidas primeiro, cada uma com o manifesto ao qual aponta, o tipo de mídia do manifesto, o tamanho declarado da imagem e quando a tag foi movida pela última vez. A mesma verificação de acesso usada para ler o repositório…
- [Excluir uma tag de imagem](https://docs.mka1.com/api-reference/repositories/excluir-uma-tag-de-imagem.md): Remove uma tag; somente o proprietário/admin da organização (`write:repos` para uma chave). O mesmo desassociar da tag que o `DELETE /v2/{org}/{name}/manifests/{tag}` do registry: o nome desaparece e a imagem permanece, acessível pelo digest e por qualquer outra tag que a referencie.

### Dataset generations

#### Gerações

- [Lista de gerações](https://docs.mka1.com/api-reference/generations/lista-de-gerações.md)
- [Criar Geração](https://docs.mka1.com/api-reference/generations/criar-geração.md): A sequência components.md §6 D.1, em sua ordem: a credencial de execução é emitida antes que qualquer coisa seja gasta, nada é gravado antes que o digest seja fixado, e o fluxo de trabalho só começa após a confirmação da linha.
- [Obter geração](https://docs.mka1.com/api-reference/generations/obter-geração.md)
- [Obter Logs](https://docs.mka1.com/api-reference/generations/obter-logs.md)
- [Obter eventos](https://docs.mka1.com/api-reference/generations/obter-eventos.md)
- [Cancelar geração](https://docs.mka1.com/api-reference/generations/cancelar-geração.md): api.md §3: `cancelling` é escrito aqui, então o sinal; uma linha `cancelling` cujo sinal foi perdido (o caso de nova tentativa) é sinalizada novamente.

#### Geradores

- [Geradores de Lista](https://docs.mka1.com/api-reference/generators/geradores-de-lista.md)
- [Obter gerador](https://docs.mka1.com/api-reference/generators/obter-gerador.md)
- [Gerador de Citações](https://docs.mka1.com/api-reference/generators/gerador-de-citações.md)

#### Formatos

- [Formatos de Lista](https://docs.mka1.com/api-reference/formats/formatos-de-lista.md)
- [Obter formato](https://docs.mka1.com/api-reference/formats/obter-formato.md)

### Organizations and access

#### Organization

- [Crie uma equipe](https://docs.mka1.com/api-reference/organization/crie-uma-equipe.md)
- [Listar equipes em uma organização](https://docs.mka1.com/api-reference/organization/listar-equipes-em-uma-organização.md)
- [Monte uma equipe](https://docs.mka1.com/api-reference/organization/monte-uma-equipe.md)
- [Renomear uma equipe](https://docs.mka1.com/api-reference/organization/renomear-uma-equipe.md)
- [Excluir uma equipe](https://docs.mka1.com/api-reference/organization/excluir-uma-equipe.md)
- [Adicionar um membro da equipe](https://docs.mka1.com/api-reference/organization/adicionar-um-membro-da-equipe.md): Anexe um principal (usuário ou conta de serviço) à equipe pelo seu userId.
- [Lista de membros da equipe](https://docs.mka1.com/api-reference/organization/lista-de-membros-da-equipe.md)
- [Remover um membro da equipe](https://docs.mka1.com/api-reference/organization/remover-um-membro-da-equipe.md)
- [Criar uma conta de serviço](https://docs.mka1.com/api-reference/organization/criar-uma-conta-de-serviço.md): Crie um principal não humano com escopo para esta organização (apenas proprietário/administrador da organização).
- [Listar contas de serviço](https://docs.mka1.com/api-reference/organization/listar-contas-de-serviço.md)
- [Obtenha uma conta de serviço](https://docs.mka1.com/api-reference/organization/obtenha-uma-conta-de-serviço.md)
- [Excluir uma conta de serviço](https://docs.mka1.com/api-reference/organization/excluir-uma-conta-de-serviço.md)
- [Liste as chaves de API de uma conta de serviço](https://docs.mka1.com/api-reference/organization/liste-as-chaves-de-api-de-uma-conta-de-serviço.md)
- [Atualizar uma chave de API de conta de serviço](https://docs.mka1.com/api-reference/organization/atualizar-uma-chave-de-api-de-conta-de-serviço.md)
- [Excluir uma chave de API de conta de serviço](https://docs.mka1.com/api-reference/organization/excluir-uma-chave-de-api-de-conta-de-serviço.md)
- [Gire o segredo de uma chave de API de conta de serviço](https://docs.mka1.com/api-reference/organization/gire-o-segredo-de-uma-chave-de-api-de-conta-de-serviço.md)
- [Obter detalhes básicos da organização](https://docs.mka1.com/api-reference/organization/obter-detalhes-básicos-da-organização.md): Retorna os campos básicos e o objeto de metadados completo para um membro da organização ou um administrador do cluster. Nunca inclui identidades de membros, convites ou detalhes de chave de API.
- [Organizar metadados de patch (cluster-admin)](https://docs.mka1.com/api-reference/organization/organizar-metadados-de-patch-cluster-admin.md): Mescla as chaves de metadados de nível superior fornecidas, preservando os irmãos omitidos. metadata.codeConfig aceita um releaseManifestUrl; codeConfig:null remove essa substituição.
- [Obter a cota de uso de uma organização](https://docs.mka1.com/api-reference/organization/obter-a-cota-de-uso-de-uma-organização.md)
- [Definir a cota de uso de uma organização (cluster-admin)](https://docs.mka1.com/api-reference/organization/definir-a-cota-de-uso-de-uma-organização-cluster-admin.md)
- [Obtenha o limite de taxa de uma organização](https://docs.mka1.com/api-reference/organization/obtenha-o-limite-de-taxa-de-uma-organização.md)
- [Definir o limite de taxa de uma organização (cluster-admin)](https://docs.mka1.com/api-reference/organization/definir-o-limite-de-taxa-de-uma-organização-cluster-admin.md)

#### Cluster Admin

- [Criar um convite de cluster](https://docs.mka1.com/api-reference/cluster-admin/criar-um-convite-de-cluster.md): Emita um convite de uso único que provisiona uma nova organização na aceitação. Convites vinculados a e-mail podem ser aceitos sem interface (sem senha + issueApiKey).
- [Listar convites de cluster](https://docs.mka1.com/api-reference/cluster-admin/listar-convites-de-cluster.md)
- [Atualizar um convite de cluster pendente](https://docs.mka1.com/api-reference/cluster-admin/atualizar-um-convite-de-cluster-pendente.md): Estenda a expiração ou substitua atomicamente o available-model, a quota de API ou a política de computação de um convite não reivindicado e não expirado. Os campos de nível superior omitidos são preservados.
- [Revogar um convite de cluster](https://docs.mka1.com/api-reference/cluster-admin/revogar-um-convite-de-cluster.md)
- [Liste todas as organizações](https://docs.mka1.com/api-reference/cluster-admin/liste-todas-as-organizações.md)
- [Obter uma organização](https://docs.mka1.com/api-reference/cluster-admin/obter-uma-organização.md)
- [Excluir logicamente uma organização](https://docs.mka1.com/api-reference/cluster-admin/excluir-logicamente-uma-organização.md)
- [Convidar membros em nome de uma organização](https://docs.mka1.com/api-reference/cluster-admin/convidar-membros-em-nome-de-uma-organização.md): Requer uma sessão de cluster-admin com Cluster como sua organização ativa. O destino deve estar ativo e não pode ser Cluster. Envia até 20 convites de organização sem alternar a sessão do administrador nem ingressar na organização de destino. Cada linha aceita o papel member ou admin, com padrão mem…
- [Suspender uma organização](https://docs.mka1.com/api-reference/cluster-admin/suspender-uma-organização.md)
- [Suspender uma organização novamente](https://docs.mka1.com/api-reference/cluster-admin/suspender-uma-organização-novamente.md)
- [Reemitir uma chave do proprietário da organização (recuperação)](https://docs.mka1.com/api-reference/cluster-admin/reemitir-uma-chave-do-proprietário-da-organização-recuperação.md): Crie uma nova chave vinculada ao proprietário para uma organização cujo credencial foi perdido. Somente cluster-admin (`write:cluster`). Por padrão, usa o proprietário humano mais antigo da organização e o time mais antigo; `userId` / `teamId` substituem.
- [Ler informações do convite do cluster (público)](https://docs.mka1.com/api-reference/cluster-admin/ler-informações-do-convite-do-cluster-público.md)
- [Aceitar um convite de cluster (público)](https://docs.mka1.com/api-reference/cluster-admin/aceitar-um-convite-de-cluster-público.md): Aceite um convite e crie a organização. Usuário já autenticado, novo proprietário com e-mail/senha, ou proprietário de máquina headless vinculado a e-mail com `passwordless: true, issueApiKey: true`. Um slug reservado (`api`, seja fornecido como `orgSlug` ou derivado de `orgName`) é recusado com 400…

#### Resource Authorization

- [Criar um novo recurso](https://docs.mka1.com/api-reference/resource-authorization/criar-um-novo-recurso.md): Crie um recurso LLM e atribua ao chamador autenticado a propriedade. Proprietários existentes podem passar overwrite=true para substituir relacionamentos diretos para o recurso.
- [Excluir um recurso](https://docs.mka1.com/api-reference/resource-authorization/excluir-um-recurso.md): Exclua um recurso LLM e todas as suas permissões diretas. Somente os proprietários podem excluir recursos.
- [Conceder permissão a um usuário ou tornar público](https://docs.mka1.com/api-reference/resource-authorization/conceder-permissão-a-um-usuário-ou-tornar-público.md): Conceda uma função a um usuário para um recurso git, ou conceda acesso público usando "*" como userId. Somente proprietários podem conceder permissões. O acesso público é permitido apenas para as funções writer e reader.
- [Revogar permissão de um usuário ou remover acesso público](https://docs.mka1.com/api-reference/resource-authorization/revogar-permissão-de-um-usuário-ou-remover-acesso-público.md): Revogar uma função de um usuário para um recurso git, ou remover o acesso público usando "*" como userId. Somente os proprietários podem revogar permissões.
- [Liste os recursos aos quais o usuário tem acesso.](https://docs.mka1.com/api-reference/resource-authorization/liste-os-recursos-aos-quais-o-usuário-tem-acesso.md): Liste recursos de um tipo específico onde o chamador autenticado tem o papel especificado. Retorna apenas relacionamentos diretos (não computados).
- [Listar usuários com permissões](https://docs.mka1.com/api-reference/resource-authorization/listar-usuários-com-permissões.md): Liste usuários com um papel específico em um recurso. Retorna apenas relacionamentos diretos (não computados). O chamador autenticado deve ter pelo menos acesso de leitor.
- [Verificar permissão do usuário](https://docs.mka1.com/api-reference/resource-authorization/verificar-permissão-do-usuário.md): Verifique se o chamador autenticado possui um papel específico em um recurso.
- [Criar um novo recurso git](https://docs.mka1.com/api-reference/resource-authorization/criar-um-novo-recurso-git.md): Crie um recurso Git e atribua o chamador autenticado como proprietário. Proprietários existentes podem definir overwrite=true para substituir as relações diretas do recurso.
- [Excluir um recurso do git](https://docs.mka1.com/api-reference/resource-authorization/excluir-um-recurso-do-git.md): Excluir um recurso do git e todas as suas permissões diretas. მხოლოდ os proprietários podem excluir recursos.
- [Conceder permissão a um usuário ou tornar público](https://docs.mka1.com/api-reference/resource-authorization/conceder-permissão-a-um-usuário-ou-tornar-público.md): Conceda uma função a um usuário para um recurso git, ou conceda acesso público usando "*" como userId. Somente proprietários podem conceder permissões. O acesso público é permitido apenas para as funções writer e reader.
- [Revogar permissão de um usuário ou remover acesso público](https://docs.mka1.com/api-reference/resource-authorization/revogar-permissão-de-um-usuário-ou-remover-acesso-público.md): Revogar uma função de um usuário para um recurso git, ou remover o acesso público usando "*" como userId. Somente os proprietários podem revogar permissões.
- [Verifique uma permissão explícita do sujeito](https://docs.mka1.com/api-reference/resource-authorization/verifique-uma-permissão-explícita-do-sujeito.md): Verifique se um sujeito específico (fornecido no corpo) tem uma função em um recurso git. Usado pelo proxy de autorização para impor acesso para o usuário git em nome do qual ele está agindo. O chamador autenticado deve possuir o escopo de autorização de leitura; o sujeito é independente do chamador…

#### API Key

- [Crie uma chave de API com escopo](https://docs.mka1.com/api-reference/api-key/crie-uma-chave-de-api-com-escopo.md): Crie uma chave de API vinculada a um (principal, time) com um conjunto explícito de escopos. Requer uma sessão ou uma chave bearer com `write:apikeys`. O segredo em texto simples é retornado apenas uma vez.
- [Listar chaves de API com escopo](https://docs.mka1.com/api-reference/api-key/listar-chaves-de-api-com-escopo.md): Liste as chaves de API com escopo do chamador (somente metadados — nunca o segredo). Os parâmetros opcionais `?orgId=&teamId=` restringem a busca; uma chave chamadora está limitada à sua própria organização.
- [Atualizar uma chave de API limitada](https://docs.mka1.com/api-reference/api-key/atualizar-uma-chave-de-api-limitada.md): Atualize os escopos de uma chave (e, opcionalmente, o nome / limite de taxa). Os escopos já presentes na chave são mantidos; os novos escopos adicionados são limitados pela função do solicitante (e, no caso de um solicitante com chave, pelos próprios escopos da chave que está chamando).
- [Rotacionar o segredo de uma chave de API com escopo](https://docs.mka1.com/api-reference/api-key/rotacionar-o-segredo-de-uma-chave-de-api-com-escopo.md): Emita um novo segredo em texto simples para uma chave existente no mesmo local (id / escopos / vinculação preservados). Retornado uma vez.
- [Trocar a chave da API por um token JWT](https://docs.mka1.com/api-reference/api-key/trocar-a-chave-da-api-por-um-token-jwt.md): Troque uma chave de API por um token JWT
- [Trocar a chave da API por um token JWT](https://docs.mka1.com/api-reference/api-key/trocar-a-chave-da-api-por-um-token-jwt.md): Troque uma chave de API por um token JWT

#### Session

- [Encontre um convite inacabado para o destinatário autenticado](https://docs.mka1.com/api-reference/session/encontre-um-convite-inacabado-para-o-destinatário-autenticado.md): Requer uma sessão com um e-mail verificado. Retorna primeiro um convite de organização pendente e não expirado; caso contrário, um convite de cluster não reivindicado e não expirado vinculado a esse e-mail. Convites de cluster abertos nunca são retornados. Não aceita nem modifica o convite.
- [Trocar uma sessão ativa por um token de acesso delegado](https://docs.mka1.com/api-reference/session/trocar-uma-sessão-ativa-por-um-token-de-acesso-delegado.md): Emite um token de curta duração, restrito à audiência, com a mesma autoridade da sessão ativa atual do navegador ou do login no dispositivo. A identidade, a tenancy, as permissões e o tempo de vida não podem ser selecionados pelo chamador. O corpo JSON é limitado a 4 KiB.

### Application utilities

#### Batches

- [Criar um lote](https://docs.mka1.com/api-reference/batches/criar-um-lote.md): Cria e executa um lote a partir de um arquivo JSONL enviado contendo requisições. Cada linha deve ter os campos custom_id, method, url e body. Lotes de texto também exigem write:responses.
- [Listar lotes](https://docs.mka1.com/api-reference/batches/listar-lotes.md): Retorna uma lista paginada de lotes pertencentes ao usuário autenticado.
- [Obter um lote](https://docs.mka1.com/api-reference/batches/obter-um-lote.md): Recupera um lote pelo seu ID.
- [Cancelar um lote](https://docs.mka1.com/api-reference/batches/cancelar-um-lote.md): Cancela um lote em andamento. O status do lote muda para cancelando, e as solicitações restantes não serão processadas.

#### Extract

- [Extrair dados estruturados com JSON Schema embutido](https://docs.mka1.com/api-reference/extract/extrair-dados-estruturados-com-json-schema-embutido.md): Extrai dados estruturados de arquivos usando um esquema JSON inline personalizado.
- [Criar modelo de esquema de extração reutilizável](https://docs.mka1.com/api-reference/extract/criar-modelo-de-esquema-de-extração-reutilizável.md): Cria e armazena um modelo de esquema JSON reutilizável para extração de dados estruturados.
- [Obter esquema de extração por ID](https://docs.mka1.com/api-reference/extract/obter-esquema-de-extração-por-id.md): Recupere um esquema de extração armazenado e seus metadados.
- [Atualizar esquema de extração por ID](https://docs.mka1.com/api-reference/extract/atualizar-esquema-de-extração-por-id.md): Atualizar um esquema de extração existente e seus metadados.
- [Excluir o esquema de extração pelo ID](https://docs.mka1.com/api-reference/extract/excluir-o-esquema-de-extração-pelo-id.md): Remover um esquema de extração armazenado.
- [Extrair dados usando o modelo de esquema salvo](https://docs.mka1.com/api-reference/extract/extrair-dados-usando-o-modelo-de-esquema-salvo.md): Extrai dados estruturados de arquivos usando um modelo de esquema de extração previamente salvo.

#### Guardrails

- [Obtenha guardrails eficazes](https://docs.mka1.com/api-reference/guardrails/obtenha-guardrails-eficazes.md): Recupere as diretrizes de segurança que se aplicam às solicitações do chamador: a política abrangente da organização mais a política da equipe do chamador, combinadas. Ambas são aplicadas quando as duas existem. As políticas são gerenciadas pelos administradores da organização via PUT /guardrails.
- [Atualizar política de diretrizes](https://docs.mka1.com/api-reference/guardrails/atualizar-política-de-diretrizes.md): Substitua uma política de guardrails. Os modelos classificadores devem estar ativos e declarar suporte a saída estruturada; substitua o ID do modelo de exemplo por um modelo adequado da sua organização. Omita team_id para definir a política em toda a organização (somente admin da organização); forne…
- [Excluir política de diretrizes](https://docs.mka1.com/api-reference/guardrails/excluir-política-de-diretrizes.md): Excluir uma política de guardrails. Omitir team_id para excluir a política de toda a organização (somente admin da organização); fornecer team_id para excluir a política dessa equipe (admins da organização podem direcionar qualquer equipe em sua organização, outros chamadores apenas sua própria equi…
- [Listar políticas de guardrail](https://docs.mka1.com/api-reference/guardrails/listar-políticas-de-guardrail.md): Liste as políticas de guardrails armazenadas visíveis para o chamador: os administradores da organização veem todas as políticas em sua organização (a política abrangente da organização tem team_id nulo, além da política adicional de cada equipe); os demais chamadores veem a política abrangente da o…
- [Teste de conteúdo contra barreiras de proteção](https://docs.mka1.com/api-reference/guardrails/teste-de-conteúdo-contra-barreiras-de-proteção.md): Teste um trecho de conteúdo em relação às proteções efetivas do solicitante (política em toda a organização mais política da equipe) sem gerar uma resposta. As proteções do classificador chamam o modelo configurado e incidem em uso de inferência; as chaves de API também exigem write:responses e deve…

#### Prompts

- [Crie um prompt](https://docs.mka1.com/api-reference/prompts/crie-um-prompt.md): Cria um novo prompt com sua primeira versão. O modelo suporta espaços reservados {{variável}}.
- [Listar solicitações](https://docs.mka1.com/api-reference/prompts/listar-solicitações.md): Retorna uma lista paginada de prompts pertencentes ao usuário autenticado.
- [Obter um prompt](https://docs.mka1.com/api-reference/prompts/obter-um-prompt.md): Recupera um prompt pelo seu ID, incluindo o modelo ativo. Passe `version` para obter o modelo de uma versão específica. Passe `variables` como um mapa codificado em JSON para renderizar o modelo com substituições.
- [Atualizar um prompt](https://docs.mka1.com/api-reference/prompts/atualizar-um-prompt.md): Atualiza os metadados do prompt. Para atualizar o conteúdo do modelo, crie uma nova versão em vez disso.
- [Excluir um prompt](https://docs.mka1.com/api-reference/prompts/excluir-um-prompt.md): Remove um prompt e todas as suas versões.
- [Criar uma nova versão](https://docs.mka1.com/api-reference/prompts/criar-uma-nova-versão.md): Cria uma nova versão de um prompt. A nova versão automaticamente se torna a versão ativa. Os campos não fornecidos são mantidos da versão anterior.
- [Listar versões](https://docs.mka1.com/api-reference/prompts/listar-versões.md): Retorna o histórico de versões de um prompt, ordenado pelo número da versão.
- [Obter uma versão específica](https://docs.mka1.com/api-reference/prompts/obter-uma-versão-específica.md): Recupera uma versão específica de um prompt pelo número da versão.
- [Reverter para uma versão](https://docs.mka1.com/api-reference/prompts/reverter-para-uma-versão.md): Define a versão ativa de um prompt para uma versão anterior. Isso não exclui versões mais recentes — apenas altera qual versão está ativa.

### Analytics

#### Projetos

- [Create a project](https://docs.mka1.com/api-reference/analyticsprojects/criar-um-projeto-de-análise.md): Crie um projeto na organização do chamador. Sem team_id, o projeto pertence à equipe autenticada. Proprietários e administradores da organização podem criar um projeto para qualquer equipe em sua organização, incluindo equipes das quais não sejam membros, ou passar team_id: null para um projeto no n…
- [List projects](https://docs.mka1.com/api-reference/analyticsprojects/listar-projetos-de-análise-acessíveis.md): Proprietários e administradores da organização veem todos os projetos na sua organização: todos os projetos das equipes e os projetos no nível da organização, independentemente da equipe ativa. Isso também se aplica às chaves de API e aos JWTs trocados de um proprietário ou administrador, independen…
- [Get a project](https://docs.mka1.com/api-reference/analyticsprojects/obter-um-projeto-de-análise.md)
- [Update a project](https://docs.mka1.com/api-reference/analyticsprojects/renomear-um-projeto-de-análise-ativo.md): Renomeie um projeto ativo. A propriedade do projeto não pode ser alterada.
- [Archive a project](https://docs.mka1.com/api-reference/analyticsprojects/arquivar-um-projeto-de-análises.md): Interrompa novas capturas e consultas para este projeto. Eventos aceitos anteriormente continuam sendo processados. O arquivamento não exclui os eventos armazenados.

#### Chaves de captura

- [Create a capture key](https://docs.mka1.com/api-reference/analyticskeys/criar-uma-chave-de-captura-e-retornar-seu-segredo-uma-única-vez.md): Crie uma chave que possa enviar eventos para este projeto. Salve a chave desta resposta; o segredo dela é retornado apenas uma vez. Chaves de captura não podem ler analytics nem gerenciar projetos.
- [List capture keys](https://docs.mka1.com/api-reference/analyticskeys/listar-metadados-principais-de-captura.md)
- [Revoke a capture key](https://docs.mka1.com/api-reference/analyticskeys/revogar-uma-chave-de-captura.md)

#### Eventos

- [Capture events](https://docs.mka1.com/api-reference/analytics/aceitar-permanentemente-um-lote-de-eventos.md): Envie um lote de eventos usando o cabeçalho X-Analytics-Key do projeto. Uma resposta 202 confirma que o lote foi armazenado; os eventos ficam disponíveis para consultas após o processamento em segundo plano. Tente novamente com a mesma idempotency_key e os eventos inalterados se você não receber uma…
- [Query events](https://docs.mka1.com/api-reference/analytics/consultar-contagens-de-eventos-ou-visitantes-únicos.md): Conte eventos ou visitantes únicos em um intervalo de tempo. Opcionalmente, filtre por nome do evento ou propriedades, agrupe por uma propriedade e divida os resultados em intervalos de hora, dia ou semana que começam no horário de um fuso horário IANA, UTC por padrão. Cada intervalo é retornado com…

#### Busca de eventos

- [Search events](https://docs.mka1.com/api-reference/analyticsevents/pesquisar-eventos-em-um-intervalo-de-tempo.md): Liste eventos individuais em um intervalo de tempo, do mais recente para o mais antigo, com suas propriedades. Opcionalmente, filtre por nome do evento, propriedades do evento ou pelo distinct_id de um visitante. O intervalo inclui o valor inicial e exclui o final, e IDs de eventos duplicados são re…

#### Busca de visitantes

- [Search visitors](https://docs.mka1.com/api-reference/analyticsvisitors/pesquisar-visitantes-em-um-intervalo-de-tempo.md): Liste visitantes com eventos correspondentes em um intervalo de tempo, em ordem de atividade mais recente primeiro. Cada visitante é um distinct_id com os timestamps do primeiro e do último evento correspondente e a contagem de eventos ao longo de todo o intervalo; assim, para um intervalo que não r…

### Legacy APIs

#### Chat Completions

- [[Obsoleto] Conclusões de chat para uso do SDK/client da OpenAI](https://docs.mka1.com/api-reference/chat-completions/[obsoleto]-conclusões-de-chat-para-uso-do-sdkclient-da-openai.md): **Deprecado: Use a API de Respostas (`/api/v1/llm/responses`) em vez disso.** Endpoint de conclusão de chat compatível com OpenAI, projetado para uso com as bibliotecas cliente oficiais da OpenAI (Python, Node.js, etc.). Suporta tanto solicitações em streaming quanto não em streaming configurando o…
- [[Deprecado] Completações de chat por streaming para uso de SDK gerado](https://docs.mka1.com/api-reference/chat-completions/[deprecado]-completações-de-chat-por-streaming-para-uso-de-sdk-gerado.md): **Obsoleto: Use a API de Respostas (`/api/v1/llm/responses`) em vez disso.** Endpoint de conclusão de chat em streaming projetado para uso com o SDK gerado em TypeScript/JavaScript da especificação OpenAPI. Este endpoint utiliza streaming nativo do ORPC através de geradores assíncronos e retorna Eve…

#### Fine-Tuning

- [[Obsoleto] Criar um job de fine-tuning](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-criar-um-job-de-fine-tuning.md): **Obsoleto: use jobs de Compute (`/api/v1/compute/jobs`) em vez disso.** Cria um job de fine-tuning que inicia o processo de treinamento de um novo modelo a partir de um conjunto de dados fornecido.
- [[Descontinuado] Listar jobs de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[descontinuado]-listar-jobs-de-ajuste-fino.md): **Obsoleto: use trabalhos de computação (`/api/v1/compute/jobs`) em vez disso.** Liste os trabalhos de fine-tuning da sua organização.
- [[Obsoleto] Recuperar um trabalho de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-recuperar-um-trabalho-de-ajuste-fino.md): **Obsoleto: use trabalhos de computação (`/api/v1/compute/jobs`) em vez disso.** Obtenha informações sobre um trabalho de ajuste fino.
- [[Obsoleto] Cancelar um trabalho de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-cancelar-um-trabalho-de-ajuste-fino.md): **Obsoleto: use jobs de compute (`/api/v1/compute/jobs`) em vez disso.** Cancele imediatamente um job de fine-tuning.
- [[Obsoleto] Pausar um trabalho de fine-tuning](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-pausar-um-trabalho-de-fine-tuning.md): **Obsoleto: use jobs de computação (`/api/v1/compute/jobs`) em vez disso.** Pause um job de fine-tuning em execução.
- [[Obsoleto] Retomar um job de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-retomar-um-job-de-ajuste-fino.md): **Obsoleto: use jobs de Compute (`/api/v1/compute/jobs`) em vez disso.** Retome um job de fine-tuning pausado.
- [[Obsoleto] Listar eventos de fine-tuning](https://docs.mka1.com/api-reference/fine-tuning/[obsoleto]-listar-eventos-de-fine-tuning.md): **Obsoleto: use trabalhos de computação (`/api/v1/compute/jobs`) em vez disso.** Obtenha atualizações de status para um trabalho de ajuste fino.
- [[Depreciado] Listar checkpoints de ajuste fino](https://docs.mka1.com/api-reference/fine-tuning/[depreciado]-listar-checkpoints-de-ajuste-fino.md): **Obsoleto: use jobs de computação (`/api/v1/compute/jobs`) em vez disso.** Liste os checkpoints de um job de fine-tuning.

### Additional APIs

#### Billing

- [Get apiv1budgetingbillingorg](https://docs.mka1.com/api-reference/billing/get-apiv1budgetingbillingorg.md)
- [Put apiv1budgetingbillingorgenabled](https://docs.mka1.com/api-reference/billing/put-apiv1budgetingbillingorgenabled.md)
- [Put apiv1budgetingbillingorgprofile](https://docs.mka1.com/api-reference/billing/put-apiv1budgetingbillingorgprofile.md)
- [Post apiv1budgetingbillingorgsetup session](https://docs.mka1.com/api-reference/billing/post-apiv1budgetingbillingorgsetup-session.md)
- [Post apiv1budgetingbillingorgportal session](https://docs.mka1.com/api-reference/billing/post-apiv1budgetingbillingorgportal-session.md)
- [Get apiv1budgetingbillingorginvoices](https://docs.mka1.com/api-reference/billing/get-apiv1budgetingbillingorginvoices.md)

#### Feature Flags

- [Lista de sinalizadores](https://docs.mka1.com/api-reference/feature-flags/lista-de-sinalizadores.md): Cada flag com um resumo por ambiente do seu estado.
- [Criar uma bandeira](https://docs.mka1.com/api-reference/feature-flags/criar-uma-bandeira.md): A flag começa desativada em todos os ambientes e pertence ao Default quando project_id é omitido.
- [Listar projetos](https://docs.mka1.com/api-reference/feature-flags/listar-projetos.md)
- [Criar um projeto](https://docs.mka1.com/api-reference/feature-flags/criar-um-projeto.md)
- [Excluir um projeto vazio](https://docs.mka1.com/api-reference/feature-flags/excluir-um-projeto-vazio.md): O padrão não pode ser excluído. Mova ou exclua todas as bandeiras antes de excluir outro projeto.
- [Obter um projeto](https://docs.mka1.com/api-reference/feature-flags/obter-um-projeto.md)
- [Renomear um projeto](https://docs.mka1.com/api-reference/feature-flags/renomear-um-projeto.md)
- [Liste as entradas de auditoria, da mais recente para a mais antiga](https://docs.mka1.com/api-reference/feature-flags/liste-as-entradas-de-auditoria-da-mais-recente-para-a-mais-antiga.md)
- [Listar ambientes](https://docs.mka1.com/api-reference/feature-flags/listar-ambientes.md)
- [Criar um ambiente](https://docs.mka1.com/api-reference/feature-flags/criar-um-ambiente.md): Todos os sinalizadores existentes ganham um estado desativado no novo ambiente.
- [Excluir um ambiente e todas as configurações de sinalizador nele](https://docs.mka1.com/api-reference/feature-flags/excluir-um-ambiente-e-todas-as-configurações-de-sinalizador-nele.md)
- [Renomear um ambiente](https://docs.mka1.com/api-reference/feature-flags/renomear-um-ambiente.md)
- [Avalie cada sinalizador para uma identidade](https://docs.mka1.com/api-reference/feature-flags/avalie-cada-sinalizador-para-uma-identidade.md): Resolve todas as flags não arquivadas do ambiente para um chamador anônimo, ou para a identidade fornecida na consulta. Envia um ETag e responde 304 a um If-None-Match correspondente após autenticar a chave de avaliação do ambiente.
- [Avalie cada sinalizador para uma identidade com características](https://docs.mka1.com/api-reference/feature-flags/avalie-cada-sinalizador-para-uma-identidade-com-características.md)
- [Revogar uma chave de avaliação de ambiente](https://docs.mka1.com/api-reference/feature-flags/revogar-uma-chave-de-avaliação-de-ambiente.md): A revogação é idempotente enquanto o ambiente existir.
- [Gerar ou substituir uma chave de avaliação de ambiente](https://docs.mka1.com/api-reference/feature-flags/gerar-ou-substituir-uma-chave-de-avaliação-de-ambiente.md): Retorna a nova chave em texto simples apenas uma vez. Apenas seu digest SHA-256 e uma dica de exibição são armazenados; gerar outra chave substitui imediatamente a credencial anterior nesta réplica.
- [Excluir um sinalizador e suas configurações em todos os ambientes](https://docs.mka1.com/api-reference/feature-flags/excluir-um-sinalizador-e-suas-configurações-em-todos-os-ambientes.md)
- [Obtenha uma bandeira](https://docs.mka1.com/api-reference/feature-flags/obtenha-uma-bandeira.md)
- [Atualize o nome, a descrição, o valor padrão ou o projeto de um flag](https://docs.mka1.com/api-reference/feature-flags/atualize-o-nome-a-descrição-o-valor-padrão-ou-o-projeto-de-um-flag.md)
- [Arquivar uma sinalização](https://docs.mka1.com/api-reference/feature-flags/arquivar-uma-sinalização.md): Flags arquivadas são excluídas da avaliação em todos os ambientes; suas configurações são mantidas.
- [Substituir as configurações de uma flag em um ambiente](https://docs.mka1.com/api-reference/feature-flags/substituir-as-configurações-de-uma-flag-em-um-ambiente.md)
- [Restaurar uma bandeira arquivada](https://docs.mka1.com/api-reference/feature-flags/restaurar-uma-bandeira-arquivada.md)

## OpenAPI Specs

- [speakeasy](https://apigw.mka1.com/speakeasy.json?language=pt-BR)