Remove a form instance from a task

Deletes the instance from the task. Use formInstanceId from GET /tasks/{identifier}/form-instances. To attach again later, pick a template id from GET /workspace/form-templates.

DELETE/tasks/{identifier}/form-instances/{formInstanceId}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

identifierstringrequired

Task UUID or shortNumber

formInstanceIdstring<uuid>required

Form instance UUID from GET /tasks/{identifier}/form-instances.

Responses

200

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

identifierpath*Task UUID or shortNumberformInstanceIdpath*Form instance UUID from GET `/tasks/{identifier}/form-instances`.

Request

curl -X DELETE "https://leadtime.app/api/public/tasks/string/form-instances/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/tasks/string/form-instances/497f6eca-6276-4993-bfeb-53cbbbba6f08", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.delete(
    "https://leadtime.app/api/public/tasks/string/form-instances/497f6eca-6276-4993-bfeb-53cbbbba6f08",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

No example response.