Developers
Users

List user tags

GET/users/{user_id}/tags

Returns the tags currently assigned to the user.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

user_id*string

Header Parameters

X-Client-Request-Id?string

Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/string/tags"
{  "data": [    {      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "name": "string",      "object": "tag",      "revision": "string",      "updated_at": "2019-08-24T14:15:22Z",      "users_count": 0    }  ]}

Retrieve a point entry GET

Retrieves a point entry from the user's points ledger. The entry must belong to the user identified in the path; otherwise, the API returns `404 Not Found`.

Replace user tags PUT

Replaces the user's entire set of tags with the tags supplied in the request. Assigned tags that are not included are removed. If any supplied tag does not exist in the account, the API returns `404 Not Found` and no changes are made.