Skip to main content
PUT
Associates one or more users with an existing contract. After the refactor, each user must be sent as an object with id and a non-empty dates array. The endpoint supports partial processing (partial_success): valid assignments are attached while rejected users or rejected date ranges are returned in errors.

Path Parameters

string
required
External contract ID

Request Body Requirements

object
required
array
required
Array of users to attach. Each item must include an external id and at least one date range in dates.

Known Errors

  • ContractNotFoundError — No contract found with the specified external ID
  • ValidationError — Missing required fields, invalid users schema, or empty dates array for any user
  • CE001 — User association not found in COR (error_code: USER_ASSOCIATION_NOT_FOUND)
  • UnprocessableEntity (422) — Upstream attach validation errors are returned in the endpoint response body
  • Partial success date validation — A user can be partially attached while one or more date ranges are rejected (message: "Partial success. Some dates were rejected")