Sign in

v1

latestOpenAPI 3.0.32026-08-0613775357.6 KB
assignments_per_user

Update user assignment

Updates the matching user assignment.

Typical parameters:

  • starts_at
  • ends_at
  • allocation_mode (percent, hours_per_day, fixed) and a value for the respective mode-named property (that is, a property named percent, hours_per_day, or fixed_hours)
  • status_option_id
  • description
  • note

Note: If you want to change an assignment to target a different project or phase, then delete the assignment and create a new assignment targeting the new project or phase.

put/users/{user_id}/assignments/{assignment_id}

Request body

OR
OR

Example request

{
  "allocation_mode": "percent",
  "percent": 0.2,
  "id": 889,
  "user_id": 5612,
  "assignable_id": 1234,
  "starts_at": "2025-09-17",
  "ends_at": "2025-12-17",
  "repetition_id": 886,
  "created_at": "2025-08-27T12:00:00Z",
  "updated_at": "2025-08-27T12:00:00Z",
  "all_day_assignment": true,
  "bill_rate": 100,
  "bill_rate_id": 58776516,
  "status_option_id": 1234567890
}

Response

The updated user assignment.

OR
OR

Example response

{
  "allocation_mode": "percent",
  "percent": 0.2,
  "id": 889,
  "user_id": 5612,
  "assignable_id": 1234,
  "starts_at": "2025-09-17",
  "ends_at": "2025-12-17",
  "repetition_id": 886,
  "created_at": "2025-08-27T12:00:00Z",
  "updated_at": "2025-08-27T12:00:00Z",
  "all_day_assignment": true,
  "bill_rate": 100,
  "bill_rate_id": 58776516,
  "status_option_id": 1234567890
}