Sample - Box Platform API
DELETE/task_assignments/{task_assignment_id}

Unassign a task

Deletes a specific task assignment. Use task_assignment_id to remove the assignment connecting a task to its assigned user. A successful deletion returns no response body.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
task_assignment_idstringrequired
The unique identifier of the task assignment to delete.

3 status codes
204Returns an empty response when the task assignment is successfully deleted.
404Returned when the task assignment does not exist or is inaccessible to the user's account.
typestringoptional
The value will always be `error`.
Allowed:error
statusintegeroptional
The HTTP status of the response.
codestringoptional
A Box-specific error code.
Allowed:createdacceptedno_contentredirectnot_modifiedbad_requestunauthorizedforbiddennot_foundmethod_not_allowedconflictprecondition_failed
messagestringoptional
A short message describing the error.
context_infoobjectoptional
A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis. `message` is only one example.
help_urlstringoptional
A URL that links to more information about why this error occurred.
request_idstringoptional
A unique identifier for this response, which can be used when contacting Box support.
defaultReturned when an unexpected client error occurs.
typestringoptional
The value will always be `error`.
Allowed:error
statusintegeroptional
The HTTP status of the response.
codestringoptional
A Box-specific error code.
Allowed:createdacceptedno_contentredirectnot_modifiedbad_requestunauthorizedforbiddennot_foundmethod_not_allowedconflictprecondition_failed
messagestringoptional
A short message describing the error.
context_infoobjectoptional
A free-form object that contains additional context about the error. The possible fields are defined on a per-endpoint basis. `message` is only one example.
help_urlstringoptional
A URL that links to more information about why this error occurred.
request_idstringoptional
A unique identifier for this response, which can be used when contacting Box support.

Error handling

A 404 is returned when task_assignment_id does not identify an accessible task assignment or the assignment is not accessible to the user's account. Ensure the identifier refers to the assignment you want to delete.