Entwickle mit Tasked
Eine REST-API für Projekte, Tasks, Kunden, Assets, Review-Kommentare und Webhooks. Jede Antwort enthält eine Request-ID und die API-Version; Fehler teilen sich ein gemeinsames Envelope.
Authentifizierung
Jede Anfrage enthält einen API-Key der Organisation als Bearer-Token: Authorization: Bearer tsk_live_... Ein Key wird für eine bestimmte Organisation mit genau den benötigten Scopes erstellt und kann jederzeit widerrufen werden.
Erstelle und widerrufe Keys in den Organisationseinstellungen auf dem Tab „Integrationen“ unter „API-Keys“. Die API ist im Business-Tarif enthalten.
Organisationseinstellungen öffnenScopes
Ein Key enthält eine Untermenge dieser Scopes; Anfragen an Endpunkte außerhalb dieser Scopes werden mit 403 abgelehnt.
- projects:read
- projects:write
- tasks:read
- tasks:write
- clients:read
- clients:write
- assets:read
- assets:write
- reviews:read
- webhooks:manage
Endpunkte
| Methode | Pfad | Beschreibung | Scope |
|---|---|---|---|
| GET | /api/v1/me | The organization and scopes behind this key | projects:read |
| GET | /api/v1/openapi.json | This OpenAPI 3.1 document | Kein Key erforderlich |
| 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-Dokument
Dieselben Routen, Request-Bodys und Antworten als maschinenlesbares OpenAPI 3.1, generiert aus den Validatoren der API, sodass keine Abweichungen entstehen können.
openapi.json herunterladenFehler und Limits
Eine Fehlermeldung antwortet mit { error, errorCode, requestId, apiVersion }. Ein Key darf 600 Requests pro Minute senden; darüber hinaus lautet die Antwort 429. Sende X-API-Version, um eine Version festzulegen; eine veraltete Version wird im Deprecation-Header gekennzeichnet.
Ohne Kreditkarte starten
Vierzehn Tage, alle Funktionen freigeschaltet. Erstelle einen Workspace, erkläre der KI, wie du arbeitest, und lade einen Kunden zur Freigabe ein.
Eine Frage? Schreib uns
Wir antworten direkt hier auf der Website, wenn wir können, und bei Bedarf meldet sich ein Mitarbeiter bei dir. Kein Newsletter.