Bouwen op Tasked
Een REST API voor projecten, taken, klanten, assets, review-opmerkingen en webhooks. Elk antwoord bevat een request-ID en de API-versie; fouten delen dezelfde envelop.
Authenticatie
Elk verzoek bevat een API-key van de organisatie als bearer-token: Authorization: Bearer tsk_live_... Een key wordt gegenereerd voor één organisatie met alleen de benodigde scopes en kan op elk moment worden ingetrokken.
Je kunt keys aanmaken en intrekken in de Organisatie-instellingen, op het tabblad Integraties, onder API-keys. De API is inbegrepen in het Business-pakket.
Open organisatie-instellingenScopes
Een key bevat een subset van deze scopes; een verzoek voor een eindpunt daarbuiten wordt geweigerd met een 403-foutmelding.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Eindpunten
| Methode | Pad | Wat het doet | Scope |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Geen key nodig |
| 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 |
OpenAPI-document
Dezelfde routes, request-bodies en responses als machineleesbare OpenAPI 3.1, gegenereerd op basis van de validators die de API uitvoert, zodat deze er nooit van kan afwijken.
Download openapi.jsonFouten en limieten
Een fout antwoordt met { error, errorCode, requestId, apiVersion }. Een sleutel mag 600 verzoeken per minuut sturen; daarboven is het antwoord 429. Stuur X-API-Version om een versie vast te zetten; een verouderde versie wordt gemarkeerd in de Deprecation-header.
Starten zonder creditcard
Veertien dagen, alles ingeschakeld. Open een workspace, vertel de AI hoe je werkt en nodig een klant uit om goed te keuren.
Een vraag? Schrijf ons
We antwoorden direct vanaf de site als dat kan, en een medewerker volgt het op als dat nodig is. Geen mailinglijst.