POST/tasks/:taskId/unassign

Unassign User

Removes a user assignment from a task. The task will no longer appear in the user's assigned tasks.

Overview

This endpoint removes a user's assignment from a task. After unassignment, the task will no longer appear in that user's personal task list, and they will stop receiving notifications about it. The task itself remains unchanged - only the assignment is removed. Other assignees (if any) remain assigned. Use this when responsibility for a task shifts to someone else, or when the original assignee is no longer available. If the task was accidentally archived by a user in StrikeOff, unassigning someone from it will automatically unarchive it, ensuring your external system stays in sync.

When to Use This

  • Removing an assignee when the corresponding assignment is removed in your external system
  • Reassigning work by unassigning the current person before assigning someone new
  • Cleaning up assignments when a team member leaves or changes roles
  • Syncing unassignment actions from your project management tool
  • Removing an assignee who was added by mistake

Path Parameters

ParameterTypeDescription
taskIdrequiredstringThe unique identifier of the task

Request Body

FieldTypeRequiredDescription
userIdstringrequiredID of the user to unassign

Request Example

cURL
curl -X POST "https://strikeoffapp.com/api/external/v1/tasks/cltask001/unassign" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "cluser002..."
  }'

Response

JSON
{
  "success": true,
  "data": {
    "message": "User unassigned successfully",
    "unassignedUser": {
      "id": "cluser002...",
      "name": "Bob Wilson",
      "email": "bob@example.com"
    }
  }
}

Notes

  • Returns 400 if the user is not currently assigned to this task.
  • Other assignees remain assigned to the task.
  • The task is not deleted - only the user assignment is removed.