SIsivo
Core resources

Update a user

Changed on
patch/users/{id}

Request

  • Base URL
    https://core.sivo.com
  • Auth
    • API key in header Authorization
    • or OAuth 2
      Authorization codehttps://dashboard.sivo.com/oauth/authorize
      Client credentials
      Token URLhttps://core.sivo.com/oauth/token
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

An object id with prefix

Example:user_0123456789ABCDEFGHIJKLMNOPq

Headers

if-matchstring date-time required

ETag value for Optimistic Concurrency Control (OCC). Should contain the last known updated_at timestamp in ISO 8601 format.

Example:2024-01-15T10:30:00Z

Request body

given_namestring nullable

Non-empty text string

family_namestring nullable

Non-empty text string

picturestring uri nullable

HTTP(S) URL

namestring nullable

Non-empty text string

zoneinfostring nullable

IANA timezone identifier

localestring nullable

BCP 47 locale

Example request

{
  "picture": "https://www.acme.com",
  "zoneinfo": "America/New_York",
  "locale": "en-US"
}

Response

Successful operation

given_namestring

Non-empty text string

family_namestring

Non-empty text string

picturestring uri

HTTP(S) URL

namestring

Non-empty text string

zoneinfostring

IANA timezone identifier

localestring

BCP 47 locale

emailstring email

An email address

phone_numberstring

E.164 phone number

email_verifiedboolean

A boolean value

phone_number_verifiedboolean

A boolean value

enabledboolean required

A boolean value

idstring required

An object id with prefix

created_atstring date-time required

Creation date and time

created_bystring required

ID of the user that created this object

updated_atstring date-time required

Last update date and time

updated_bystring required

ID of the user that last updated this object

Example response

{
  "picture": "https://www.acme.com",
  "zoneinfo": "America/New_York",
  "locale": "en-US",
  "email": "email@domain.com",
  "phone_number": "+14155551234",
  "id": "user_0123456789ABCDEFGHIJKLMNOPq",
  "created_at": "2024-01-15T10:30:00Z",
  "created_by": "user_0123456789ABCDEFGHIJKLMNOPq",
  "updated_at": "2024-01-15T10:30:00Z",
  "updated_by": "user_0123456789ABCDEFGHIJKLMNOPq"
}

Changes

  • 4bbab9699612Revision changes
    • warning

      removed the request property

    • warning

      removed the request property

    • info

      the response's property pattern was changed from ^[a-z]{3,7}_[0-9A-Za-z]{27}$ to ^[0-9A-Za-z_-]{1,255}$ for the status

    • info

      the response's property pattern was changed from ^[a-z]{3,7}_[0-9A-Za-z]{27}$ to ^[0-9A-Za-z_-]{1,255}$ for the status