SetEndpointAttributes
Written by
Updated at April 17, 2025
Sets attributes of the endpoint for push notifications.
HTTP request
POST https://notifications.yandexcloud.net/
Query parameters
| Parameter | Description |
|---|---|
Action |
string Required field. Operation type parameter. Value: SetEndpointAttributes. |
EndpointArn |
string Required field. Endpoint ID (ARN). Example: arn:aws:sns::aoegtvhtp8ob********:endpoint/GCM/test-cns-9990/4cbe148515360244248c993abe0a12884d162bb15e87d6c16bd0c810********. |
Attributes.entry.N.key |
string Required field. Attribute key. N is a numeric value.Example: Attributes.entry.1.key=Token&Attributes.entry.2.key=CustomUserData. |
Attributes.entry.N.value |
string Required field. Attribute value. N is a numeric value.Example: Attributes.entry.1.value=c8gzjriSVxDDzX2fAV********&Attributes.entry.2.value=test-text. |
ResponseFormat |
string Response format. The possible values are:
|
Attributes
| Attribute | Description |
|---|---|
Token |
string Required field. For mobile notifications: unique token on the user device (Registration ID) created by the notification service for the app. For in-browser notifications: the PushSubscription object received in the user's browser, in JSON format. |
CustomUserData |
string Other user data that can be stored together with the endpoint. Cloud Notification Service does not use this data in any way. |
Note
The Enabled attribute for enabling and disabling endpoint notifications is currently not supported.
Response
Successful response
If there are no errors, Cloud Notification Service returns the 200 HTTP code.
A successful response contains additional data in XML or JSON format depending on the specified ResponseFormat parameter.
Data schema:
XML
JSON
<?xml version="1.0" encoding="UTF-8"?>
<SetEndpointAttributesResponse>
<ResponseMetadata>
<RequestId>string</RequestId>
</ResponseMetadata>
</SetEndpointAttributesResponse>
{
"ResponseMetadata": {
"RequestId": "string"
}
}
Where RequestId is the request ID.
Error response
In case of an error, Cloud Notification Service returns a message with the appropriate HTTP code.
For a list of common error codes for all actions, see Errors.