> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Lista de erros da API do host do Narya > Todo código de erro que o host do Narya responde, por HTTP ou ao final de um turn: quando o host o grava, e o que fazer em seguida. O host responde com um único envelope de erro: `code`, `title` e `message`, além de um mapa `fields` em um `422`. Os códigos são `NRY-` e quatro dígitos. Cite o código ao reportar um problema. A [visão geral da API do host](/pt/reference/platform/narya/host-api-overview) descreve o transporte pelo qual essas respostas chegam. ```json theme={null} { "code": "", "title": "", "message": "<message>" } ``` ## Códigos que o host responde *** A `message` sempre nomeia o item específico que falhou. Leia-a antes de agir com base na linha abaixo. | Código | Status HTTP | Quando o host responde | O que fazer | | :------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- | | NRY-0000 | 400 | A requisição está malformada. O corpo não é um JSON válido, ou um valor não corresponde ao tipo declarado. | Corrija a codificação da requisição. A mensagem nomeia a parte que falhou ao corresponder. | | NRY-0001 | 422 | O corpo da requisição falhou na validação. | Corrija as propriedades que o mapa `fields` nomeia, e envie a requisição novamente. | | NRY-0002 | 404 | Nenhuma sessão neste host carrega o `sessionId` da requisição. | Liste as sessões para obter um id válido. | | NRY-0003 | 409 | A sessão de destino está arquivada. Uma sessão arquivada não aceita novos trabalhos. | Crie um branch da sessão em uma entrada para continuar a partir da transcrição, ou direcione-se a uma sessão ativa. | | NRY-0004 | 409 | A sessão ou lane de destino não pode aceitar a requisição no estado atual. | Aguarde o trabalho em andamento terminar, ou interrompa-o, e envie a requisição novamente. | | NRY-0006 | 409 | Dois pacotes reivindicam o mesmo slot substituível. Nada foi instalado. Um job de pacote que falha dessa forma carrega o código no seu campo `error`. | Remova ou desabilite um dos reivindicantes, e instale novamente. A mensagem nomeia ambos. | | NRY-0007 | 409 | Uma build de pacote falhou. O binário que já estava servindo permanece intacto. Um job de pacote que falha dessa forma carrega o código no seu campo `error`. | Leia o erro do job, corrija ou remova o pacote, e instale novamente. | | NRY-0009 | 404 | A sessão par endereçada não existe mais neste host. | Liste os pares para atualizar o conjunto de sessões endereçáveis, e envie a mensagem novamente. | | NRY-0010 | 422 | Um script de workflow falhou na validação antes do run começar. | Corrija os erros de script que a mensagem nomeia, e inicie o run novamente. | | NRY-0012 | 500 | O store local está indisponível, ou falhou na verificação de integridade. O host recusa gravações em vez de operar sobre um store danificado. | Verifique o espaço em disco e a integridade do store, corrija a causa, e reinicie o host. | | NRY-0015 | 404 | O recurso nomeado não existe neste host. Pacotes, jobs de pacote, receitas de agente, skills, comandos, lanes, monitores, provedores, agendamentos, workflow runs, perguntas entre sessões e entradas da transcrição respondem todos com este código. | Liste a coleção à qual o recurso pertence, e use um nome ou id dela. | | NRY-0016 | 409 | Já existe um pacote instalado com este nome. | Remova primeiro o pacote instalado, ou instale com outro nome. | | NRY-0017 | 409 | Uma habilitação ou uma desabilitação trocou o binário, e então falhou ao confirmar a linha do pacote. | A mudança já se aplica ao binário que roda agora. Envie a requisição novamente, ou reinicie o host para que a conciliação de inicialização confirme a linha. | | NRY-0020 | 412 | Uma gravação condicional carregava um `ifMatchesSha256` ao qual o valor armazenado não corresponde mais pelo hash. Outro cliente gravou a linha primeiro, e nada foi gravado. | Leia o recurso novamente para ver o que ele contém agora. Um cliente que limpa um rascunho que enviou pode tratar isso como sucesso. | | NRY-0021 | 500 | O host não conseguiu executar a requisição nesta máquina. Um processo que precisava iniciar não iniciou, ou uma operação falhou por um motivo sem um código mais exato. | Não havia nada de errado com a requisição, então envie-a novamente. O log do host carrega a causa, que a mensagem omite. | | NRY-0022 | 500 | Um rewind que restaura arquivos nomeados parou no meio do caminho. Alguns arquivos voltaram e o restante permanece intocado. | Leia a mensagem para ver os arquivos que foram movidos. A working tree como estava antes da tentativa é mantida como um ponto de restauração. | | NRY-0023 | 500 | Um rewind da conversa e dos arquivos criou um branch da conversa, e então falhou ao restaurar os arquivos. O branch é real. | Continue na sessão que a mensagem nomeia, e então faça o rewind dos arquivos sozinho a partir da sessão original no mesmo momento. | | NRY-0024 | 413 | Uma importação de transcrição ultrapassou um teto de tamanho. | Leia a mensagem para ver o teto que ela nomeia, e envie uma transcrição menor. | | NRY-0025 | 409 | Uma pergunta bloqueante entre sessões foi recusada, porque atendê-la fecharia um loop de sessões que esperam umas pelas outras. | Responda ou expire a pergunta já em andamento, ou envie uma mensagem unidirecional em vez disso. A mensagem nomeia as duas sessões. | | NRY-0026 | 409 | Um stream retomou a partir de um `Last-Event-ID` que nomeia um evento mais recente do que qualquer coisa que este store contém. | Retome sem nenhum `Last-Event-ID`, e leia o estado novamente por meio das operações `GET`. O mesmo cursor é recusado de forma idêntica todas as vezes. | | NRY-0027 | 413 | Os arquivos de uma mensagem pesam juntos mais do que uma requisição a um fornecedor consegue carregar. Nada foi gravado. | Envie menos arquivos na mensagem, ou arquivos menores. A mensagem nomeia o teto em bytes. | ## Códigos que um turn com falha carrega *** Um turn que falha termina com um evento `turn-finished`. O seu `payload.error` carrega o mesmo envelope de um erro HTTP. Três códigos chegam dessa forma, e o host nunca os responde como um status HTTP. | Código | Evento | Quando o host grava | O que fazer | | :------- | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | NRY-0008 | `turn-finished` | O fornecedor de modelo de que o turn precisava não tem uma credencial utilizável. Ela está ausente, expirada ou recusada, ou o keyring está indisponível. | Faça login com `narya auth login <provider>`, e envie a mensagem novamente. A mensagem nomeia o remédio adequado. | | NRY-0018 | `turn-finished` | O turn não conseguiu alcançar nenhum fornecedor de modelo. A sessão não nomeia nenhum provedor, ou nomeia um do qual este host não tem registro. | Faça login com `narya auth login <provider>`, ou defina `default_model` no `config.toml` do host, e envie a mensagem novamente. `narya providers` lista o que esta máquina pode usar. | | NRY-0019 | `turn-finished` | O turn falhou por um motivo sem um código mais específico. A mensagem carrega a causa. O Narya remove dela formatos de credencial conhecidos e segredos de URL, e substitui o seu diretório home por `~`. Os caminhos do host fora do seu diretório home permanecem. | Leia a mensagem. O log do host carrega a mesma falha sem essa filtragem. |