Sviluppa su Tasked
Una REST API per progetti, task, clienti, asset, commenti di review e webhook. Ogni risposta contiene un ID richiesta e la versione dell'API; gli errori condividono lo stesso formato.
Autenticazione
Ogni richiesta contiene una chiave API dell'organizzazione come bearer token: Authorization: Bearer tsk_live_... La chiave viene generata per una singola organizzazione con i soli scope necessari e può essere revocata in qualsiasi momento.
Crea e revoca le chiavi nelle impostazioni dell'organizzazione, nella scheda Integrazioni, alla voce Chiavi API. L'API è inclusa nel piano Business.
Aprire le impostazioni dell'organizzazioneScope
Una chiave contiene un sottoinsieme di questi scope; qualsiasi richiesta a un endpoint non incluso verrà rifiutata con un errore 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Endpoint
| Metodo | Path | Descrizione | Scope |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Nessuna chiave richiesta |
| 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
Gli stessi percorsi, corpi di richiesta e risposte in formato OpenAPI 3.1 leggibile da una macchina, generati direttamente dai validatori eseguiti dall'API, in modo da evitare qualsiasi discrepanza.
Scaricare openapi.jsonErrori e limiti
Un errore risponde con { error, errorCode, requestId, apiVersion }. Una chiave può inviare 600 richieste al minuto; oltre questo limite la risposta è 429. Invia X-API-Version per bloccare una versione; una versione deprecata viene segnalata nell'header Deprecation.
Inizia senza carta
Quattordici giorni, tutto attivo. Apri un workspace, di' all'AI come lavori, invita un cliente ad approvare.
Hai una domanda? Scrivici
Rispondiamo direttamente dal sito quando possibile, e una persona ti ricontatterà se necessario. Nessuna mailing list.