Desarrolla con Tasked
Una REST API para proyectos, tareas, clientes, archivos, comentarios de revisión y webhooks. Cada respuesta incluye un ID de solicitud y la versión de la API; los errores comparten una estructura común.
Autenticación
Cada solicitud incluye una clave de API de la organización como token portador: Authorization: Bearer tsk_live_... Las claves se generan para una organización con solo los ámbitos que necesita, y se pueden revocar en cualquier momento.
Crea y revoca claves en la configuración de la organización, dentro de la pestaña Integraciones, en Claves de API. La API está incluida en el plan Business.
Abrir la configuración de la organizaciónÁmbitos
Una clave contiene un subconjunto de estos ámbitos; cualquier solicitud a un endpoint fuera de ellos se rechazará con un error 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Endpoints
| Método | Ruta | Qué hace | Ámbito |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | No requiere clave |
| GET | /api/v1/projects | List projects | projects:read |
| POST | /api/v1/projects | Create a project | projects:write |
| GET | /api/v1/projects/{id} | Get a project | projects:read |
| GET | /api/v1/tasks | List tasks | tasks:read |
| POST | /api/v1/tasks | Create a task | tasks:write |
| GET | /api/v1/tasks/{id} | Get a task | tasks:read |
| PATCH | /api/v1/tasks/{id} | Update a task | tasks:write |
| POST | /api/v1/tasks/{id}/move | Move a task to a stage | tasks:write |
| GET | /api/v1/clients | List clients | clients:read |
| POST | /api/v1/clients | Create a client | clients:write |
| GET | /api/v1/clients/{id} | Get a client | clients:read |
| GET | /api/v1/assets | List assets | assets:read |
| GET | /api/v1/assets/{id} | Get an asset | assets:read |
| POST | /api/v1/assets/uploads | Initiate a direct upload | assets:write |
| POST | /api/v1/assets/uploads/{id}/finalize | Confirm an upload and write the version | assets:write |
| GET | /api/v1/review-comments | List review comments on an asset | reviews:read |
| GET | /api/v1/webhooks | List webhooks | webhooks:manage |
| POST | /api/v1/webhooks | Create a webhook | webhooks:manage |
| GET | /api/v1/webhooks/{id} | Get a webhook | webhooks:manage |
| PATCH | /api/v1/webhooks/{id} | Update a webhook | webhooks:manage |
| DELETE | /api/v1/webhooks/{id} | Delete a webhook | webhooks:manage |
| GET | /api/v1/webhooks/{id}/deliveries | Delivery log of a webhook | webhooks:manage |
| POST | /api/v1/webhooks/{id}/deliveries/{deliveryId}/replay | Replay a delivery | webhooks:manage |
Documento OpenAPI
Las mismas rutas, cuerpos de solicitud y respuestas en formato OpenAPI 3.1 legible por máquina, generados a partir de los mismos validadores que ejecuta la API, por lo que no puede haber discrepancias.
Descargar openapi.jsonErrores y límites
Un error responde con { error, errorCode, requestId, apiVersion }. Una clave puede enviar 600 solicitudes por minuto; por encima de ese límite, la respuesta es 429. Envía X-API-Version para fijar una versión; si está en desuso, se marcará en la cabecera Deprecation.
Empieza sin tarjeta
Catorce días con todo activado. Abre un espacio de trabajo, dile a la IA cómo trabajas e invita a un cliente a aprobar.
¿Tienes alguna pregunta? Escríbenos
Respondemos desde la propia web cuando podemos y, si es necesario, una persona hará el seguimiento. Sin listas de correo.