Skip to main content
PUT
/
v2
/
integrations
/
users
/
{id}
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "position": "Lead Developer",
  "role_id": 3,
  "daily_hours": 8,
  "user_position_id": "external-user-position-2",
  "seniority_id": "external_seniority_id_20",
  "hourly_rate_effective_from": "2025-03-01"
}'

{
  "id": 8546,
  "email": "john.doe@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1 555-0100",
  "role_id": 3,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}
Updates an existing user in your COR instance using their external ID. Only provided fields will be updated.

​
Path Parameters

​
id
string
required
External user ID that was used when creating the user

​
Request Body Requirements

​
metadata
object
required
​
first_name
string
Updated first name
​
last_name
string
Updated last name
​
phone
string
Updated phone number
​
position
string
Updated job position
​
department
string
Updated department
​
role_id
number
Updated COR role ID
​
daily_hours
number
Updated daily hours capacity
​
user_position_id
string
External position ID. The position must have been previously created through the integrations API. Updates the user’s position assignment.
​
seniority_id
string
External seniority ID. The seniority must have been previously created through the integrations API. Updates the user’s seniority level.
​
hourly_rate_effective_from
string
Date from which the hourly rate becomes effective. Must be a valid date format (YYYY-MM-DD).

​
Known Errors

  • ZC001 — Entity is not associated (user with the specified external ID not found)
  • UserNotFoundError — No user found with the specified external ID for this source
  • ValidationError — Missing required metadata.source field
  • InvalidRoleError — The role_id is not a valid COR role
  • ValidationError — The hourly_rate_effective_from field must be a valid date
curl --location --request PUT 'https://integrations.projectcor.com/v2/integrations/users/OKTA-USER-12345' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
  "metadata": {
    "source": "OKTA"
  },
  "position": "Lead Developer",
  "role_id": 3,
  "daily_hours": 8,
  "user_position_id": "external-user-position-2",
  "seniority_id": "external_seniority_id_20",
  "hourly_rate_effective_from": "2025-03-01"
}'

{
  "id": 8546,
  "email": "john.doe@company.com",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+1 555-0100",
  "role_id": 3,
  "daily_hours": 8,
  "company_id": 1234,
  "created_at": "2025-01-10T14:30:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}