Hopp til hovedinnholdet

Bygg på Tasked

Et REST API for prosjekter, oppgaver, kunder, ressurser, gjennomgangskommentarer og webhooks. Hvert svar inneholder en forespørsels-ID og API-versjonen; feil deler samme konvolutt.

Autentisering

Hver forespørsel inneholder en API-nøkkel for organisasjonen som et bearer-token: Authorization: Bearer tsk_live_... En nøkkel opprettes for én organisasjon med kun de omfangene den trenger, og kan trekkes tilbake når som helst.

Opprett og trekk tilbake nøkler under Organisasjonsinnstillinger, på Integrasjoner-fanen, under API-nøkler. API-et er inkludert i Business-planen.

Åpne organisasjonsinnstillinger

Omfang

En nøkkel inneholder et utvalg av disse omfangene; en forespørsel til et endepunkt utenfor disse vil bli avvist med 403.

  • projects:read
  • projects:write
  • tasks:read
  • tasks:write
  • clients:read
  • clients:write
  • assets:read
  • assets:write
  • reviews:read
  • webhooks:manage

Endepunkter

Endepunkter
MetodeStiHva det gjørOmfang
GET/api/v1/meThe organization and scopes behind this keyprojects:read
GET/api/v1/openapi.jsonThis OpenAPI 3.1 documentIngen nøkkel nødvendig
GET/api/v1/projectsList projectsprojects:read
POST/api/v1/projectsCreate a projectprojects:write
GET/api/v1/projects/{id}Get a projectprojects:read
GET/api/v1/tasksList taskstasks:read
POST/api/v1/tasksCreate a tasktasks:write
GET/api/v1/tasks/{id}Get a tasktasks:read
PATCH/api/v1/tasks/{id}Update a tasktasks:write
POST/api/v1/tasks/{id}/moveMove a task to a stagetasks:write
GET/api/v1/clientsList clientsclients:read
POST/api/v1/clientsCreate a clientclients:write
GET/api/v1/clients/{id}Get a clientclients:read
GET/api/v1/assetsList assetsassets:read
GET/api/v1/assets/{id}Get an assetassets:read
POST/api/v1/assets/uploadsInitiate a direct uploadassets:write
POST/api/v1/assets/uploads/{id}/finalizeConfirm an upload and write the versionassets:write
GET/api/v1/review-commentsList review comments on an assetreviews:read
GET/api/v1/webhooksList webhookswebhooks:manage
POST/api/v1/webhooksCreate a webhookwebhooks:manage
GET/api/v1/webhooks/{id}Get a webhookwebhooks:manage
PATCH/api/v1/webhooks/{id}Update a webhookwebhooks:manage
DELETE/api/v1/webhooks/{id}Delete a webhookwebhooks:manage
GET/api/v1/webhooks/{id}/deliveriesDelivery log of a webhookwebhooks:manage
POST/api/v1/webhooks/{id}/deliveries/{deliveryId}/replayReplay a deliverywebhooks:manage

OpenAPI-dokument

De samme rutene, forespørselstekstene og svarene som maskinlesbar OpenAPI 3.1, generert fra validatorene API-et kjører, slik at det ikke kan avvike fra dem.

Last ned openapi.json

Feil og grenser

En feil svarer med { error, errorCode, requestId, apiVersion }. En nøkkel kan sende 600 forespørsler i minuttet; utover dette er svaret 429. Send X-API-Version for å låse en versjon; en utgått versjon flagges i Deprecation-headeren.

Start uten kort

Fjorten dager, alt slått på. Opprett et arbeidsområde, fortell AI-en hvordan du jobber, og inviter en kunde til å godkjenne.

Spørsmål? Skriv til oss

Vi svarer direkte på nettstedet når vi kan, og en person følger opp om nødvendig. Ingen e-postliste.