IBM website screenshot

IBM

A collection of IBM's public APIs and developer resources.

56 APIs 16 Features
API ManagementArtificial IntelligenceBillingCloud ComputingContainersData GovernanceDatabasesDevOpsEnterpriseGenerative AIHybrid CloudInfrastructureMachine LearningNetworkingObservabilitySecurityServerlessStorageWatsonWatsonxFortune 100

APIs

IBM Watson Assistant

Build conversational interfaces into any application, device, or channel.

IBM Watson Natural Language Understanding

Analyze text to extract metadata from content such as concepts, entities, keywords, categories, sentiment, emotion, relations, and semantic roles.

IBM Watson Language Translator

Translate text from one language to another.

IBM Watson Speech to Text

Convert audio voice into written text.

IBM Watson Text to Speech

Convert written text into natural-sounding audio in a variety of languages and voices.

IBM Cloud Object Storage

Store and access unstructured data with built-in high-speed file transfer.

IBM Cloud Databases for PostgreSQL

Managed PostgreSQL database service.

IBM Cloud Code Engine

Run containerized workloads without managing servers.

IBM watsonx.ai

Run text inference, prompt tuning, and more on large language models using the watsonx.ai API for generative AI applications.

IBM watsonx.governance

Monitor and manage AI models with an enterprise-grade environment that provides visibility into how AI is being built, used, and delivering business value.

IBM Watson Discovery

Add cognitive search and content analytics to applications to identify patterns, trends, and actionable insights from unstructured data.

IBM Cloud Virtual Private Cloud

Provision and manage isolated virtual network environments for compute, storage, and networking resources on IBM Cloud.

IBM Cloud Kubernetes Service

Create and manage Kubernetes cluster infrastructure to deploy and manage containerized applications on IBM Cloud.

IBM Key Protect

Provision and manage encrypted keys for data-at-rest protection across IBM Cloud services.

IBM Cloud IAM Identity Services

Manage service IDs, API key identities, trusted profiles, account security settings, and create IAM access tokens.

IBM Cloud Secrets Manager

Create, lease, and centrally manage secrets used in IBM Cloud services or custom-built applications.

IBM Cloud Event Notifications

Route event notifications from IBM Cloud services to communication channels such as email, SMS, webhooks, and push notifications.

IBM Cloud Container Registry

Store and distribute container images in a managed private registry for IBM Cloud Kubernetes and other container workloads.

IBM Cloud Schematics

Use Terraform and Ansible to automate the provisioning and configuration management of IBM Cloud resources with infrastructure as code.

IBM Cloud Internet Services

Provide DDoS protection, global load balancing, DNS management, WAF, and CDN capabilities for internet-facing applications, powered by Cloudflare.

IBM Cloudant

Fully managed distributed JSON document database built for the cloud with high availability, durability, and scalability.

IBM Event Streams

Fully managed Apache Kafka service for high-throughput event streaming, event ingestion, and event stream distribution between services.

IBM Cloud Security and Compliance Center

Assess, monitor, and remediate security and compliance posture for cloud resources using automated controls and policies.

IBM Cloud Functions

Run lightweight code that executes application logic in a scalable way using an event-driven serverless compute platform based on Apache OpenWhisk.

IBM Cloud DNS Services

Manage private DNS zones and resolution for IBM Cloud VPC networks.

IBM Cloud Monitoring

Gain operational visibility into the performance and health of applications, services, and platforms running on IBM Cloud.

IBM Cloud Logs

A scalable logging service for persisting, querying, tailing, and visualizing logs across IBM Cloud resources.

IBM Cloud Activity Tracker

Configure and manage auditing events to track how users and applications interact with IBM Cloud services and resources.

IBM Cloud App ID

Add authentication and authorization to web and mobile applications with identity management, social login, and multi-factor authentication.

IBM Cloud Transit Gateway

Interconnect IBM Cloud VPCs, classic infrastructure, and on-premises networks through a single gateway for simplified network management.

IBM Cloud Resource Controller

Manage the lifecycle of IBM Cloud resources in a customer account including provisioning, binding, and managing access to resource instances.

IBM Cloud Global Search

Search for cloud resources across the IBM Cloud platform using resource attributes and properties.

IBM Cloud Global Tagging

Create, delete, search, attach, or detach tags to organize and manage IBM Cloud resources.

IBM IAM Policy Management

Create and manage access policies that control what actions users can perform on IBM Cloud resources.

IBM IAM Access Groups

Create and manage access groups to organize users and service IDs into groups for simplified access management.

IBM Cloud Power Virtual Server

Deploy and manage AIX, IBM i, and Linux workloads on IBM Power Systems virtual servers in the IBM Cloud.

IBM Cloud Enterprise Management

Create and manage enterprise accounts, account groups, and child accounts for centralized billing and usage tracking.

IBM Cloud Projects

Configure, deploy, and govern infrastructure as code resources at scale using projects for managed deployments.

IBM watsonx.data

Collect, store, query, and analyze structured and unstructured enterprise data with a unified data lakehouse platform optimized for price and performance.

IBM API Connect

Create, secure, manage, share, monetize, and analyze APIs across clouds with a comprehensive end-to-end API management solution.

IBM Cloud Direct Link

Establish private, high-speed connectivity between on-premises networks and IBM Cloud without traversing the public internet.

IBM Cloud Continuous Delivery Toolchain

Create and manage toolchains that integrate development, deployment, and operations tools for continuous delivery workflows.

IBM Cloud Tekton Pipeline

Create and manage Tekton-based continuous integration and continuous delivery pipelines within Kubernetes clusters.

IBM Cloud User Management

Manage users within an IBM Cloud account including inviting, retrieving, updating, or removing users and managing user profiles and settings.

IBM Cloud Usage Reports

Retrieve usage details and costs for IBM Cloud resources in an account reported by the month in which they were incurred.

IBM Cloud Global Catalog

Manage the system of record for IBM Cloud products across geographies including compute, storage, networking, and cloud-native services.

IBM Cloud Catalog Management

Define how users in an account interact with the IBM Cloud catalog and manage private catalogs for curated product offerings.

IBM Cloud Context-based Restrictions

Create and manage network zones and context-based restriction rules to control access to IBM Cloud resources based on network context.

IBM Cloud Databases for Redis

Fully managed Redis in-memory data store for caching, session management, and high-speed data access on IBM Cloud.

IBM Cloud Databases for MongoDB

Fully managed MongoDB document database service with built-in high availability, automated backups, and scaling on IBM Cloud.

IBM Cloud Databases for Elasticsearch

Fully managed Elasticsearch service for full-text search, log analytics, and application monitoring on IBM Cloud.

IBM Cloud Enterprise Billing Units

Manage billing units, billing options, and credit pools for IBM Cloud enterprise accounts.

IBM Cloud Enterprise Usage Reports

Access usage reports for entities managed by an IBM Cloud enterprise including enterprises, account groups, and accounts.

IBM Cloud VMware Solutions

Deploy and manage VMware workloads on IBM Cloud infrastructure with automated provisioning and lifecycle management.

IBM watsonx.ai Runtime

Build, train, and deploy machine learning models with a full range of tools and services for data science and AI lifecycle management.

IBM Knowledge Catalog

Discover, catalog, categorize, and govern data assets and AI models with an intelligent data catalog for enterprise data governance.

Collections

GraphQL

IBM GraphQL Schema

This directory contains a conceptual GraphQL schema for IBM Cloud and Watson AI services. The schema models the key entities, relationships, and operations exposed across IBM's ...

GRAPHQL

Pricing Plans

Ibm Plans Pricing

3 plans

PLANS

Rate Limits

Ibm Rate Limits

2 limits

RATE LIMITS

FinOps

Ibm Finops

FINOPS

Features

IBM (Cloud + Watsonx + Software): hundreds of services across Cloud + AI + Enterprise Software
Detailed pricing: see https://www.ibm.com/cloud/pricing
Service: IBM Cloud Object Storage
Service: IBM Cloud Databases
Service: IBM Cloud Kubernetes Service
Service: IBM Code Engine (serverless)
Service: IBM Cloud Functions
Service: IBM Cloud VPC
Service: Watsonx.ai
Service: Watsonx.data
Service: Watsonx.governance
Service: Watson Assistant
Service: Watson Discovery
Service: Watson Speech to Text / Text to Speech
Service: Cloud Pak (various)
Service: Db2 / Informix / Db2 Big SQL

Semantic Vocabularies

Ibm Context

4 classes · 21 properties

JSON-LD

Press

IBM Newsroom

2026-05-25

IBM - Announcements

2026-05-25

IBM Consulting Expands AI Capabilities to Accelerate ...

2026-05-25

Artificial intelligence news

2026-05-25

Artificial intelligence press releases

2026-05-25

Resources

🔗
LinkedIn
LinkedIn
🌐
Portal
Portal
🔑
Authentication
Authentication
🚀
GettingStarted
GettingStarted
📦
SDKs
SDKs
🟢
StatusPage
StatusPage
💬
Support
Support
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
📝
Signup
Signup
💰
Pricing
Pricing
📰
Blog
Blog
🎓
Tutorials
Tutorials
📄
ChangeLog
ChangeLog
🔗
Community
Community
🔗
API Documentation
API Documentation
🔗
CLI
CLI
👥
GitHubOrganization
GitHubOrganization
🔗
Free Tier
Free Tier
🌐
Portal
Portal
🔗
Terraform Provider
Terraform Provider
📦
Platform SDKs
Platform SDKs
📦
Watson SDKs
Watson SDKs
🔗
Security
Security

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: IBM Cloud IAM API
  version: 1.0.0
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Tokens
    type: folder
  items:
  - info:
      name: Create an IAM access token
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/identity/token
      body:
        type: form-urlencoded
        data:
        - name: grant_type
          value: ''
        - name: apikey
          value: ''
        - name: refresh_token
          value: ''
        - name: response_type
          value: ''
    docs: Create an IAM access token for a user or service ID using an API key, refresh token, or delegated refresh token.
      Tokens are valid for one hour and can be refreshed before expiration.
- info:
    name: API Keys
    type: folder
  items:
  - info:
      name: List API keys
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/apikeys
      params:
      - name: account_id
        value: ''
        type: query
        description: The account ID of the API keys to query.
      - name: iam_id
        value: ''
        type: query
        description: The IAM ID associated with the API keys.
      - name: pagesize
        value: ''
        type: query
        description: Number of results per page.
      - name: pagetoken
        value: ''
        type: query
        description: Page token from a previous request for pagination.
      - name: scope
        value: ''
        type: query
        description: Scope of the query, either account or iam_id.
      - name: type
        value: ''
        type: query
        description: Filter by API key type.
      - name: sort
        value: ''
        type: query
        description: Field to sort by.
      - name: order
        value: ''
        type: query
        description: Sort order.
    docs: List API keys associated with an IAM ID, account, or service ID. Results can be filtered, sorted, and paginated.
  - info:
      name: Create an API key
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/apikeys
      body:
        type: json
        data: '{}'
    docs: Create a new API key for a user or service ID. The API key value is returned only at creation time.
  - info:
      name: Get API key details by value
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/apikeys/details
      headers:
      - name: IAM-ApiKey
        value: ''
      params:
      - name: include_history
        value: ''
        type: query
        description: Include activity history of the API key.
    docs: Retrieve details of an API key by providing the key value in the IAM-ApiKey header.
  - info:
      name: Get an API key
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/apikeys/:id
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
      - name: include_history
        value: ''
        type: query
        description: Include the history of the API key.
      - name: include_activity
        value: ''
        type: query
        description: Include the activity of the API key.
    docs: Retrieve details for a specific API key by its unique identifier.
  - info:
      name: Update an API key
      type: http
    http:
      method: PUT
      url: https://iam.cloud.ibm.com/v1/apikeys/:id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
      body:
        type: json
        data: '{}'
    docs: Update properties of an existing API key such as name and description.
  - info:
      name: Delete an API key
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/apikeys/:id
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
    docs: Remove an API key permanently. This action cannot be undone.
  - info:
      name: Lock an API key
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/apikeys/:id/lock
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
    docs: Lock an API key to prevent it from being deleted or modified. Locked keys remain active and can still be used for
      authentication.
  - info:
      name: Unlock an API key
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/apikeys/:id/lock
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
    docs: Unlock a previously locked API key to allow modifications and deletion.
  - info:
      name: Disable an API key
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/apikeys/:id/disable
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
    docs: Disable an API key to prevent it from being used for authentication. The key can be re-enabled later.
  - info:
      name: Enable an API key
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/apikeys/:id/disable
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the API key.
    docs: Re-enable a previously disabled API key for authentication.
- info:
    name: Service IDs
    type: folder
  items:
  - info:
      name: List service IDs
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/serviceids/
      params:
      - name: account_id
        value: ''
        type: query
        description: The account ID of the service IDs to query.
      - name: name
        value: ''
        type: query
        description: Filter service IDs by name.
      - name: pagesize
        value: ''
        type: query
        description: Number of results per page.
      - name: pagetoken
        value: ''
        type: query
        description: Page token from a previous request for pagination.
      - name: sort
        value: ''
        type: query
        description: Field to sort results by.
      - name: order
        value: ''
        type: query
        description: Sort order.
    docs: List service IDs in an account. Results can be filtered by name, sorted, and paginated.
  - info:
      name: Create a service ID
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/serviceids/
      body:
        type: json
        data: '{}'
    docs: Create a new service ID for an IBM Cloud account. Service IDs are used by applications and services to authenticate
      with IBM Cloud.
  - info:
      name: Get a service ID
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/serviceids/:id
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the service ID.
      - name: include_history
        value: ''
        type: query
        description: Include the history of the service ID.
      - name: include_activity
        value: ''
        type: query
        description: Include the activity of the service ID.
    docs: Retrieve details of a service ID by its unique identifier.
  - info:
      name: Update a service ID
      type: http
    http:
      method: PUT
      url: https://iam.cloud.ibm.com/v1/serviceids/:id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the service ID.
      body:
        type: json
        data: '{}'
    docs: Update properties of an existing service ID such as name and description.
  - info:
      name: Delete a service ID
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/serviceids/:id
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the service ID.
    docs: Delete a service ID and all associated API keys. This action cannot be undone.
  - info:
      name: Lock a service ID
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/serviceids/:id/lock
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the service ID.
    docs: Lock a service ID to prevent modification or deletion. Locked service IDs remain active.
  - info:
      name: Unlock a service ID
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/serviceids/:id/lock
      params:
      - name: id
        value: ''
        type: path
        description: The unique identifier of the service ID.
    docs: Unlock a previously locked service ID.
- info:
    name: Trusted Profiles
    type: folder
  items:
  - info:
      name: List trusted profiles
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/profiles
      params:
      - name: account_id
        value: ''
        type: query
        description: The account ID to list trusted profiles for.
      - name: name
        value: ''
        type: query
        description: Filter profiles by name.
      - name: pagesize
        value: ''
        type: query
        description: Number of results per page.
      - name: pagetoken
        value: ''
        type: query
        description: Page token from a previous request.
      - name: sort
        value: ''
        type: query
        description: Field to sort by.
      - name: order
        value: ''
        type: query
        description: Sort order.
      - name: include_history
        value: ''
        type: query
        description: Include the history of the profiles.
    docs: List trusted profiles in an account. Trusted profiles allow federated users to establish trust with IBM Cloud.
  - info:
      name: Create a trusted profile
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/profiles
      body:
        type: json
        data: '{}'
    docs: Create a new trusted profile for federated users to establish trust with IBM Cloud resources.
  - info:
      name: Get a trusted profile
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
      - name: include_activity
        value: ''
        type: query
        description: Include the activity of the profile.
    docs: Retrieve details of a specific trusted profile.
  - info:
      name: Update a trusted profile
      type: http
    http:
      method: PUT
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
      body:
        type: json
        data: '{}'
    docs: Update properties of an existing trusted profile.
  - info:
      name: Delete a trusted profile
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
    docs: Delete a trusted profile and its associated claim rules and links. This action cannot be undone.
- info:
    name: Claim Rules
    type: folder
  items:
  - info:
      name: List claim rules for a trusted profile
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id/rules
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
    docs: Retrieve all claim rules defined for a specific trusted profile.
  - info:
      name: Create a claim rule
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id/rules
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
      body:
        type: json
        data: '{}'
    docs: Create a claim rule for a trusted profile. Claim rules define conditions that federated users must meet to apply
      the profile.
  - info:
      name: Get a claim rule
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id/rules/:rule-id
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
      - name: rule-id
        value: ''
        type: path
        description: The unique identifier of the claim rule.
    docs: Retrieve details of a specific claim rule in a trusted profile.
  - info:
      name: Update a claim rule
      type: http
    http:
      method: PUT
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id/rules/:rule-id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
      - name: rule-id
        value: ''
        type: path
        description: The unique identifier of the claim rule.
      body:
        type: json
        data: '{}'
    docs: Update an existing claim rule for a trusted profile.
  - info:
      name: Delete a claim rule
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/profiles/:profile-id/rules/:rule-id
      params:
      - name: profile-id
        value: ''
        type: path
        description: The unique identifier of the trusted profile.
      - name: rule-id
        value: ''
        type: path
        description: The unique identifier of the claim rule.
    docs: Remove a claim rule from a trusted profile.
- info:
    name: Policies
    type: folder
  items:
  - info:
      name: List access policies
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/policies
      params:
      - name: account_id
        value: ''
        type: query
        description: The account ID to list policies for.
      - name: iam_id
        value: ''
        type: query
        description: Filter by the IAM ID of the subject.
      - name: access_group_id
        value: ''
        type: query
        description: Filter by access group ID.
      - name: type
        value: ''
        type: query
        description: Filter by policy type.
      - name: service_type
        value: ''
        type: query
        description: Filter by service type.
      - name: state
        value: ''
        type: query
        description: Filter by policy state.
      - name: limit
        value: ''
        type: query
        description: Maximum number of policies to return.
      - name: start
        value: ''
        type: query
        description: Pagination start token.
    docs: List access policies in an account. Results can be filtered by IAM ID, access group, service type, and state.
  - info:
      name: Create an access policy
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v1/policies
      body:
        type: json
        data: '{}'
    docs: Create a new access policy to grant a subject access to a resource. A policy defines a subject, roles, and resources.
  - info:
      name: Get an access policy
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v1/policies/:policy_id
      params:
      - name: policy_id
        value: ''
        type: path
        description: The unique identifier of the access policy.
    docs: Retrieve details of a specific access policy.
  - info:
      name: Replace an access policy
      type: http
    http:
      method: PUT
      url: https://iam.cloud.ibm.com/v1/policies/:policy_id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: policy_id
        value: ''
        type: path
        description: The unique identifier of the access policy.
      body:
        type: json
        data: '{}'
    docs: Replace an existing access policy with an updated definition. The entire policy is replaced.
  - info:
      name: Update policy state
      type: http
    http:
      method: PATCH
      url: https://iam.cloud.ibm.com/v1/policies/:policy_id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: policy_id
        value: ''
        type: path
        description: The unique identifier of the access policy.
      body:
        type: json
        data: '{}'
    docs: Activate or deactivate an existing access policy.
  - info:
      name: Delete an access policy
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v1/policies/:policy_id
      params:
      - name: policy_id
        value: ''
        type: path
        description: The unique identifier of the access policy.
    docs: Remove an access policy. This action cannot be undone.
- info:
    name: Roles
    type: folder
  items:
  - info:
      name: List IAM roles
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v2/roles
      params:
      - name: account_id
        value: ''
        type: query
        description: The account ID to list custom roles for.
      - name: service_name
        value: ''
        type: query
        description: Filter roles by the service they apply to.
      - name: source_service_name
        value: ''
        type: query
        description: Filter by the source service name for authorization policies.
      - name: policy_type
        value: ''
        type: query
        description: Filter by policy type.
      - name: service_group_id
        value: ''
        type: query
        description: Filter by the service group ID.
    docs: List system-defined and custom roles available in the account. Results can be filtered by service name.
  - info:
      name: Create a custom role
      type: http
    http:
      method: POST
      url: https://iam.cloud.ibm.com/v2/roles
      body:
        type: json
        data: '{}'
    docs: Create a custom role with a set of actions for a specific service. Custom roles extend the built-in platform and
      service roles.
  - info:
      name: Get a role
      type: http
    http:
      method: GET
      url: https://iam.cloud.ibm.com/v2/roles/:role_id
      params:
      - name: role_id
        value: ''
        type: path
        description: The unique identifier of the role.
    docs: Retrieve details of a specific role.
  - info:
      name: Replace a custom role
      type: http
    http:
      method: PUT
      url: https://iam.cloud.ibm.com/v2/roles/:role_id
      headers:
      - name: If-Match
        value: ''
      params:
      - name: role_id
        value: ''
        type: path
        description: The unique identifier of the role.
      body:
        type: json
        data: '{}'
    docs: Replace the definition of an existing custom role with an updated set of actions.
  - info:
      name: Delete a custom role
      type: http
    http:
      method: DELETE
      url: https://iam.cloud.ibm.com/v2/roles/:role_id
      params:
      - name: role_id
        value: ''
        type: path
        description: The unique identifier of the role.
    docs: Remove a custom role. System-defined roles cannot be deleted.
bundled: true