Assign User

Overview

This endpoint assigns a team member to a task, making them responsible for completing it. Assigned users see the task in their personal task list and receive notifications about changes. Tasks can have multiple assignees - call this endpoint multiple times with different user IDs to add more people. The user must be a member of the organization (get valid user IDs from the Get Board Members endpoint). If the task was accidentally archived by a user in StrikeOff, assigning someone to it will automatically unarchive it, ensuring your external system stays in sync.

When to Use This

• Assigning the appropriate team member when creating a task from an external ticket
• Routing tasks to specific users based on your external system's assignment rules
• Adding additional team members to collaborate on a task
• Implementing round-robin or load-balanced task assignment from your automation
• Syncing assignment changes from your project management tool to StrikeOff

Path Parameters

Request Body

Request Example

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

Response

{
  "success": true,
  "data": {
    "assignment": {
      "id": "classign001...",
      "user": {
        "id": "cluser002...",
        "name": "Bob Wilson",
        "email": "bob@example.com"
      },
      "assignedBy": {
        "id": "cluser001...",
        "name": "John Doe",
        "email": "john@example.com"
      },
      "assignedAt": "2024-01-20T10:00:00Z"
    }
  }
}

Notes

• Use the Get Board Members endpoint to find valid user IDs.
• The user must be a member of the organization.
• Returns 400 if the user is already assigned to this task.
• Tasks can have multiple assignees - calling this multiple times with different users adds each one.