Développer sur Tasked
Une API REST pour les projets, les tâches, les clients, les fichiers, les commentaires de review et les webhooks. Chaque réponse contient un identifiant de requête et la version de l'API ; les erreurs partagent une enveloppe commune.
Authentification
Chaque requête contient une clé API d'organisation sous forme de bearer token : Authorization: Bearer tsk_live_... Une clé est générée pour une organisation avec uniquement les scopes dont elle a besoin, et peut être révoquée à tout moment.
Créez et révoquez des clés dans les paramètres de l'organisation, sous l'onglet Intégrations, dans la section Clés API. L'API est incluse dans le forfait Business.
Ouvrir les paramètres de l'organisationScopes
Une clé contient un sous-ensemble de ces scopes ; toute requête vers un endpoint en dehors de ceux-ci est rejetée avec une erreur 403.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Endpoints
| Méthode | Chemin | Description | Scope |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Aucune clé requise |
| 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 |
Document OpenAPI
Les mêmes routes, corps de requêtes et réponses au format OpenAPI 3.1 lisible par machine, générés à partir des validateurs exécutés par l'API, ce qui garantit l'absence de dérive.
Télécharger openapi.jsonErreurs et limites
Une erreur renvoie { error, errorCode, requestId, apiVersion }. Une clé peut envoyer 600 requêtes par minute ; au-delà, la réponse est 429. Envoyez X-API-Version pour figer une version ; une version obsolète est signalée dans l'en-tête Deprecation.
Commencer sans carte
Quatorze jours, toutes fonctionnalités incluses. Créez un espace de travail, expliquez à l'IA comment vous travaillez et invitez un client à valider.
Une question ? Écrivez-nous
Nous répondons directement depuis le site quand nous le pouvons, et une personne prend le relais si nécessaire. Pas de liste de diffusion.