# IBM Roles API

**Canonical:** https://apis.io/apis/ibm/ibm-roles-api/  
**Provider:** IBM — https://apis.io/providers/ibm/  
**Base URL:** https://api.us-south.assistant.watson.cloud.ibm.com  
**Documentation:** https://www.ibm.com/products/watson-assistant

IBM Roles API is one of 55 APIs that [IBM](https://apis.io/providers/ibm/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a getting-started guide, pricing, and 1 JSON Schema.

List and manage IAM roles

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/roles` | List IAM roles |
| POST | `/v2/roles` | Create a custom role |
| GET | `/v2/roles/{role_id}` | Get a role |
| PUT | `/v2/roles/{role_id}` | Replace a custom role |
| DELETE | `/v2/roles/{role_id}` | Delete a custom role |

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ibm/refs/heads/main/openapi/ibm-roles-api-openapi.yml
- **Documentation** — https://cloud.ibm.com/apidocs/assistant/assistant-v2
- **Authentication** — https://cloud.ibm.com/docs/watson?topic=watson-iam
- **GettingStarted** — https://cloud.ibm.com/docs/assistant?topic=assistant-getting-started
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/ibm/refs/heads/main/graphql/ibm-graphql.md
- **Documentation** — https://cloud.ibm.com/apidocs/natural-language-understanding
- **Pricing** — https://www.ibm.com/cloud/watson-natural-language-understanding/pricing
- **GettingStarted** — https://cloud.ibm.com/docs/natural-language-understanding
- **Documentation** — https://cloud.ibm.com/apidocs/language-translator
- **GettingStarted** — https://cloud.ibm.com/docs/language-translator
- **Documentation** — https://cloud.ibm.com/apidocs/speech-to-text
- **GettingStarted** — https://cloud.ibm.com/docs/speech-to-text
- **Documentation** — https://cloud.ibm.com/apidocs/text-to-speech
- **GettingStarted** — https://cloud.ibm.com/docs/text-to-speech
- **Documentation** — https://cloud.ibm.com/apidocs/iam-identity-token-api
- **GettingStarted** — https://cloud.ibm.com/docs/account?topic=account-iamoverview
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/ibm/refs/heads/main/json-schema/ibm-cloud-resource-schema.json
- **JSONLDContext** — https://raw.githubusercontent.com/api-evangelist/ibm/refs/heads/main/json-ld/ibm-context.jsonld
- **Documentation** — https://cloud.ibm.com/apidocs/iam-policy-management
- **Documentation** — https://cloud.ibm.com/apidocs/iam-access-groups

## Other IBM APIs (12)

- [IBM Cloud Object Storage](https://apis.io/apis/ibm/ibm-cloud-object-storage/)
- [IBM Cloud Databases for PostgreSQL](https://apis.io/apis/ibm/ibm-cloud-databases-for-postgresql/)
- [IBM Cloud Code Engine](https://apis.io/apis/ibm/ibm-cloud-code-engine/)
- [IBM watsonx.ai](https://apis.io/apis/ibm/ibm-watsonxai/)
- [IBM watsonx.governance](https://apis.io/apis/ibm/ibm-watsonxgovernance/)
- [IBM Watson Discovery](https://apis.io/apis/ibm/ibm-watson-discovery/)
- [IBM Cloud Virtual Private Cloud](https://apis.io/apis/ibm/ibm-cloud-virtual-private-cloud/)
- [IBM Cloud Kubernetes Service](https://apis.io/apis/ibm/ibm-cloud-kubernetes-service/)
- [IBM Key Protect](https://apis.io/apis/ibm/ibm-key-protect/)
- [IBM Cloud Secrets Manager](https://apis.io/apis/ibm/ibm-cloud-secrets-manager/)
- [IBM Cloud Event Notifications](https://apis.io/apis/ibm/ibm-cloud-event-notifications/)
- [IBM Cloud Container Registry](https://apis.io/apis/ibm/ibm-cloud-container-registry/)

## Tags

Roles

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ibm/ibm-roles-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ibm/.