Códigos de erro

Toda resposta de erro tem o mesmo formato. Baseie-se no status HTTP e em error.code; error.message é um texto legível em inglês e pode mudar.

Formato do erro

{
  "detail": "…",
  "error": {
    "code": "api.cursor_invalid",
    "message": "The cursor is malformed or was issued for different filters.",
    "details": {"parameter": "cursor"},
    "request_id": "01JB7Q2M4X9V3K8T5N6P0R1S2A",
    "doc_url": "https://developers.sursa.com/errors/api.cursor_invalid"
  }
}

error.code é o código desta página; error.request_id corresponde ao cabeçalho X-Request-Id; error.doc_url aponta para esta página.

access_requests

409access_requests.closedjá foi tomada uma decisão sobre esta solicitação de acesso
400access_requests.invalid{reason}
404access_requests.not_foundsolicitação de acesso ou resposta não encontrada
403access_requests.not_personas solicitações de acesso estão disponíveis só para usuários, não para chaves de API nem no modo “View as”

analytics

403analytics.admins_onlyas análises estão disponíveis só para os administradores da organização
422analytics.invalid_periodperíodo inválido: {reason}

announcements

422announcements.audience_requiredselecione pelo menos um grupo ou usuário
403announcements.author_onlysó o autor pode fazer isso
422announcements.invalid_viewview deve ser inbox, my_sent, all_sent ou my_scheduled
404announcements.not_foundcomunicado não encontrado
409announcements.not_sento comunicado ainda não foi enviado
422announcements.note_too_longa nota deve ter no máximo 700 caracteres
422announcements.scheduled_pasta data de envio deve estar no futuro

answers

400answers.empty_questionpergunta vazia
429answers.engine_busyo serviço de respostas está ocupado; tente de novo em {retry_after} s
409answers.external_ai_disabledo processamento externo está desativado para a organização, e esta resposta não pode ser gerada sem ele
400answers.last_message_not_usera última mensagem deve ser do usuário
404answers.no_collectionsnão há coleções legíveis
422answers.scope_invalida abrangência da pergunta não pode ser aplicada: {reason}

api

400api.cursor_invalido cursor está malformado ou foi emitido para outros filtros
400api.expand_invalidexpand[] é inválido: {reason}
410api.goneesta rota da API foi desativada; consulte docs/api/CHANGELOG.md
409api.idempotency_in_progressuma requisição com esta Idempotency-Key ainda está em andamento; tente de novo mais tarde
400api.idempotency_key_invalido cabeçalho Idempotency-Key deve ter de 1 a 255 caracteres ASCII imprimíveis
409api.idempotency_mismatchesta Idempotency-Key já foi usada com uma requisição diferente
400api.metadata_invalidmetadata inválido: {reason}
404api.not_foundNão encontrado
413api.payload_too_largeo corpo da requisição é grande demais
429api.quota_exceededa organização esgotou a cota de requisições à API deste período
429api.rate_limitedrequisições demais; tente de novo mais tarde

api_keys

400api_keys.data_profile_not_applicabledata_profile não se aplica à função admin; uma chave de administrador vê todos os dados da organização
401api_keys.expireda chave de API expirou
403api_keys.feature_disabledos tokens de API não estão incluídos no plano da organização
400api_keys.invalid_cidrsallowed_cidrs deve ser uma lista de redes como 10.0.0.0/8: {reason}
400api_keys.invalid_collectionscollection_ids deve listar coleções da organização: {reason}
400api_keys.invalid_expiresexpires_at deve ser um momento futuro em ISO 8601
400api_keys.invalid_scopesscopes deve ser uma lista de read, write, admin, system: {reason}
403api_keys.ip_not_allowedas requisições com esta chave de API não são permitidas a partir desta rede
403api_keys.mcp_onlyuma chave MCP pessoal só funciona no endpoint /mcp
404api_keys.not_foundchave não encontrada
403api_keys.scopea chave de API não tem o escopo {scope}

api_logs

404api_logs.not_foundrequisição não encontrada no registro da API ou mais antiga que 14 dias

auth

403auth.admin_requiredé necessária a função de administrador
403auth.editor_requiredé necessária a função de editor
401auth.not_authenticatednão autenticado
403auth.system_scopeos administradores do sistema não têm acesso aos dados das organizações

authz

403authz.forbiddené necessária a permissão '{permission}'
400authz.group_key_invalidchave de grupo inválida: letras latinas, algarismos, '_' e '-', até 80 caracteres, começando com uma letra
409authz.group_key_takena chave de grupo '{key}' já está em uso
409authz.group_kind_immutableeste grupo é interno; os membros dele são calculados e não podem ser editados, e ele não pode ser excluído
409authz.group_managed_externallyo grupo é gerenciado pelo provedor de identidade (SCIM)
404authz.group_not_foundgrupo não encontrado
409authz.last_ownerpelo menos um '{role}' deve permanecer no objeto
409authz.legacy_admin_single_user_onlya função de administrador é concedida só a usuários, não a grupos
409authz.managed_by_sourceas permissões deste objeto são gerenciadas pela fonte dele
400authz.role_key_invalidchave de função inválida: letras latinas, algarismos, '_' e '-', até 64 caracteres, começando com uma letra
409authz.role_key_takena chave de função '{key}' já está em uso
404authz.role_not_foundfunção não encontrada
400authz.role_scope_mismatcha função '{key}' não pode ser concedida em {object_type}
409authz.role_system_immutableas funções do sistema não podem ser alteradas nem excluídas
400authz.subject_requiredé obrigatório exatamente um entre group_id e user_id
400authz.unknown_permissionpermissão desconhecida '{permission}'
400authz.user_not_in_orgusuário não encontrado na organização
400authz.view_requireduma função para objetos deve incluir COLLECTION_VIEW

billing

402billing.seats_exceededTodas as {purchased} licenças da assinatura estão ocupadas ({reserved} usuários ativos e convites pendentes). Adicione licenças na página “Billing” (faturamento) para convidar mais pessoas.

cards

400cards.archive_emptyo arquivo compactado não contém documentos compatíveis
400cards.archive_encryptedo arquivo compactado está criptografado; envie um arquivo compactado sem senha
400cards.archive_invalido arquivo não é um arquivo compactado zip ou o arquivo compactado está danificado
404cards.archive_job_not_foundjob de descompactação do arquivo compactado não encontrado
413cards.archive_too_largeo arquivo compactado descompactado é maior que o permitido
413cards.archive_too_many_fileso arquivo compactado contém mais arquivos que o permitido
400cards.bulk_invalid{reason}
403cards.category_whole_accessa categoria só pode ser alterada com acesso ao documento inteiro
404cards.comment_not_foundcomentário não encontrado ou não é seu
403cards.content_whole_accesso conteúdo do cartão só pode ser substituído com acesso ao documento inteiro
403cards.delete_whole_accesso cartão só pode ser excluído com acesso ao documento inteiro
403cards.duplicate_restrictedexiste um documento idêntico que não está totalmente disponível com o seu perfil de acesso a dados
400cards.export_formatformat deve ser pdf, docx ou md
409cards.external_id_takenexternal_id '{external_id}' já é usado por outro cartão da organização
409cards.indexing_in_progresso cartão está sendo indexado neste momento
400cards.invalid_folder_filterfolder=none exige o parâmetro collection
400cards.invalid_kind_filterkind deve ser um de ('file', 'text', 'connector')
400cards.invalid_orderorder deve ser 'asc' ou 'desc'
400cards.invalid_owner_filterowner deve ser 'me', 'none' ou um id de usuário
400cards.invalid_sortsort deve ser um de ('created_at', 'updated_at', 'title', 'size', 'verified_at', 'trust', 'due')
400cards.invalid_status_filterstatus deve ser um de ('processing', 'ready', 'error', 'archived', 'all')
400cards.invalid_type_filtertype deve ser 'table' ou 'text'
400cards.invalid_verification_filterverification deve ser um de ('verified', 'needs_verification', 'stale')
409cards.managed_by_sourceeste cartão é gerenciado por uma fonte; altere o documento na fonte (para uma fonte personalizada, envie-o de novo)
403cards.no_accesssem acesso {action} a este cartão
409cards.no_original_fileo arquivo original não está armazenado para este cartão
404cards.not_foundcartão não encontrado
400cards.review_requires_asyncreview=true exige async=true: a prévia da análise é mostrada enquanto o job aguarda
403cards.sensitivity_admin_onlysó um administrador pode reduzir a confidencialidade ou mover um cartão confidencial
404cards.table_not_foundtabela não encontrada
400cards.unknown_table_parttabela desconhecida '{table_id}'
415cards.unsupported_formato formato {ext} não é compatível; permitidos: ['.adoc', '.asciidoc', '.bmp', '.csv', '.docx', '.eml', '.htm', '.html', '.jpeg', '.jpg', '.markdown', '.md', '.ods', '.pdf', '.png', '.pptx', '.tif', '.tiff', '.tsv', '.txt', '.webp', '.xls', '.xlsm', '.xlsx']
403cards.verify_forbiddensó o responsável, um verificador ou um administrador pode verificar este cartão
400cards.verify_user_account_requireda verificação exige uma conta de usuário, não uma chave de API
404cards.version_not_foundversão não encontrada

catalog

404catalog.icon_not_foundo serviço não tem ícone
404catalog.service_not_foundserviço desconhecido '{service_id}'

collections

403collections.admin_fieldsé necessária a função de administrador para as configurações de acesso, a confidencialidade, os valores padrão e as configurações de busca da coleção
409collections.index_outdateda indexação desta coleção está desatualizada; atualize-a primeiro: PATCH /v1/collections/{name} com upgrade_index: true reindexa a coleção
409collections.indexing_in_progressos documentos desta coleção estão sendo indexados neste momento; altere as configurações de busca quando a indexação terminar
400collections.invalid_namenome de coleção inválido: 1–64 caracteres, letras latinas, algarismos, '_' e '-'
403collections.no_accesssem acesso '{action}' à coleção '{name}'
403collections.no_write_accesssem acesso de escrita à coleção '{name}'
404collections.not_foundcoleção '{name}' não encontrada

comments

422comments.body_requiredo texto do comentário é obrigatório
403comments.forbiddenvocê não pode alterar este comentário
404comments.not_foundcomentário não encontrado
400comments.reply_to_replyas respostas só são permitidas a um comentário raiz
409comments.resolved_editum comentário resolvido não pode ser editado

conversations

422conversations.invalid_cursorcursor inválido
404conversations.not_foundconversa não encontrada
422conversations.title_emptyo título não pode estar vazio

drafts

409drafts.already_requestedjá foi feita uma solicitação de publicação para este rascunho; você pode continuar editando enquanto ele aguarda a revisão
409drafts.card_deletedo cartão deste rascunho foi excluído
409drafts.card_publishedo cartão foi publicado ou alterado depois que este rascunho começou; comece um novo rascunho a partir da versão publicada
422drafts.content_json_invalidcontent_json deve ser um objeto com schemaVersion (string) e doc (objeto), no máximo 500000 bytes
409drafts.deleted_by_collaboratoroutro colaborador excluiu este rascunho; comece um novo rascunho para continuar editando
409drafts.existsvocê já tem um rascunho deste cartão
422drafts.invalid_scopescope deve ser mine, all ou orphaned
403drafts.not_collaboratorsó um colaborador ou um administrador pode alterar este rascunho
404drafts.not_foundrascunho não encontrado
409drafts.not_requesteda publicação não foi solicitada para este rascunho
403drafts.publish_forbiddenvocê não tem permissão para publicar nesta coleção
422drafts.scheduled_pasta data agendada deve estar no futuro
422drafts.title_requiredo título é obrigatório

events

404events.not_foundevento não encontrado ou mais antigo que 30 dias

files

410files.expiredo arquivo expirou
422files.infectedo arquivo {filename} foi rejeitado pelo antivírus: {signature}
422files.invalid_expiry_filterexpiry deve ser um de active, expiring, expired
422files.invalid_kind_filterkind deve ser um de pdf, xlsx, csv, docx, md
422files.invalid_origin_filterorigin deve ser um de answer, card, insights, list
409files.no_expiryeste arquivo é mantido sem data de expiração
404files.not_foundarquivo não encontrado
409files.not_regenerable{reason}
422files.preview_failednão é possível mostrar a prévia deste arquivo: {reason}
404files.regeneration_requiredeste arquivo foi gerado no endereço principal e contém detalhes que o endereço da API não retorna; gere-o de novo com POST /v1/files/{file_id}/regenerate ou baixe-o no endereço principal
409files.removedo arquivo já foi removido após a expiração; gere-o de novo
503files.scan_unavailablea varredura antivírus está indisponível; tente de novo mais tarde
413files.too_largeo arquivo {filename} é maior que o limite de upload de {limit}
415files.type_mismatcho arquivo {filename} não corresponde ao tipo dele: extensão {extension}, tipo declarado {declared}, conteúdo {detected}

finance

503finance.engine_unavailableo assistente está indisponível: {reason}
413finance.export_too_largea exportação tem mais de {limit} linhas: restrinja os filtros
403finance.forbiddeno seu perfil de dados não tem acesso aos dados financeiros
400finance.invalid{reason}

folders

400folders.appearance_invalidcolor deve ser um de blue, violet, emerald, amber, orange, rose, cyan, slate; icon deve ser uma chave de categoria ou lock
400folders.card_collection_mismatcho cartão e a pasta pertencem a coleções diferentes
409folders.cycleuma pasta não pode ser movida para dentro de si mesma nem de uma subpasta dela
409folders.depth_exceededa profundidade resultante das pastas excede o máximo de 3
404folders.not_foundpasta não encontrada
400folders.parent_mismatcha pasta superior pertence a outra coleção
400folders.sibling_not_foundprev_sibling_id deve ser 'first', 'last' ou o id de uma pasta irmã na pasta superior de destino
400folders.title_invalido título da pasta deve ter de 1 a 200 caracteres

insights

403insights.finance_forbiddeno seu perfil de dados não tem acesso aos dados financeiros
400insights.invalid_period{name}: o período deve ter o formato YYYY-MM, recebido '{value}'
404insights.no_datanão há dados tabulares para a análise do conhecimento
400insights.period_ordersince não pode ser posterior a until

internal

500internal.errorerro interno do servidor

jobs

409jobs.already_processingo job já está sendo processado e não pode mais ser removido da fila
409jobs.cancel_failednão foi possível remover o job da fila
410jobs.cancel_unsupportedo job entrou na fila antes de o cancelamento ser compatível; aguarde até que ele termine
422jobs.invalid_filter{reason}
404jobs.not_foundjob não encontrado
409jobs.not_queuedsó os jobs na fila podem ser removidos da fila (este job está {status})

limits

402limits.cardsA organização atingiu o limite de {limit} cartões{plan}. Exclua os cartões de que não precisa mais ou peça ao administrador do sistema para aumentar o limite.
429limits.concurrent_answersa organização já tem {used} respostas em andamento (limite {limit}); tente de novo em alguns segundos
429limits.questionsA organização esgotou o limite de {limit} perguntas a cada 24 horas{plan}. As perguntas voltarão a estar disponíveis em cerca de {wait}. Se precisar de mais, peça ao administrador do sistema para aumentar o limite.
402limits.sourcesA organização atingiu o limite de {limit} fontes{plan}. Exclua as fontes de que não precisa mais ou peça ao administrador do sistema para aumentar o limite.
402limits.sources_instantAs atualizações instantâneas não estão incluídas no plano da organização{plan}; a fonte continua seguindo o cronograma.
402limits.storageNão há armazenamento suficiente: a organização usa {used} de {limit} GB{plan}, e este arquivo precisa de mais {amount}. Exclua os cartões ou arquivos de que não precisa mais ou peça ao administrador do sistema para aumentar o limite.
402limits.usersA organização atingiu o limite de {limit} usuários{plan}, contando os usuários ativos e os convites pendentes. Desative as contas ou revogue os convites de que não precisa mais, ou peça ao administrador do sistema para aumentar o limite.

notifications

422notifications.invalid_filter{reason}

oauth

403oauth.operation_not_allowedesta operação não está disponível para um token de app OAuth
401oauth.token_expiredo token de acesso expirou; obtenha um novo com o token de atualização

oauth_apps

400oauth_apps.invalid{reason}
400oauth_apps.invalid_redirect_urio URI de redirecionamento '{uri}' não é permitido: use https, http só para localhost ou um esquema de app em domínio invertido, sem âncora “#”
400oauth_apps.invalid_scopeescopo desconhecido '{scope}'
409oauth_apps.not_confidentialo app é público: não tem segredo do cliente nem acesso por client credentials
404oauth_apps.not_foundapp OAuth não encontrado
409oauth_apps.too_manya organização já tem {max} apps OAuth

oauth_authorizations

404oauth_authorizations.not_foundautorização do app não encontrada

org

403org.deletedesta organização foi excluída
404org.not_foundorganização não encontrada
403org.suspendedesta organização está suspensa: o login está fechado, os dados são mantidos; fale com o seu administrador

profiles

400profiles.unknownperfil de dados desconhecido '{key}'

quality

400quality.filter_invalid{reason}
409quality.followup_closeda lacuna de conhecimento já está fechada
404quality.followup_not_foundlacuna de conhecimento em andamento não encontrada

query

422query.invalid_datedata inválida: {value}

questions

400questions.answer_emptya resposta está vazia e não pode ser salva como cartão
404questions.answer_table_not_foundtabela não encontrada na resposta
404questions.dataset_not_foundconjunto de dados não encontrado
400questions.export_formatformat deve ser um de pdf, xlsx, csv, docx, md
400questions.export_rowsrows deve listar números de linhas da tabela a partir de 0, separados por vírgula, intervalos com hífen (0-4,7)
422questions.invalid_feedback_filterfeedback deve ser positive, negative, rated, none ou unanswered
422questions.invalid_q_fieldq_field deve ser all ou question
422questions.invalid_view_as_filterview_as deve ser only ou exclude
404questions.not_foundpergunta não encontrada
400questions.save_card_error{reason}

sources

400sources.connection_kind_mismatcha conexão é para {kind}, não para esta fonte
404sources.connection_not_foundconexão da fonte não encontrada
403sources.connection_not_usableesta conexão pertence a outro usuário ou está desativada
403sources.feature_disabledos conectores de fontes em um clique não estão incluídos no plano da organização
400sources.folder_invalida pasta não está na coleção da fonte ou você não pode adicionar cartões a ela
400sources.invalid_configconfigurações da fonte inválidas: {reason}
400sources.kind_not_allowed_for_keyuma chave de API só pode criar e alterar fontes personalizadas; conecte as outras fontes no navegador
404sources.not_foundfonte não encontrada
422sources.push_batch_rejectedo lote não foi aplicado porque alguns documentos foram rejeitados; consulte details.results
400sources.push_document_invalid{reason}
404sources.push_document_not_founddocumento não encontrado na fonte
409sources.push_initial_requiredconclua uma sincronização inicial antes de uma incremental
401sources.push_key_invalida chave de API da fonte está ausente, é inválida ou foi revogada
404sources.push_key_not_foundchave de API da fonte não encontrada
409sources.push_sync_closeda sincronização está fechada ou expirou; abra uma nova
404sources.push_sync_not_foundsincronização não encontrada
409sources.push_sync_openhá outra sincronização aberta para esta fonte; feche-a ou aguarde até que ela expire
409sources.push_too_many_documentsa fonte atingiu o limite de documentos do seu plano
400sources.push_unsupportedesta fonte não aceita documentos enviados (só as fontes personalizadas aceitam)

tasks

400tasks.invalid_scopescope deve ser 'mine' ou 'team'
403tasks.team_forbiddena visão da equipe está disponível para administradores e verificadores
400tasks.user_account_requiredas tarefas pessoais pertencem a contas de usuário, não a chaves de API

uploads

409uploads.already_usedo upload já foi usado
422uploads.checksum_mismatcha soma de verificação SHA-256 não corresponde ({reason})
410uploads.expiredo upload expirou
409uploads.incompletefaltam {missing_count} partes no upload
404uploads.not_foundupload não encontrado
409uploads.not_readyo upload ainda não está pronto (status {status})
400uploads.part_invalida parte {n} do upload é inválida: {reason}
422uploads.purpose_mismatcho upload foi criado para {purpose}, não para {expected}
422uploads.rejectedo upload foi rejeitado: {reason}
409uploads.state_conflicto upload não aceita esta operação no status {status}
503uploads.storage_unavailableo armazenamento de arquivos está temporariamente indisponível; tente de novo mais tarde
413uploads.too_largeo arquivo é maior que o limite de upload de {limit_bytes} bytes
415uploads.unsupported_formatarquivos com a extensão {extension} não podem ser enviados para {purpose}

users

422users.display_name_emptyo nome de exibição não pode estar vazio
409users.email_takenjá existe um usuário com este e-mail na organização
400users.inactive_assignmentum usuário inativo não pode receber atribuições
409users.last_admina organização deve manter pelo menos um administrador ativo
409users.managed_by_scimesta conta é gerenciada pelo seu provedor de identidade (SCIM); altere-a lá
404users.not_foundusuário não encontrado
400users.not_in_orgusuário não encontrado na organização
400users.offboard_targeto destino da transferência deve ser um usuário ativo da mesma organização, diferente do usuário desligado
403users.password_not_allowedesta conta faz login pelo seu provedor de identidade e não tem senha; um administrador pode adicionar uma com um link de redefinição
400users.unknown_or_inactiveusuários desconhecidos ou inativos: {ids}
400users.update_invalid{reason}
409users.username_takenjá existe um usuário com este nome de usuário na organização

users_import

422users_import.csv_invalido arquivo não é um CSV válido: {reason}
422users_import.emptyo arquivo não tem linhas depois do cabeçalho
422users_import.no_email_columno cabeçalho não tem uma coluna de e-mail (email, e-mail, mail); encontradas: {columns}
413users_import.too_many_rowso arquivo tem {rows} linhas; importe no máximo {limit} linhas de cada vez

validation

422validation.faileda validação da requisição falhou

verification

409verification.absolute_expireda data de verificação já passou: defina um novo intervalo de verificação antes de verificar
409verification.archivedo cartão está arquivado
400verification.date_requiredé necessária uma data no futuro
422verification.invalid_actionkind deve ser view ou copy
400verification.invalid_intervalo intervalo de verificação deve estar entre 1 e 3650 dias
422verification.invalid_modemode deve ser up_first ou all
400verification.invalid_reasonreason deve ser manual, automation ou requested
422verification.invalid_sortcampo ou ordem de ordenação desconhecidos
400verification.invalid_typeo tipo de verificação deve ser relative, absolute ou manual
409verification.self_remindvocê é o único verificador deste cartão: não há a quem lembrar
400verification.verifier_requiredé necessário pelo menos um verificador

view_as

403view_as.admin_key_requiredX-View-As exige uma chave de API com a função admin
400view_as.invalid_headerX-View-As deve ser <profile>[:viewer|verifier|editor] com um perfil existente
403view_as.read_onlymodo de visualização: as alterações estão desativadas enquanto você vê como outro perfil

webhooks

400webhooks.access_invalida função, o modo de payload, o perfil de dados, as coleções ou as etiquetas do webhook são inválidos
400webhooks.auth_invalida autorização de saída deve ser bearer com um token ou basic com um nome de usuário e uma senha
403webhooks.collections_outside_keyesta chave de API está limitada a coleções: liste em collection_ids do webhook só coleções que estejam entre as coleções da chave
404webhooks.delivery_not_foundentrega do webhook não encontrada
400webhooks.description_too_longa descrição do webhook tem mais de 200 caracteres
409webhooks.endpoint_disabledo webhook está desativado; ative-o primeiro
409webhooks.event_not_permittedo webhook não receberia este evento agora: a função, o perfil de dados, as coleções ou as etiquetas dele não o permitem mais, por isso a entrega não é repetida
400webhooks.events_requiredinscreva-se em pelo menos um evento
403webhooks.feature_disabledos webhooks não estão incluídos no plano da organização
400webhooks.headers_invalidos cabeçalhos personalizados do webhook são inválidos: no máximo 10 cabeçalhos, nomes de letras, algarismos e hifens sem nomes reservados, valores de até 1024 bytes
400webhooks.invalid_urlurl do webhook deve ser um endereço https absoluto sem credenciais
404webhooks.not_foundwebhook não encontrado
400webhooks.overlap_invalida sobreposição da rotação deve estar entre 0 e 168 horas
400webhooks.private_addresso host do webhook resolve para um endereço de rede privado ou reservado
400webhooks.redeliver_invalido período de reenvio deve estar dentro dos últimos 30 dias, com since antes de until, e os status devem ser success, exhausted ou cancelled
409webhooks.too_manyuma organização pode ter no máximo 20 webhooks
400webhooks.unknown_eventevento de webhook desconhecido {type}
400webhooks.unresolvableo host do webhook não resolve