deprecated
Customers won't be accessible anymore via the /users endpoints on October 25, 2022
about 2 years ago by Louis Barranqueiro
We've decided to postpone the initial date of the API breaking change we were supposed to apply on August 1, 2022 regarding the Users API endpoints: Customers won't be accessible anymore via the /users endpoints on 2022-08-01.
The new release date is Oct 25, 2022. Before this date, we will perform a series of brownouts in an attempt to warn third-party developers who still haven't migrated their apps about this upcoming breaking change.
Brownouts:
- October 11, 2022, from 4:00 PST to 16:00 PST (12 hours)
- October 13, 2022, from 00:00 PST to 23:59 PST (24 hours)
- October 18, 2022 00:00 PST to October 19, 2022 23:59 PST (48 hours)
Changelog
Starting from October 25, 2022:
- The /users endpoints won't work to create, list, retrieve, update and delete customers. Instead, you will have to use the /customers endpoints. The /users endpoints will only be used to manage Gorgias users (people using Gorgias).
- The "create user" and "update user" endpoints won't accept the
channels
,customer
,data
, androles
attributes in the payload. Sending one of these attributes will result in an HTTP 400 - Bad request error.
Migration guide:
Review HTTP requests you send to the /users endpoints:
- If you are calling these endpoints to create, list, retrieve, update, delete Users:
- When creating or updating users:
- remove body parameters
channels
,customer
, anddata
- replace usage of
roles
withrole
- remove body parameters
- Remove usage of the deprecated attributes returned in the responses that are not User's attributes (
channels
,customer
,data
,integrations
, androles
).
- When creating or updating users:
- If you call this endpoint to create, list, retrieve, update, delete Customers:
- Replace the
/users
part in the URL of your HTTP request with/customers
.
- Replace the