Códigos de error de Integraciones de tareas
Todos los códigos de error de la API pública que emite Integraciones de tareas, con su estado HTTP, su type y una página por código.
Códigos de error que emite Integraciones de tareas. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
forge_account_link_rejected | invalid_request_error | 422 | Solo se pueden vincular cuentas personales de GitHub. GitLab y Gitea no usan cuentas vinculadas: se conectan con el token de acceso de la integración del proyecto. |
forge_account_not_linked | invalid_request_error | 422 | La operación actúa en tu nombre en la forja —por ejemplo, para listar tus repositorios de GitHub— y todavía no has vinculado tu cuenta de esa forja a tu usuario. |
forge_credentials_rejected | invalid_request_error | 422 | La instancia de GitLab o Gitea rechaza la dirección o la credencial indicadas. El subcode dice el motivo: not_a_forge_instance, redirected, repository_not_found, insufficient_permissions o unauthorized. |
forge_oauth_state_invalid | invalid_request_error | 422 | La vinculación con la forja no se ha podido completar: el estado de la autorización ha caducado, ya se usó, no es válido o pertenece a otro usuario o empresa. |
forge_repository_access_denied | authorization_error | 403 | Tu cuenta de GitHub vinculada no permite conectar ese repositorio, o el repositorio no existe; la respuesta es la misma en ambos casos para no revelar repositorios ajenos. |
forge_repository_bound_elsewhere | conflict_error | 409 | El repositorio ya está conectado a otro proyecto activo de la empresa. Un repositorio alimenta un único proyecto, para que cada issue o pull request acabe en una sola tarea. |
forge_secret_rotation_not_supported | invalid_request_error | 422 | Esta integración no tiene un secreto de webhook propio que rotar: las de GitHub firman con el secreto de la GitHub App, y la rotación solo existe en las integraciones de GitLab y Gitea. |
forge_token_required | invalid_request_error | 422 | Se cambia la URL de la instancia de la forja sin aportar un token nuevo. El token guardado nunca se envía a una dirección distinta de aquella para la que se dio, para que no acabe en un servidor ajeno. |
forge_webhook_signature_invalid | authentication_error | 401 | La entrega de webhook de la forja no se ha podido autenticar: la firma no coincide con el secreto de la integración, o la integración no existe. No se ha procesado ningún evento. |
forge_workflow_rule_column_invalid | invalid_request_error | 422 | La columna de destino de la regla no pertenece al proyecto de la integración; una columna inexistente, de otro proyecto o de otra empresa responden igual. |
forge_workflow_rule_not_found | not_found_error | 404 | La regla que mueve tareas de columna ante un evento de la forja (por ejemplo, al fusionar una pull request) no existe o es de otra empresa; los dos casos responden igual. |
github_app_not_configured | invalid_request_error | 422 | La integración con GitHub no está disponible en este servidor porque su administrador no ha configurado la GitHub App. No es un problema de tu cuenta ni de tus permisos. |
import_credentials_rejected | invalid_request_error | 422 | El sistema de origen de la importación ha rechazado las credenciales aportadas con una respuesta de no autorizado o prohibido. No se ha importado nada. |
import_run_already_active | conflict_error | 409 | Ya hay una importación en curso desde el mismo origen hacia el mismo destino. Dos importaciones simultáneas crearían tareas duplicadas, así que la segunda no se lanza. |
integration_destination_not_allowed | invalid_request_error | 422 | La política de salida de la empresa no permite conectar con esa dirección: por seguridad, los destinos privados o internos se bloquean salvo que la empresa los haya autorizado. El error no repite la URL rechazada. |
project_integration_already_connected | conflict_error | 409 | El proyecto ya tiene una integración de ese tipo, o ya está conectado a otro repositorio. Cada proyecto admite una sola integración por tipo, para que los eventos no se dupliquen. |
project_integration_not_found | not_found_error | 404 | La integración del proyecto no existe o es de otra empresa; los dos casos responden igual. Las integraciones de forjas y chats solo se gestionan desde la aplicación web, no desde la API v1. |
task_import_run_not_found | not_found_error | 404 | La importación indicada no existe o es de otra empresa; los dos casos responden igual. Cada importación tiene su propio identificador, distinto del del proyecto de destino. |
Relacionado
Códigos de error por categoría
Localiza un error por la categoría que lo emite.
Tabla de referencia completa
Todos los códigos, estados HTTP, tipos y descripciones en una referencia.
Modelo de errores
Interpreta la respuesta de error y gestiona los errores por código.