1. Users
Spencer Integration API
  • Spencer Integration API
  • Identity
    • Request access token
      POST
  • News
    • Fetch news publications
      GET
    • Fetch news publications for userlist
      GET
    • Create news draft
      POST
  • Users
    • Create user
      POST
    • Fetch user
      GET
    • Update user
      PUT
    • Delete user
      DELETE
    • Check if user exists
      HEAD
    • Add user profile picture
      POST
    • Create user tag
      POST
    • Update user tag
      PUT
    • Check if user tag exists
      HEAD
  • Document library
    • Fetch node
      GET
  • Notifications
    • Create notification
      POST
  1. Users

Update user

PUT
/agent/integration/api/v1/users/users/762384
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
{
    "id": "agent_api_test_id",
    "firstname": "Monika",
    "lastname": "Rodak",
    "alias": "monika_agent_api",
    "email": "monika+agentapi@spencer.co",
    "preferred_language": "en-US",
    "country": "BE",
    "company_join_date": "2019-02-18T00:00:00+00:00",
    "mobile": "+32488132358",
    "email_private": "monika.anna.rodak+delighterstag@gmail.com",
    "company": "Spencer",
    "authentication_id": "monika+agentapi@spencer.co",
    "date_of_birth": "1992-07-27T00:00:00+00:00",
    "authentication_type": "username_password",
    "translations": [
        {
            "locale": "da_DK",
            "sub_division": "test subdivision da update"
        },
        {
            "locale": "de_DE",
            "contract_type": "full-time",
            "department": "Design de_DE",
            "division": "Division 2 de_DE",
            "job_title": "Engineer de_DE",
            "domain": "Domain 2 de_DE",
            "region": "Gent de_DE",
            "zone": "Zone 2 de_DE"
        },
        {
            "locale": "en_US",
            "contract_type": "full-time",
            "department": "Engineering",
            "job_title": "Software engineer",
            "zone": "Test update"
        },
        {
            "locale": "es_ES",
            "contract_type": "full-time",
            "department": "Design es_ES",
            "division": "Division 2 es_ES",
            "job_title": "Engineer es_ES",
            "domain": "Domain 2 es_ES",
            "region": "Gent es_ES",
            "zone": "Zone 2 es_ES"
        },
        {
            "locale": "fr_BE",
            "contract_type": "full-time",
            "department": "Design fr_BE",
            "division": "Division 2 fr_BE",
            "job_title": "Engineer fr_BE",
            "domain": "Domain 2 fr_BE",
            "region": "Gent fr_BE",
            "zone": "Zone 2 fr_BE"
        },
        {
            "locale": "hr_HR",
            "contract_type": "full-time",
            "department": "Design hr_HR",
            "division": "Division 2 hr_HR",
            "job_title": "Engineer hr_HR",
            "domain": "Domain 2 hr_HR",
            "region": "Gent hr_HR",
            "zone": "Zone 2 hr_HR"
        },
        {
            "locale": "hu_HU",
            "contract_type": "full-time",
            "department": "Design hu_HU",
            "division": "Division 2 hu_HU",
            "job_title": "Engineer hu_HU",
            "domain": "Domain 2 hu_HU",
            "region": "Gent hu_HU",
            "zone": "Zone 2 hu_HU"
        },
        {
            "locale": "it_IT",
            "contract_type": "full-time",
            "department": "Design it_IT",
            "division": "Division 2 it_IT",
            "job_title": "Engineer it_IT",
            "domain": "Domain 2 it_IT",
            "region": "Gent it_IT",
            "zone": "Zone 2 it_IT"
        },
        {
            "locale": "mr_IN",
            "contract_type": "full-time",
            "department": "Design mr_IN",
            "division": "Division 2 mr_IN",
            "job_title": "Engineer mr_IN",
            "domain": "Domain 2 mr_IN",
            "region": "Gent mr_IN",
            "zone": "Zone 2 mr_IN"
        },
        {
            "locale": "nb_NO",
            "contract_type": "full-time",
            "department": "Design nb_NO",
            "division": "Division 2 nb_NO",
            "job_title": "Engineer nb_NO",
            "domain": "Domain 2 nb_NO",
            "region": "Gent nb_NO",
            "zone": "Zone 2 nb_NO"
        },
        {
            "locale": "nl_BE",
            "contract_type": "full-time",
            "department": "Design nl_BE",
            "division": "Division 2 nl_BE",
            "job_title": "Engineer nl_BE",
            "domain": "Domain 2 nl_BE",
            "region": "Gent nl_BE",
            "zone": "Zone 2 nl_BE update"
        },
        {
            "locale": "pl_PL",
            "contract_type": "full-time",
            "department": "Design pl_PL",
            "division": "Division 2 pl_PL",
            "job_title": "Engineer pl_PL",
            "domain": "Domain 2 pl_PL",
            "region": "Gent pl_PL",
            "zone": "Zone 2 pl_PL"
        },
        {
            "locale": "ro_RO",
            "contract_type": "full-time",
            "department": "Design ro_RO",
            "division": "Division 2 ro_RO",
            "job_title": "Engineer ro_RO",
            "domain": "Domain 2 ro_RO",
            "region": "Gent ro_RO",
            "zone": "Zone 2 ro_RO"
        },
        {
            "locale": "sl_SI",
            "contract_type": "full-time",
            "department": "Design sl_SI",
            "division": "Division 2 sl_SI",
            "job_title": "Engineer sl_SI",
            "domain": "Domain 2 sl_SI",
            "region": "Gent sl_SI",
            "zone": "Zone 2 sl_SI"
        },
        {
            "locale": "tr_TR",
            "contract_type": "full-time",
            "department": "Design tr_TR",
            "division": "Division 2 tr_TR",
            "job_title": "Engineer tr_TR",
            "domain": "Domain 2 tr_TR",
            "region": "Gent tr_TR",
            "zone": "Zone 2 tr_TR"
        },
        {
            "locale": "zh_CN",
            "contract_type": "full-time",
            "department": "Design zh_CN",
            "division": "Division 2 zh_CN",
            "job_title": "Engineer zh_CN",
            "domain": "Domain 2 zh_CN",
            "region": "Gent zh_CN",
            "zone": "Zone 2 zh_CN"
        }
    ],
    "user_identifiers": [],
    "tags": ["Tasks","id_backend"],
    "default_site_id": "1234",
    "special_field": "special field value"
}

Request Code Samples

Shell
HTTP
Request Request Example
Shell
HTTP
curl --location --request PUT '/agent/integration/api/v1/users/users/762384' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "agent_api_test_id",
    "firstname": "Monika",
    "lastname": "Rodak",
    "alias": "monika_agent_api",
    "email": "monika+agentapi@spencer.co",
    "preferred_language": "en-US",
    "country": "BE",
    "company_join_date": "2019-02-18T00:00:00+00:00",
    "mobile": "+32488132358",
    "email_private": "monika.anna.rodak+delighterstag@gmail.com",
    "company": "Spencer",
    "authentication_id": "monika+agentapi@spencer.co",
    "date_of_birth": "1992-07-27T00:00:00+00:00",
    "authentication_type": "username_password",
    "translations": [
        {
            "locale": "da_DK",
            "sub_division": "test subdivision da update"
        },
        {
            "locale": "de_DE",
            "contract_type": "full-time",
            "department": "Design de_DE",
            "division": "Division 2 de_DE",
            "job_title": "Engineer de_DE",
            "domain": "Domain 2 de_DE",
            "region": "Gent de_DE",
            "zone": "Zone 2 de_DE"
        },
        {
            "locale": "en_US",
            "contract_type": "full-time",
            "department": "Engineering",
            "job_title": "Software engineer",
            "zone": "Test update"
        },
        {
            "locale": "es_ES",
            "contract_type": "full-time",
            "department": "Design es_ES",
            "division": "Division 2 es_ES",
            "job_title": "Engineer es_ES",
            "domain": "Domain 2 es_ES",
            "region": "Gent es_ES",
            "zone": "Zone 2 es_ES"
        },
        {
            "locale": "fr_BE",
            "contract_type": "full-time",
            "department": "Design fr_BE",
            "division": "Division 2 fr_BE",
            "job_title": "Engineer fr_BE",
            "domain": "Domain 2 fr_BE",
            "region": "Gent fr_BE",
            "zone": "Zone 2 fr_BE"
        },
        {
            "locale": "hr_HR",
            "contract_type": "full-time",
            "department": "Design hr_HR",
            "division": "Division 2 hr_HR",
            "job_title": "Engineer hr_HR",
            "domain": "Domain 2 hr_HR",
            "region": "Gent hr_HR",
            "zone": "Zone 2 hr_HR"
        },
        {
            "locale": "hu_HU",
            "contract_type": "full-time",
            "department": "Design hu_HU",
            "division": "Division 2 hu_HU",
            "job_title": "Engineer hu_HU",
            "domain": "Domain 2 hu_HU",
            "region": "Gent hu_HU",
            "zone": "Zone 2 hu_HU"
        },
        {
            "locale": "it_IT",
            "contract_type": "full-time",
            "department": "Design it_IT",
            "division": "Division 2 it_IT",
            "job_title": "Engineer it_IT",
            "domain": "Domain 2 it_IT",
            "region": "Gent it_IT",
            "zone": "Zone 2 it_IT"
        },
        {
            "locale": "mr_IN",
            "contract_type": "full-time",
            "department": "Design mr_IN",
            "division": "Division 2 mr_IN",
            "job_title": "Engineer mr_IN",
            "domain": "Domain 2 mr_IN",
            "region": "Gent mr_IN",
            "zone": "Zone 2 mr_IN"
        },
        {
            "locale": "nb_NO",
            "contract_type": "full-time",
            "department": "Design nb_NO",
            "division": "Division 2 nb_NO",
            "job_title": "Engineer nb_NO",
            "domain": "Domain 2 nb_NO",
            "region": "Gent nb_NO",
            "zone": "Zone 2 nb_NO"
        },
        {
            "locale": "nl_BE",
            "contract_type": "full-time",
            "department": "Design nl_BE",
            "division": "Division 2 nl_BE",
            "job_title": "Engineer nl_BE",
            "domain": "Domain 2 nl_BE",
            "region": "Gent nl_BE",
            "zone": "Zone 2 nl_BE update"
        },
        {
            "locale": "pl_PL",
            "contract_type": "full-time",
            "department": "Design pl_PL",
            "division": "Division 2 pl_PL",
            "job_title": "Engineer pl_PL",
            "domain": "Domain 2 pl_PL",
            "region": "Gent pl_PL",
            "zone": "Zone 2 pl_PL"
        },
        {
            "locale": "ro_RO",
            "contract_type": "full-time",
            "department": "Design ro_RO",
            "division": "Division 2 ro_RO",
            "job_title": "Engineer ro_RO",
            "domain": "Domain 2 ro_RO",
            "region": "Gent ro_RO",
            "zone": "Zone 2 ro_RO"
        },
        {
            "locale": "sl_SI",
            "contract_type": "full-time",
            "department": "Design sl_SI",
            "division": "Division 2 sl_SI",
            "job_title": "Engineer sl_SI",
            "domain": "Domain 2 sl_SI",
            "region": "Gent sl_SI",
            "zone": "Zone 2 sl_SI"
        },
        {
            "locale": "tr_TR",
            "contract_type": "full-time",
            "department": "Design tr_TR",
            "division": "Division 2 tr_TR",
            "job_title": "Engineer tr_TR",
            "domain": "Domain 2 tr_TR",
            "region": "Gent tr_TR",
            "zone": "Zone 2 tr_TR"
        },
        {
            "locale": "zh_CN",
            "contract_type": "full-time",
            "department": "Design zh_CN",
            "division": "Division 2 zh_CN",
            "job_title": "Engineer zh_CN",
            "domain": "Domain 2 zh_CN",
            "region": "Gent zh_CN",
            "zone": "Zone 2 zh_CN"
        }
    ],
    "user_identifiers": [],
    "tags": ["Tasks","id_backend"],
    "default_site_id": "1234",
    "special_field": "special field value"
}'

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
Previous
Fetch user
Next
Delete user
Built with