Disconnect a component item from its associated task(s)

Disconnect a component item from its associated task(s). Optionally, the associated task(s) can be deleted after disconnection by setting deleteTask to true. All tasks connected to the item via entityUniqueId will be disconnected. If no tasks are connected to the item, a 404 error will be returned.

POST/projects/{projectId}/items/{itemId}/tasks/disconnect

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

itemIdstringrequired

Request body

requiredapplication/json

deleteTaskbooleanrequired

Whether to delete the associated task(s) after disconnecting

Responses

200

Item successfully disconnected from task(s)

successboolean

400

Invalid request: invalid projectId or itemId format, or validation error in request body

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions to manage components or access to project denied

404

Project not found, item not found, item does not belong to the project, or no tasks are connected to the item

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

projectIdpath*itemIdpath*

Bodyapplication/json

deleteTaskboolean*Whether to delete the associated task(s) after disconnecting

Request

curl -X POST "https://leadtime.app/api/public/projects/string/items/string/tasks/disconnect" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "deleteTask": false
}'

const response = await fetch("https://leadtime.app/api/public/projects/string/items/string/tasks/disconnect", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"deleteTask\": false\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/projects/string/items/string/tasks/disconnect",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"deleteTask\": false\n}",
)

Response

{
  "success": true
}