Update user

PUT

/agent/integration/api/v1/users/users/{{user_id}}

Update a user in Spencer.

All fields need to be provided. If a field is left out, that value will be removed.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "firstname": "Jan Editor",
    "lastname": "Stevens",
    "alias": "",
    "email": "jan+onboarding@spencer.co",
    "employee_code": "13378",
    "manager_id": "61ad2534-7545-41c6-a0cc-f2cb2258b538",
    "preferred_language": "nl-NL",
    "country": "BE",
    "mobile": "+32487271693",
    "mobile_private": "+32477888888",
    "email_private": "nick@pencer.co",
    "company": "Spencer",
    "authentication_id": "jan+onboarding@spencer.co",
    "date_of_birth": "2024-10-31T00:00:00+00:00",
    "authentication_type": "username_password",
    "translations": [
        {
            "locale": "de-DE",
            "contract_type": "intern",
            "department": "Sales de_DE",
            "division": "Division 3 de_DE",
            "sub_division": "Sub-division 3 de_DE",
            "job_title": "Support engineer de_DE",
            "domain": "Domain 3 de_DE",
            "region": "Paris de_DE",
            "zone": "Zone 2 de_DE"
        },
        {
            "locale": "en-US",
            "contract_type": "intern",
            "department": "Sales en_US",
            "division": "Division",
            "sub_division": "Subdivision",
            "job_title": "Support engineer",
            "domain": "Domain",
            "region": "Paris UPDATED",
            "zone": "Zone"
        },
        {
            "locale": "es-ES",
            "contract_type": "intern",
            "department": "Sales es_ES",
            "division": "Division 3 es_ES",
            "sub_division": "Sub-division 3 es_ES",
            "job_title": "Support engineer es_ES",
            "domain": "Domain 3 es_ES",
            "region": "Paris es_ES",
            "zone": "Zone 2 es_ES"
        },
        {
            "locale": "fr-BE",
            "contract_type": "intern",
            "department": "Sales fr_BE",
            "division": "Division 3 fr_BE",
            "sub_division": "Sub-division 3 fr_BE",
            "job_title": "Support engineer fr_BE",
            "domain": "Domain 3 fr_BE",
            "region": "Paris fr_BE",
            "zone": "Zone 2 fr_BE"
        },
        {
            "locale": "hr-HR",
            "contract_type": "intern",
            "department": "Sales hr_HR",
            "division": "Division 3 hr_HR",
            "sub_division": "Sub-division 3 hr_HR",
            "job_title": "Support engineer hr_HR",
            "domain": "Domain 3 hr_HR",
            "region": "Paris hr_HR",
            "zone": "Zone 2 hr_HR"
        },
        {
            "locale": "hu-HU",
            "contract_type": "intern",
            "department": "Sales hu_HU",
            "division": "Division 3 hu_HU",
            "sub_division": "Sub-division 3 hu_HU",
            "job_title": "Support engineer hu_HU",
            "domain": "Domain 3 hu_HU",
            "region": "Paris hu_HU",
            "zone": "Zone 2 hu_HU"
        },
        {
            "locale": "it-IT",
            "contract_type": "intern",
            "department": "Sales it_IT",
            "division": "Division 3 it_IT",
            "sub_division": "Sub-division 3 it_IT",
            "job_title": "Support engineer it_IT",
            "domain": "Domain 3 it_IT",
            "region": "Paris it_IT",
            "zone": "Zone 2 it_IT"
        },
        {
            "locale": "mr-IN",
            "contract_type": "intern",
            "department": "Sales mr_IN",
            "division": "Division 3 mr_IN",
            "sub_division": "Sub-division 3 mr_IN",
            "job_title": "Support engineer mr_IN",
            "domain": "Domain 3 mr_IN",
            "region": "Paris mr_IN",
            "zone": "Zone 2 mr_IN"
        },
        {
            "locale": "nb-NO",
            "contract_type": "intern",
            "department": "Sales nb_NO",
            "division": "Division 3 nb_NO",
            "sub_division": "Sub-division 3 nb_NO",
            "job_title": "Support engineer nb_NO",
            "domain": "Domain 3 nb_NO",
            "region": "Paris nb_NO",
            "zone": "Zone 2 nb_NO"
        },
        {
            "locale": "nl-BE",
            "contract_type": "intern",
            "department": "Sales UPDATED nl_BE",
            "division": "Division 3 nl_BE",
            "sub_division": "Sub-division 3 nl_BE",
            "job_title": "Support engineer UPDATED nl_BE",
            "domain": "Domain 3 nl_BE",
            "region": "Paris nl_BE",
            "zone": "Zone 2 nl_BE"
        },
        {
            "locale": "pl-PL",
            "contract_type": "intern",
            "department": "Sales pl_PL",
            "division": "Division 3 pl_PL",
            "sub_division": "Sub-division 3 pl_PL",
            "job_title": "Support engineer pl_PL",
            "domain": "Domain 3 pl_PL",
            "region": "Paris pl_PL",
            "zone": "Zone 2 pl_PL"
        },
        {
            "locale": "ro-RO",
            "contract_type": "intern",
            "department": "Sales ro_RO",
            "division": "Division 3 ro_RO",
            "sub_division": "Sub-division 3 ro_RO",
            "job_title": "Support engineer ro_RO",
            "domain": "Domain 3 ro_RO",
            "region": "Paris ro_RO",
            "zone": "Zone 2 ro_RO"
        },
        {
            "locale": "sl-SI",
            "contract_type": "intern",
            "department": "Sales sl_SI",
            "division": "Division 3 sl_SI",
            "sub_division": "Sub-division 3 sl_SI",
            "job_title": "Support engineer sl_SI",
            "domain": "Domain 3 sl_SI",
            "region": "Paris sl_SI",
            "zone": "Zone 2 sl_SI"
        },
        {
            "locale": "tr-TR",
            "contract_type": "intern",
            "department": "Sales tr_TR",
            "division": "Division 3 tr_TR",
            "sub_division": "Sub-division 3 tr_TR",
            "job_title": "Support engineer tr_TR",
            "domain": "Domain 3 tr_TR",
            "region": "Paris tr_TR",
            "zone": "Zone 2 tr_TR"
        },
        {
            "locale": "zh-CN",
            "contract_type": "intern",
            "department": "Sales zh_CN",
            "division": "Division 3 zh_CN",
            "sub_division": "Sub-division 3 zh_CN",
            "job_title": "Support engineer zh_CN",
            "domain": "Domain 3 zh_CN",
            "region": "Paris zh_CN",
            "zone": "Zone 2 zh_CN"
        }
    ],
    "user_identifiers": [],
    "default_site_id": "delight_hq"
}

Request Code Samples

Shell

HTTP

curl --location --globoff --request PUT '/agent/integration/api/v1/users/users/{{user_id}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "firstname": "Jan Editor",
    "lastname": "Stevens",
    "alias": "",
    "email": "jan+onboarding@spencer.co",
    "employee_code": "13378",
    "manager_id": "61ad2534-7545-41c6-a0cc-f2cb2258b538",
    "preferred_language": "nl-NL",
    "country": "BE",
    "mobile": "+32487271693",
    "mobile_private": "+32477888888",
    "email_private": "nick@pencer.co",
    "company": "Spencer",
    "authentication_id": "jan+onboarding@spencer.co",
    "date_of_birth": "2024-10-31T00:00:00+00:00",
    "authentication_type": "username_password",
    "translations": [
        {
            "locale": "de-DE",
            "contract_type": "intern",
            "department": "Sales de_DE",
            "division": "Division 3 de_DE",
            "sub_division": "Sub-division 3 de_DE",
            "job_title": "Support engineer de_DE",
            "domain": "Domain 3 de_DE",
            "region": "Paris de_DE",
            "zone": "Zone 2 de_DE"
        },
        {
            "locale": "en-US",
            "contract_type": "intern",
            "department": "Sales en_US",
            "division": "Division",
            "sub_division": "Subdivision",
            "job_title": "Support engineer",
            "domain": "Domain",
            "region": "Paris UPDATED",
            "zone": "Zone"
        },
        {
            "locale": "es-ES",
            "contract_type": "intern",
            "department": "Sales es_ES",
            "division": "Division 3 es_ES",
            "sub_division": "Sub-division 3 es_ES",
            "job_title": "Support engineer es_ES",
            "domain": "Domain 3 es_ES",
            "region": "Paris es_ES",
            "zone": "Zone 2 es_ES"
        },
        {
            "locale": "fr-BE",
            "contract_type": "intern",
            "department": "Sales fr_BE",
            "division": "Division 3 fr_BE",
            "sub_division": "Sub-division 3 fr_BE",
            "job_title": "Support engineer fr_BE",
            "domain": "Domain 3 fr_BE",
            "region": "Paris fr_BE",
            "zone": "Zone 2 fr_BE"
        },
        {
            "locale": "hr-HR",
            "contract_type": "intern",
            "department": "Sales hr_HR",
            "division": "Division 3 hr_HR",
            "sub_division": "Sub-division 3 hr_HR",
            "job_title": "Support engineer hr_HR",
            "domain": "Domain 3 hr_HR",
            "region": "Paris hr_HR",
            "zone": "Zone 2 hr_HR"
        },
        {
            "locale": "hu-HU",
            "contract_type": "intern",
            "department": "Sales hu_HU",
            "division": "Division 3 hu_HU",
            "sub_division": "Sub-division 3 hu_HU",
            "job_title": "Support engineer hu_HU",
            "domain": "Domain 3 hu_HU",
            "region": "Paris hu_HU",
            "zone": "Zone 2 hu_HU"
        },
        {
            "locale": "it-IT",
            "contract_type": "intern",
            "department": "Sales it_IT",
            "division": "Division 3 it_IT",
            "sub_division": "Sub-division 3 it_IT",
            "job_title": "Support engineer it_IT",
            "domain": "Domain 3 it_IT",
            "region": "Paris it_IT",
            "zone": "Zone 2 it_IT"
        },
        {
            "locale": "mr-IN",
            "contract_type": "intern",
            "department": "Sales mr_IN",
            "division": "Division 3 mr_IN",
            "sub_division": "Sub-division 3 mr_IN",
            "job_title": "Support engineer mr_IN",
            "domain": "Domain 3 mr_IN",
            "region": "Paris mr_IN",
            "zone": "Zone 2 mr_IN"
        },
        {
            "locale": "nb-NO",
            "contract_type": "intern",
            "department": "Sales nb_NO",
            "division": "Division 3 nb_NO",
            "sub_division": "Sub-division 3 nb_NO",
            "job_title": "Support engineer nb_NO",
            "domain": "Domain 3 nb_NO",
            "region": "Paris nb_NO",
            "zone": "Zone 2 nb_NO"
        },
        {
            "locale": "nl-BE",
            "contract_type": "intern",
            "department": "Sales UPDATED nl_BE",
            "division": "Division 3 nl_BE",
            "sub_division": "Sub-division 3 nl_BE",
            "job_title": "Support engineer UPDATED nl_BE",
            "domain": "Domain 3 nl_BE",
            "region": "Paris nl_BE",
            "zone": "Zone 2 nl_BE"
        },
        {
            "locale": "pl-PL",
            "contract_type": "intern",
            "department": "Sales pl_PL",
            "division": "Division 3 pl_PL",
            "sub_division": "Sub-division 3 pl_PL",
            "job_title": "Support engineer pl_PL",
            "domain": "Domain 3 pl_PL",
            "region": "Paris pl_PL",
            "zone": "Zone 2 pl_PL"
        },
        {
            "locale": "ro-RO",
            "contract_type": "intern",
            "department": "Sales ro_RO",
            "division": "Division 3 ro_RO",
            "sub_division": "Sub-division 3 ro_RO",
            "job_title": "Support engineer ro_RO",
            "domain": "Domain 3 ro_RO",
            "region": "Paris ro_RO",
            "zone": "Zone 2 ro_RO"
        },
        {
            "locale": "sl-SI",
            "contract_type": "intern",
            "department": "Sales sl_SI",
            "division": "Division 3 sl_SI",
            "sub_division": "Sub-division 3 sl_SI",
            "job_title": "Support engineer sl_SI",
            "domain": "Domain 3 sl_SI",
            "region": "Paris sl_SI",
            "zone": "Zone 2 sl_SI"
        },
        {
            "locale": "tr-TR",
            "contract_type": "intern",
            "department": "Sales tr_TR",
            "division": "Division 3 tr_TR",
            "sub_division": "Sub-division 3 tr_TR",
            "job_title": "Support engineer tr_TR",
            "domain": "Domain 3 tr_TR",
            "region": "Paris tr_TR",
            "zone": "Zone 2 tr_TR"
        },
        {
            "locale": "zh-CN",
            "contract_type": "intern",
            "department": "Sales zh_CN",
            "division": "Division 3 zh_CN",
            "sub_division": "Sub-division 3 zh_CN",
            "job_title": "Support engineer zh_CN",
            "domain": "Domain 3 zh_CN",
            "region": "Paris zh_CN",
            "zone": "Zone 2 zh_CN"
        }
    ],
    "user_identifiers": [],
    "default_site_id": "delight_hq"
}'

Responses

🟢200200.user

application/json

Headers

Bodyapplication/json

Example

{"id":"ipsum conse","firstname":"Duis nulla in","lastname":"dolor dolor","email":"commodo consectetur deserunt","manager_id":"Ut mollit","preferred_language":"dolore sed esse ex","country":"sit ea enim occaecat do","company_join_date":"1985-10-08T09:08:36.336Z","phone_private":"velit","mobile":"veniam Duis eu proident enim","email_private":"labore laborum","workstation":"nostrud ad ullamco qui","subsidiary":"Excepteur occaecat","company":"esse minim","date_of_birth":"1942-10-06T20:21:57.861Z","translations":[{"locale":"consectetur reprehenderit","contract_type":"anim veniam incididunt","department":"velit","division":"aliquip","sub_division":"laboris tempor","job_title":"laborum","domain":"officia veniam et minim dolore","region":"mollit Duis ipsum","zone":"Lorem"}],"user_identifiers":[{"identifier_key":"ad","value":"9777449"},{"identifier_key":"minim anim ad","value":"qui"}],"tags":[{"id":"TAG1"},{"id":"TAG2"},{"id":"TAG3"}]}

🟠400400.badRequest

🟠401401.unauthorized

🟠403403.forbidden

🟠404404.notFound

🔴500500.internalServerError

Fetch user

Delete user