Get User Roles

1 min

GET

https://api.upstartcommerce.com/v1/user/{userId}/user-roles

This endpoint returns the user's roles.

Required permissions:

user.user-role.read

Authorized system roles:

system.admin
user.mgmt

Header Parameters

x-upstart-tenantstringrequired
Description
Tenant identifier associated with the site this call is for.

Responses

200This returns all of the data representing the indicated role.

UserRoles

Example

{
  "tenant-name-1": {
    "roleIds": [
      "catalog.mgmt"
    ],
    "sites": {
      "example-site-name-1": {
        "roleIds": [
          "order.mgmt"
        ]
      },
      "example-site-name-2": {
        "roleIds": [
          "order.mgmt"
        ]
      }
    }
  },
  "tenant-name-2": {
    "roleIds": [
      "user.mgmt"
    ],
    "sites": {
      "example-site-name-1": {
        "roleIds": []
      },
      "example-site-name-2": {
        "roleIds": [
          "inventory.mgmt"
        ]
      }
    }
  }
}

Description

A map indexed by a tenant name listing all tenant-level roles and site-level roles. For example: { "tenant1" : { "roleIds" : ["some.role1","some.role2"], sites: { "site1": { "roleIds": ["some.role3","some.role4"] }, "site2": { "roleIds": ["some.role4","some.role6"] } } }, "tenant2" : { "roleIds" : ["some.other.role1","some.other.role2"], sites: { "site1": { "roleIds": ["some.other.role3","some.other.role4"] }, "site2": { "roleIds": ["some.other.role5","some.other.role6"] } } } }

400The request contained information that the server was unable to process. Appropriate errors are provided in the response body.

ValidationErrorResponse
Description
Details of a request that failed validation.
- namestringrequired
- codestringrequired
- detailstring[]required
- reasonstring

401The provided credentials were not valid for this endpoint. It may be that they are expired or that the user's roles are insufficient.

UnauthorizedError
Description
Credentials are missing, expired or insufficient (HTTP 401).
- namestringrequired
- codestringrequired
- detailstringrequired
- reasonstring

403

An update to this resource requires the if-match and if-unmodified-since headers to be sent in order to process the request.

ForbiddenError
Description
The request is understood but refused (HTTP 403).
- namestringrequired
- codestringrequired
- detailstringrequired
- reasonstring

404The requested resource was not found in the NoChannel system.

NotFoundError
Description
The addressed resource does not exist (HTTP 404).
- namestringrequired
- codestringrequired
- detailstringrequired
- reasonstring

409The request conflicts with the current state of the resource.

ConflictError
Description
The request conflicts with existing state (HTTP 409).
- namestringrequired
- codestringrequired
- detailstringrequired
- reasonstring

500Internal server error. The server encountered an unexpected condition that prevented it from fulfilling the request.

InternalServerError
Description
The request failed for an unexpected reason (HTTP 500).
- namestringrequired
- codestringrequired
- detailstringrequired
- reasonstring

curl

curl --request GET \
     --url https://api.upstartcommerce.com/v1/user/{userId}/user-roles \
     --header 'accept: application/json' \
     --header 'x-upstart-tenant: string'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
myHeaders.append("x-upstart-tenant", "string");

var requestOptions = {
   method: 'GET',
   headers: myHeaders,
   redirect: 'follow'
};

fetch("https://api.upstartcommerce.com/v1/user/{userId}/user-roles", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://api.upstartcommerce.com/v1/user/{userId}/user-roles")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["x-upstart-tenant"] = "string"

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://api.upstartcommerce.com/v1/user/{userId}/user-roles"

payload = {}
headers = {
   'accept': 'application/json',
   'content-type': 'application/json',
   'x-upstart-tenant': 'string'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

200

// This returns all of the data representing the indicated role.
{}

GENERATED

// This returns all of the data representing the indicated role.
{}

example-1

{
  "tenant-name": {
    "roleIds": [
      "example-tenant-wide-role-id"
    ],
    "sites": {
      "example-site-id-1": {
        "roleIds": [
          "example-site-role-id"
        ]
      },
      "example-site-id-2": {
        "roleIds": []
      }
    }
  }
}

400

// The request contained information that the server was unable to process. Appropriate errors are provided in the response body.
{
  "name": "",
  "code": "",
  "detail": [
    ""
  ],
  "reason": ""
}

401

// The provided credentials were not valid for this endpoint. It may be that they are expired or that the user's roles are insufficient.
{
  "name": "",
  "code": "",
  "detail": "",
  "reason": ""
}

403

// An update to this resource requires the if-match and if-unmodified-since headers to be sent in order to process the request.
{
  "name": "",
  "code": "",
  "detail": "",
  "reason": ""
}

404

// The requested resource was not found in the NoChannel system.
{
  "name": "",
  "code": "",
  "detail": "",
  "reason": ""
}

409

// The request conflicts with the current state of the resource.
{
  "name": "",
  "code": "",
  "detail": "",
  "reason": ""
}

500

// Internal server error. The server encountered an unexpected condition that prevented it from fulfilling the request.
{
  "name": "",
  "code": "",
  "detail": "",
  "reason": ""
}