Factuarea APIDevelopers

Buscar una tarea por clave

Busca una tarea por su clave (DEV-12) enviada en el body de la petición.

  • Las claves anteriores de una tarea siguen funcionando después de moverla a otro proyecto o de cambiar la clave del proyecto.
  • Devuelve 404 task_not_found cuando ninguna tarea de tu empresa coincide; una clave mal formada devuelve 422 invalid_task_key.
  • Es una consulta de solo lectura: no hace falta Idempotency-Key.
POST
/companies/{company}/tasks/find-by-key

Authorization

AuthorizationBearer <token>

Tu API key como token Bearer: fact_live_… en producción, fact_test_… en sandbox. Consulta la guía de autenticación.

En: header

Parámetros de ruta

company*string

Identificador público (UUID v7) de la empresa. Obtenlo de GET /v1/me (data.scope[].id).

Formatouuid

Headers

Factuarea-Version?string

Fija la versión de la API (YYYY-MM-DD, versionado por fecha estilo Stripe) para esta petición; omítelo para usar la versión fijada de la clave, o la última si no hay ninguna. Versión no soportada → 400 unsupported_api_version; malformada → 400 parameter_invalid_format. La versión efectiva se refleja en la cabecera de respuesta Factuarea-Version. Consulta la guía de Versioning.

Formatodate

Cuerpo de la petición

application/json

Definiciones de TypeScript

Usa el tipo request body en TypeScript.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json