Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Rackspace Technology Roles API

Global and tenant role assignments.

Rackspace Technology Roles API is one of 26 APIs that Rackspace Technology publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and 8 JSON Schemas.

This API exposes 6 operations across 5 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://dns.api.rackspacecloud.com/v1.0.

6 operations 5 paths 2 schemas 1 DELETE4 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Server
https://dns.api.rackspacecloud.com/v1.0
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

Rackspace Technology Roles API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Auth-Token (AuthToken). By default, every request must be authenticated.

  • AuthToken — Rackspace Cloud Identity-issued authentication token.

Paths & Operations 6

Across 5 paths, the API surfaces 6 operations — 1 DELETE, 4 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Roles 6

Global and tenant role assignments.

GET
/v2.0/users/{userId}/roles
List Global Roles Assigned To User
listGlobalRolesAssignedToUser 1 param → 200
GET
/v2.0/users/{userId}/RAX-AUTH/effective-roles
List Effective Roles
listEffectiveRoles 1 param → 200
PUT
/v2.0/users/{userId}/roles/OS-KSADM/{roleId}
Add Role To User
addRoleToUser 2 params → 200
DELETE
/v2.0/users/{userId}/roles/OS-KSADM/{roleId}
Delete Global Role From User
deleteGlobalRoleFromUser 2 params → 204
GET
/v2.0/OS-KSADM/roles
List Roles
listRoles → 200
GET
/v2.0/OS-KSADM/roles/{roleId}
Get Role By Id
getRoleById 1 param → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are Role (5 properties), RoleList (1 property). Each schema is shown below with its type and property counts.

Role
object
5 properties
RoleList
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rackspace-technology-roles-api-openapi.yml Raw ↑

Other APIs Rackspace Technology publishes across the network.

Rackspace Ticketing API
Rackspace Dedicated Load Balancer API
Rackspace Metrics API
Rackspace Monitoring API
Rackspace Cloud Orchestration API
Rackspace Cloud Feeds API
Rackspace Billing API
Rackspace Technology Contacts API
Rackspace Technology Currency API
Rackspace Technology CustomerAccounts API
Rackspace Technology Domains API
Rackspace Technology Limits API