Update (PUT)

Use the PUT method to update a record.

Content types supported are "text/plain" or "application/json" - You can send plain text to the server or JSON. We recommend using "application/json" but also give the option of "text/plain" requests to give developers more freedom.

uniqueId - The uniqueId is required to replace the existing data of the record.

Request data#

HTTP method PUT

URL format: https://baseUrl/versionNumber/customEndpointRoute/userEndpoint?key=apiKey&uniqueId=uniqueId[&dataOnly=true]

Example:

https://app.yawe.dev/api/1/ce/examples/unsecure-endpoint?key=d59eb2859c284168ac48aef65046d5dd&uniqueId=45e964d5b6ed49b1a2e14d8ac724109e[&dataOnly=true]

Request Cookies#

Header

Description

Required

yawe_access_token

The Access token is required for secure endpoints.

It is obtained when doing a login. To automatically include it in the request you need to set the following property:

 // using fetch
{ credentials: 'include' }

// using axios
{ withCredentials: true }

For more information check Secure Endpoints.

Request Headers#

Header	Required	Description
Content-Type	Yes	Specifies the MIME type of the body of the Request. It may be: application/json text/plain

Request Parameters#

The following table describes the Request parameters.

Parameter	Description	Required
baseUrl	Base url for calling the API. Value: app.yawe.dev/api	Yes
versionNumber	Service version. Value: The current value is 1.	Yes
customEndpointRoute	The route which identifies custom endpoints. Default value: ce	Yes
userEndpoint	The endpoint name generated by the user. Value: the name created at https://app.yawe.dev	Yes
key	The API Key of the project.	Yes
uniqueId	The identifier of the record.	Yes
dataOnly	If used, the endpoint response will be the POST body, without additional information such as ‘uniqueId’. Value: true	No
masterKey	Overrides the need for Access tokens or restrictions applied to Authentication endpoints. Don't use this key in your client application. For more information please refer to projects. Value: the masterKey created at https://app.yawe.dev.	No
strategy	A strategy allows you to choose how the data is updated. Values: force - (default) replaces the content regardless of the type. merge - merges objects, it only works with JSON. replace - replaces the entire content, types must be the same.	No

POST body#

You can post JSON or plain text, just make sure you set the appropriate Content-Type header.

Response data#

Error codes#

Error code	Description
400	Possible reasons: Endpoint or API Key not valid. Wrong Content-Type, it only accepts "text/plain" or "application/json". Empty Request body. uniqueId is not present in the URL. No record was found.
401	If the endpoint is secure and the access token is missing or is not valid. It may also return this error if the user no longer exists.
403	Missing API Key, not allowed origin or disallowed request without orign.

Successful response#

This endpoint returns the new updated record.

Example:

{
 uniqueId: "3f38bf9e1bb54d2396d1f1b8fbba1630",
 data: { newProperty: "data" },
 createdAt: "2020-12-27T10:58:45.000Z",
 updatedAt: "2020-12-27T10:58:45.000Z"
}