Flow
Menu

Reference

Withdraw an edge without erasing it

The retract-link tool, and the REST call it is generated from.

RESTDELETE /api/v1/task-links
MCPretract-link

Withdraws an edge without deleting it: it stops gating readiness and stays in the record, kept in the source task's history with its basis. Writing it again un-retracts it. An edge that is not there answers retracted: false, not an error.

Parameters

  • fromquery · required

    The source task's id.

  • toquery · required

    The target task's id.

  • kindquery · required

    The edge's kind, as get-task lists it.

  • basisquery · optional · array

    Why, kept in the task's history: a task_… (the standing rule you act under) or an http(s) URL. Optional; repeat for several.

  • saidquery · optional · string

    The person's answer that approved it, verbatim.

Responses

200Whether an edge was retracted
400The request body does not match the operation's schema

Generated from the spec this operation is implemented against, so the two names above cannot disagree with the surface a client sees.