Skip to main content
PATCH
Unallocate tasks in bulk

Request Structure

Key Fields

Behavior

  • Sets status to AVAILABLE for all specified tasks
  • Clears user assignment (user_id, assigned_at, start_at) for each task
  • Returns 204 No Content on success
  • Returns 422 if any task cannot be unallocated

Authorizations

Authorization
string
header
required

OAuth 2.0 authentication. Use the client credentials or authorization code flow to obtain an access token.

FlowAuthorization Code
Authorization URL
https://clarus-api.com/oauth/authorize
Token URL
https://clarus-api.com/oauth/token
FlowClient Credentials
Token URL
https://clarus-api.com/oauth/token
X-Clarus-Subdomain
string
header
required

The subdomain/tenant name identifying which tenant's data to access. Required for all API requests.

Body

application/json
ids
integer[]
required

Array of task IDs to unallocate

Response

Operation completed successfully with no content to return