Experience User Actions
https://api.losant.com/applications/APPLICATION_ID
/experience/users/EXPERIENCE_USER_ID
Below are the various requests that can be performed against the Experience User resource, as well as the expected parameters and the potential responses.
Delete
Deletes an experience user
Method And Url
DELETE https://api.losant.com/applications/APPLICATION_ID
/experience/users/EXPERIENCE_USER_ID
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Application, all.Organization, all.User, experienceUser.*, or experienceUser.delete.
Request Path Components
Path Component | Description | Example |
---|---|---|
APPLICATION_ID | ID associated with the application | 575ec8687ae143cd83dc4a97 |
EXPERIENCEUSERID | ID associated with the experience user | 575ed78e7ae143cd83dc4aab |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X DELETE \
https://api.losant.com/applications/APPLICATION_ID/experience/users/EXPERIENCE_USER_ID
Successful Responses
Code | Type | Description |
---|---|---|
200 | Success | If experience user was successfully deleted |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if experience user was not found |
Get
Retrieves information on an experience user
Method And Url
GET https://api.losant.com/applications/APPLICATION_ID
/experience/users/EXPERIENCE_USER_ID
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Application, all.Application.read, all.Organization, all.Organization.read, all.User, all.User.read, experienceUser.*, or experienceUser.get.
Request Path Components
Path Component | Description | Example |
---|---|---|
APPLICATION_ID | ID associated with the application | 575ec8687ae143cd83dc4a97 |
EXPERIENCEUSERID | ID associated with the experience user | 575ed78e7ae143cd83dc4aab |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X GET \
https://api.losant.com/applications/APPLICATION_ID/experience/users/EXPERIENCE_USER_ID
Successful Responses
Code | Type | Description |
---|---|---|
200 | Experience User | Experience user information |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if experience user was not found |
Patch
Updates information about an experience user
Method And Url
PATCH https://api.losant.com/applications/APPLICATION_ID
/experience/users/EXPERIENCE_USER_ID
Authentication
A valid api access token is required to access this endpoint. The token must include at least one of the following scopes: all.Application, all.Organization, all.User, experienceUser.*, or experienceUser.patch.
Request Path Components
Path Component | Description | Example |
---|---|---|
APPLICATION_ID | ID associated with the application | 575ec8687ae143cd83dc4a97 |
EXPERIENCEUSERID | ID associated with the experience user | 575ed78e7ae143cd83dc4aab |
Request Headers
Name | Required | Description | Default |
---|---|---|---|
Authorization | Y | The token for authenticating the request, prepended with Bearer |
Request Body
The body of the request should be serialized JSON that validates against the Experience User Patch schema. For example, the following would be a valid body for this request:
{
"password": "aNewPassword",
"userTags": {
"customKey": "newCustomValue"
}
}
Curl Example
curl -H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_ACCESS_TOKEN' \
-X PATCH \
-d '{"password":"aNewPassword","userTags":{"customKey":"newCustomValue"}}' \
https://api.losant.com/applications/APPLICATION_ID/experience/users/EXPERIENCE_USER_ID
Successful Responses
Code | Type | Description |
---|---|---|
200 | Experience User | Updated experience user information |
Error Responses
Code | Type | Description |
---|---|---|
400 | Error | Error if malformed request |
404 | Error | Error if experience user was not found |
Was this page helpful?
Still looking for help? You can also search the Losant Forums or submit your question there.