Profiles

Update profile

Changed on

Updates a profile's name, description, color, default timezone, externalId, or default status.

put/v1/profiles/{profileId}

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/profiles/{profileId}
  • Auth: HTTP bearer

Path parameters

profileIdstring required

Request body

namestring
descriptionstring nullable

Set to null to clear the description.

colorstring
timezonestring nullable

IANA timezone new posts on this profile use when they name no timezone. Set to null to go back to UTC. An unknown name returns 400.

externalIdstring nullable

Your own identifier for this profile (1 to 255 characters, trimmed). Set to null to clear it. A value another profile of the same owner already holds returns 409 profile_external_id_conflict.

isDefaultboolean

Example request

{
  "timezone": "Europe/Istanbul",
  "externalId": "tenant_42"
}

Response

Updated

messagestring

Changes

  • 27c96850cc66Revision changes
    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status