Updating Single Object¶
Method¶
PUT
Endpoint URL¶
The xxxx.backendless.app
is a subdomain assigned to your application. For more information see the Client-side Setup section of this documentation.
https://xxxx.backendless.app/api/data/<table-name>/<objectId>
where:
Argument | Description |
---|---|
<objectId> |
ID of the object to update assigned by Backendless in the create object operation. This part of the URL is optional. If the objectId value is not in the URL, it must be present in the request body. |
Request Headers¶
Content-Type:application/json
user-token:value-of-the-user-token-header-from-login
where:
Argument | Description |
---|---|
Content-Type |
Must be set to application/json . This header is mandatory. |
user-token |
Optional header. Contains a value returned by Backendless in a preceding user Login API call. If user-token is set in the request, the operation will be executed with the security policy associated currently logged in user. This means all permissions associated with the user and roles assigned to the user will be enforced by Backendless. |
Request Body¶
A JSON object to update in the database. The object may reference only the properties to update, but it is acceptable to include all properties of the object (including the ones to update). In this case, Backendless will update the entire object.
Response Body¶
A JSON representation of the updated object.
Example¶
Important
Make sure to replace xxxx in the domain name in the sample request below to the one assigned to your application.
curl \
-H Content-Type:application/json \
-X PUT \
-d "{\"name\":\"Bob\", \"age\":20 }" \
-v https://xxxx.backendless.app/api/data/Person/6C77C11B-E9B3-EB14-FFA2-69F38CF48800
Notice the objectId
value is put directly into the URL. The value is optional in the JSON body of the request if it included in the endpoint URL.