Skip to content

Role features ​

Returns the features granted to one role in an application.

POST /fieldservicegateway/usermanagement/v3/authorization/app-roles/features/search

Request ​

FieldTypeRequiredDescription
applicationIdstringyesApplication name. Must not contain :
roleNamestringyesRole name inside that application. Must not contain :

Example ​

json
{
  "applicationId": "Honeycomb",
  "roleName": "Read"
}

cURL ​

bash
curl --request POST 'https://[BASE_URL]/fieldservicegateway/usermanagement/v3/authorization/app-roles/features/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: {{x-api-key}}' \
  --header 'Authorization: {{Authorization}}' \
  --header 'Asurion-correlationid: correlation-id' \
  --header 'Asurion-enduser: end-user' \
  --header 'Asurion-sourcesystem: source-system' \
  --header 'Asurion-serviceprovider: company-id' \
  --header 'Asurion-client: default' \
  --data '{
    "applicationId": "Honeycomb",
    "roleName": "Read"
  }'

Response ​

200 OK

json
{
  "success": true,
  "message": "Role features retrieved successfully",
  "data": {
    "applicationId": "Honeycomb",
    "roleName": "Read",
    "features": [
      {
        "featureName": "jobmanagement",
        "permission": "Read"
      }
    ]
  }
}

permission is the access level for that feature, such as Read, Write, or None.

Errors ​

StatusCodeWhen
400VALIDATION_ERRORapplicationId or roleName is missing or contains :
500INTERNAL_ERRORSomething unexpected failed