ts.dmd.cancel

Cancel a demand with a reason.

Cancel a demand with a reason.

Requires authentication

Description

Convenience tool to cancel a demand. Equivalent to calling ts.dmd.update with status “canceled” and a canceled_reason, but with a simpler interface.

Both id and reason are required.

Parameters

NameTypeRequiredDefaultDescription
idstringYesDemand ID to cancel
reasonstringYesReason for cancellation

Response

Returns the demand ID and list of fields that were updated.

{
  "id": "dmd_a1b2c3d4e5f6...",
  "updated_at": "2026-02-16T10:00:00Z",
  "updated_fields": [
    "status",
    "canceled_reason"
  ]
}

Errors

CodeDescription
not_authenticatedNo active login for this session
not_foundDemand with this ID does not exist
invalid_inputDemand ID or reason is missing
invalid_transitionDemand cannot be canceled from its current status

Examples

Cancel a demand

Cancel a demand that is no longer relevant.

Request:

{
  "id": "dmd_a1b2c3d4e5f6...",
  "reason": "No longer needed after scope change"
}

Response:

{
  "id": "dmd_a1b2c3d4e5f6...",
  "updated_at": "2026-02-16T10:00:00Z",
  "updated_fields": [
    "status",
    "canceled_reason"
  ]
}