Set membership metadata
Sets channel membership metadata for the specified UUID. Use the
delete properties in the request body to perform those operations on one or more memberships.
Returns the updated UUID's channel membership metadata, optionally including:
- UUID's custom properties
- Custom properties for the UUID's membership in each channel
- Each channel's custom properties
- You can change all of the membership object's properties except its identifier.
- Invalid property names are silently ignored and will not cause a request to fail.
- If you set the
customproperty, you must completely replace it since partial updates are not supported.
- The custom object can only contain scalar values.
sub_key string — REQUIRED
Your app's subscribe key from Admin Portal.
uuid string — REQUIRED
A UTF-8 encoded string of up to 64 characters used to identify the client. Must not be empty and can contain up to 92 UTF-8 byte sequences.
Prohibited characters are:
Possible values: [
List of additional/complex metadata to include in the response. Omit this query parameter if you don't want to retrieve additional metadata.
Possible values: value ≤ 100
Number of objects to return in response. Default is
Random string returned from the server, including a specific position in a data set. Used for forward pagination, it fetches the next page, allowing you to continue from where you left off.
Random string returned from the server, including a specific position in a data set. Used for backward pagination, it fetches the previous page, enabling access to earlier data. Ignored if the
Expression used to filter the results. Only objects whose properties satisfy the given expression are returned.
For details on [App Context Filtering], refer to documentation.
Note the following:
Example (Simple expression):
Example (Date/time comparison):
Example (Compound expression):
Example (Escaped wildcard):
Possible values: Value must match regular expression
List of properties to sort by.
String which is either the auth key (PAM v2) or a valid token (Access Manager) used to authorize the operation if access control is enabled. Authorization token with permissions to perform the request.
Signature used to verify that the request was signed with the secret key associated with the subscribe key.
If Access Manager is enabled, either a valid authorization token or a signature are required. Check Access Manager documentation for details on how to compute the signature.
Unix epoch timestamp used as a nonce for signature computation. Must have no more than ± 60 seconds offset from NTP.
|Request Body — REQUIRED
JSON object with changes to the UUID's channel membership metadata.
Successfully set the UUID's channel membership metadata.
The request body contains invalid data.
Disabled - The subscribe key doesn't have App Context API enabled.
Forbidden - The client isn't authorized to perform this operation. The authorization key you provided doesn't have the required permissions for this operation.
The format of the request body you supplied isn't supported. The request body must be in JSON format.
Request rate limit exceeded.
An internal server error occurred.
Request processing exceeded the maximum allowed time.