Alphaus Iam API

(BETA) IAM API. Base URL: https://api.alphaus.cloud/m/blue

Operations 39

GET /iam/v1/apiclients Lists all API clients belonging to the caller. #
POST /iam/v1/apiclients Creates an API client for the caller. #
DELETE /iam/v1/apiclients/{id} Deletes an API client belonging to the caller. #
GET /iam/v1/experimentalui/preferences Gets experimental UI preferences for the authenticated MSP. #
PUT /iam/v1/experimentalui/preferences/{componentId} Creates or updates an experimental UI preference for a specific component. #
GET /iam/v1/grouprootusers WORK-IN-PROGRESS: Retrieves all the existing group root users asscoiated with the organization. #
POST /iam/v1/grouprootusers WORK-IN-PROGRESS: Creates a new root user for a billing group or access group. #
GET /iam/v1/grouprootusers/{id} WORK-IN-PROGRESS: Retrieves a group root user. #
DELETE /iam/v1/grouprootusers/{id} WORK-IN-PROGRESS: Deletes an existing group root user. #
GET /iam/v1/grouprootusers/{id}/features WORK-IN-PROGRESS: Retrieves the features available to a user on an Alphaus product. #
PUT /iam/v1/grouprootusers/{id}/features WORK-IN-PROGRESS: Updates the features available to a user on an Alphaus product. #
GET /iam/v1/idps Lists all SSO Identity Providers (IdP). #
POST /iam/v1/idps Registers an SSO Identity Provider (IdP). #
DELETE /iam/v1/idps/{id} Deletes an SSO Identity Provider (IdP). #
GET /iam/v1/ipfilters Lists all IP filters. At the moment, this API is only available to root users. #
POST /iam/v1/ipfilters Creates an IP filter item for IP blacklisting or whitelisting. At the moment, this API is only available to root users. #
DELETE /iam/v1/ipfilters/{id} Deletes an IP filter item. At the moment, this API is only available to root users. #
GET /iam/v1/metadata/{id} WORK-IN-PROGRESS: Get Sub User Metadata for login user's organization based on user identity #
GET /iam/v1/mfausers WORK-IN-PROGRESS: List MFA users info for login user's organization based on status. #
POST /iam/v1/partners/{id}/token BETA: Creates a partner token for custom integrations. Available only to Ripple and Cover users. #
POST /iam/v1/partners/{id}/token:refresh BETA: Refreshes an expired partner token. Only partners are expected to call this API. #
POST /iam/v1/password:reset WORK-IN-PROGRESS: Validate reset password link and proceed to update password #
GET /iam/v1/permissions WORK-IN-PROGRESS: Lists all permissions based on the input's scope. For reference, supported permissions can be found on [https://github.com/mobingi/rbac-permissions]. #
POST /iam/v1/ripple/password:requestresetcode WORK-IN-PROGRESS: Send an email reset code #
POST /iam/v1/ripple/password:reset WORK-IN-PROGRESS: Reset ripple password using code from email #
GET /iam/v1/roles WORK-IN-PROGRESS: Lists all available roles. #
POST /iam/v1/roles WORK-IN-PROGRESS: Creates a role. If your `permissions` list contains an `Admin` entry, all other entries will be discarded except `Admin`. Roles are root user-level. That means al #
DELETE /iam/v1/roles/{namespace}/{name} WORK-IN-PROGRESS: Deletes a role. Deleting a role will also remove all mappings. #
PUT /iam/v1/roles/{namespace}/{name} WORK-IN-PROGRESS: Updates a role. If role name is different, rename mapped role name. #
GET /iam/v1/userroles WORK-IN-PROGRESS: Lists roles attached to the caller or the input. #
POST /iam/v1/userroles WORK-IN-PROGRESS: Maps roles to a subuser. You can only map (or attach) up to 5 roles to a user per namespace. There is no limit for filtering rules per user. #
PUT /iam/v1/userroles WORK-IN-PROGRESS: Updates user-to-role mappings. You can only map (or attach) up to 5 roles to a user per namespace. There is no limit for filtering rules per user. #
GET /iam/v1/users Lists all subusers. #
POST /iam/v1/users Creates a subuser. #
GET /iam/v1/users/{id} Gets subuser information. This call includes all of the subuser metadata. See [https://alphauslabs.github.io/blueapi/] for the list of supported attributes. If the `{name}` paramet #
DELETE /iam/v1/users/{id} Deletes a subuser. #
GET /iam/v1/whoami Gets user information about the caller. This call includes all of the user metadata. See [https://alphauslabs.github.io/blueapi/] for the list of supported attributes. #
POST /iam/v1/{domain}/account:unlock WORK-IN-PROGRESS: Unlocks ripple or wave user account. #
POST /iam/v1/{user}/password:verify WORK-IN-PROGRESS: Verify User Input For Reset Password #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/alphaus-iam-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

alphaus-iam-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Blue API reference Admin Iam API
  description: 'Alphaus provides an API for interacting with its services. Blue API is a RESTful API that can be accessed by an HTTP client such as `curl`, or any HTTP library which is part of most modern programming languages. This API reference is autogenerated from [protocol buffers](https://developers.google.com/protocol-buffers) defined in this [repository](https://github.com/alphauslabs/blueapi), together with our supported [client libraries](https://alphauslabs.github.io/docs/blueapi/client-sdks/). See the official [documentation](https://alphauslabs.github.io/docs/blueapi/overview/) for more information.


    You may encounter the following feature maturity indicators:

    - **(WORK-IN-PROGRESS)** - Development is ongoing, don''t use yet;

    - **(BETA)** - New or experimental features, subject to changes; and

    - **(DEPRECATED)** - Outdated or replaced features.


    Some endpoints, especially those that return lists of resources, have streaming responses; newline-separated stream of “chunks”. Each chunk is an envelope that can contain either a response message or an error. Only the last chunk will include an error, if any.'
  version: v1
servers:
- url: https://api.alphaus.cloud/m/blue
  description: Base URL reconciled from apis.yml
tags:
- name: Iam
  description: '(BETA) IAM API. Base URL: https://api.alphaus.cloud/m/blue'
  externalDocs:
    description: Service definition
    url: https://github.com/alphauslabs/blueapi/tree/main/iam/
paths:
  /iam/v1/apiclients:
    get:
      summary: Lists all API clients belonging to the caller.
      operationId: Iam_ListApiClients
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/apiApiClient'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of apiApiClient
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
    post:
      summary: Creates an API client for the caller.
      operationId: Iam_CreateApiClient
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiApiClient'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateApiClientRequest'
        description: Request message for the Iam.CreateApiClient rpc.
        required: true
  /iam/v1/apiclients/{id}:
    delete:
      summary: Deletes an API client belonging to the caller.
      operationId: Iam_DeleteApiClient
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The client id to delete.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/experimentalui/preferences:
    get:
      summary: Gets experimental UI preferences for the authenticated MSP.
      operationId: Iam_GetExperimentalUIPreferences
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GetExperimentalUIPreferencesResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
  /iam/v1/experimentalui/preferences/{componentId}:
    put:
      summary: Creates or updates an experimental UI preference for a specific component.
      operationId: Iam_UpsertExperimentalUIPreference
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1UpsertExperimentalUIPreferenceResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: componentId
        description: The component identifier to create or update a preference for.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IamUpsertExperimentalUIPreferenceBody'
        required: true
  /iam/v1/grouprootusers:
    get:
      summary: 'WORK-IN-PROGRESS: Retrieves all the existing group root users asscoiated with the organization.'
      operationId: Iam_ListGroupRootUsers
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/apiGroupRootUser'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of apiGroupRootUser
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
    post:
      summary: 'WORK-IN-PROGRESS: Creates a new root user for a billing group or access group.'
      operationId: Iam_CreateGroupRootUser
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiGroupRootUser'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateGroupRootUserRequest'
        required: true
  /iam/v1/grouprootusers/{id}:
    get:
      summary: 'WORK-IN-PROGRESS: Retrieves a group root user.'
      operationId: Iam_GetGroupRootUser
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiGroupRootUser'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
    delete:
      summary: 'WORK-IN-PROGRESS: Deletes an existing group root user.'
      operationId: Iam_DeleteGroupRootUser
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/grouprootusers/{id}/features:
    get:
      summary: 'WORK-IN-PROGRESS: Retrieves the features available to a user on an Alphaus product.'
      description: For a list of valid feature flags, see our documentation at https://labs.alphaus.cloud/docs/blueapi/apis/iam/.
      operationId: Iam_GetFeatureFlags
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiFeatureFlags'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
    put:
      summary: 'WORK-IN-PROGRESS: Updates the features available to a user on an Alphaus product.'
      description: For a list of valid feature flags, see our documentation at https://labs.alphaus.cloud/docs/blueapi/apis/iam/.
      operationId: Iam_UpdateFeatureFlags
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiFeatureFlags'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IamUpdateFeatureFlagsBody'
        required: true
  /iam/v1/idps:
    get:
      summary: Lists all SSO Identity Providers (IdP).
      operationId: Iam_ListIdentityProviders
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ListIdentityProvidersResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
    post:
      summary: Registers an SSO Identity Provider (IdP).
      operationId: Iam_CreateIdentityProvider
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateIdentityProviderRequest'
        description: Request message for the Iam.CreateIdentityProvider rpc.
        required: true
  /iam/v1/idps/{id}:
    delete:
      summary: Deletes an SSO Identity Provider (IdP).
      operationId: Iam_DeleteIdentityProvider
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The IdP id to delete.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/ipfilters:
    get:
      summary: Lists all IP filters. At the moment, this API is only available to root users.
      operationId: Iam_ListIpFilters
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1IpFilter'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1IpFilter
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
    post:
      summary: Creates an IP filter item for IP blacklisting or whitelisting. At the moment, this API is only available to root users.
      operationId: Iam_CreateIpFilter
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1IpFilter'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateIpFilterRequest'
        description: Request message for the Iam.CreateIpFilter rpc.
        required: true
  /iam/v1/ipfilters/{id}:
    delete:
      summary: Deletes an IP filter item. At the moment, this API is only available to root users.
      operationId: Iam_DeleteIpFilter
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: The IP filter id to delete.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/metadata/{id}:
    get:
      summary: 'WORK-IN-PROGRESS: Get Sub User Metadata for login user''s organization based on user identity'
      operationId: Iam_GetSubUserMetadata
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiSubUser'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The parent ID
        in: path
        required: true
        schema:
          type: string
      - name: subId
        description: Optional. The sub-user ID
        in: query
        required: false
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/mfausers:
    get:
      summary: 'WORK-IN-PROGRESS: List MFA users info for login user''s organization based on status.'
      operationId: Iam_GetMFAUsers
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1MFAUsersInfoResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: status
        description: 'Optional. If non empty: list users by status. Otherwise will list all MFA users.'
        in: query
        required: false
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/partners/{id}/token:
    post:
      summary: 'BETA: Creates a partner token for custom integrations. Available only to Ripple and Cover users.'
      operationId: Iam_CreatePartnerToken
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1PartnerToken'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. Partner id or audience for the token.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IamCreatePartnerTokenBody'
        required: true
  /iam/v1/partners/{id}/token:refresh:
    post:
      summary: 'BETA: Refreshes an expired partner token. Only partners are expected to call this API.'
      operationId: Iam_RefreshPartnerToken
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1PartnerToken'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. Partner id or audience for the token.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IamRefreshPartnerTokenBody'
        required: true
  /iam/v1/password:reset:
    post:
      summary: 'WORK-IN-PROGRESS: Validate reset password link and proceed to update password'
      operationId: Iam_ValidateResetPasswordLinkAndChangePassword
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ValidateResetPasswordLinkAndChangePasswordResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ValidateResetPasswordLinkAndChangePasswordRequest'
        description: Request for message Iam.ValidateVerificationCode rpc.
        required: true
  /iam/v1/permissions:
    get:
      summary: 'WORK-IN-PROGRESS: Lists all permissions based on the input''s scope. For reference, supported permissions can be found on [https://github.com/mobingi/rbac-permissions].'
      operationId: Iam_ListPermissions
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ListPermissionsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: subUser
        description: Optional. The subuser to query. If empty (default), query all available permissions. If set to a valid subuser, query that subuser's permissions, if allowed. You can also set this field to `me` to query your own permissions.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/ripple/password:requestresetcode:
    post:
      summary: 'WORK-IN-PROGRESS: Send an email reset code'
      operationId: Iam_SendRipplePasswordResetCode
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1SendRipplePasswordResetCodeRequest'
        required: true
  /iam/v1/ripple/password:reset:
    post:
      summary: 'WORK-IN-PROGRESS: Reset ripple password using code from email'
      operationId: Iam_ResetRipplePassword
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ResetRipplePasswordResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ResetRipplePasswordRequest'
        required: true
  /iam/v1/roles:
    get:
      summary: 'WORK-IN-PROGRESS: Lists all available roles.'
      operationId: Iam_ListRoles
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ListRolesResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: namespace
        description: Optional. If not set, all roles will be returned.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Iam
    post:
      summary: 'WORK-IN-PROGRESS: Creates a role. If your `permissions` list contains an `Admin` entry, all other entries will be discarded except `Admin`. Roles are root user-level. That means all roles created by the root user, or any subuser that has permissions to create roles, are available to all subusers.'
      operationId: Iam_CreateRole
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiRole'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateRoleRequest'
        description: Request message for the Iam.CreateRole rpc.
        required: true
  /iam/v1/roles/{namespace}/{name}:
    delete:
      summary: 'WORK-IN-PROGRESS: Deletes a role. Deleting a role will also remove all mappings.'
      operationId: Iam_DeleteRole
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: namespace
        description: Required. The parent namespace.
        in: path
        required: true
        schema:
          type: string
      - name: name
        description: Required. The role name to delete.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
    put:
      summary: 'WORK-IN-PROGRESS: Updates a role. If role name is different, rename mapped role name.'
      operationId: Iam_UpdateRole
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiRole'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: namespace
        description: Required. The new namespace.
        in: path
        required: true
        schema:
          type: string
      - name: name
        description: Required. The role name to update.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IamUpdateRoleBody'
        required: true
  /iam/v1/userroles:
    get:
      summary: 'WORK-IN-PROGRESS: Lists roles attached to the caller or the input.'
      operationId: Iam_ListUserRoleMappings
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ListUserRoleMappingsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: subUser
        description: Optional. The subuser to query. Defaults to caller if not set.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Iam
    post:
      summary: 'WORK-IN-PROGRESS: Maps roles to a subuser. You can only map (or attach) up to 5 roles to a user per namespace. There is no limit for filtering rules per user.'
      operationId: Iam_CreateUserRoleMapping
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1CreateUserRoleMappingResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateUserRoleMappingRequest'
        description: Request message for the Iam.CreateUserRoleMapping rpc.
        required: true
    put:
      summary: 'WORK-IN-PROGRESS: Updates user-to-role mappings. You can only map (or attach) up to 5 roles to a user per namespace. There is no limit for filtering rules per user.'
      operationId: Iam_UpdateUserRoleMapping
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1UpdateUserRoleMappingResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1UpdateUserRoleMappingRequest'
        description: Request message for the Iam.UpdateUserRoleMapping rpc.
        required: true
  /iam/v1/users:
    get:
      summary: Lists all subusers.
      operationId: Iam_ListUsers
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/blueapiApiUser'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of blueapiApiUser
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
    post:
      summary: Creates a subuser.
      operationId: Iam_CreateUser
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiUser'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateUserRequest'
        description: Request message for the Iam.CreateUser rpc.
        required: true
  /iam/v1/users/{id}:
    get:
      summary: 'Gets subuser information. This call includes all of the subuser metadata. See

        [https://alphauslabs.github.io/blueapi/] for the list of supported attributes.

        If the `{name}` parameter is `me` or `-`, returns the caller information, which

        is equivalent to `WhoAmI()` or `GET:/iam/v*/whoami`.'
      operationId: Iam_GetUser
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiUser'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
    delete:
      summary: Deletes a subuser.
      operationId: Iam_DeleteUser
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. The subuser name to delete.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Iam
  /iam/v1/whoami:
    get:
      summary: 'Gets user information about the caller. This call includes all of the user metadata.

        See [https://alphauslabs.github.io/blueapi/] for the list of supported attributes.'
      operationId: Iam_WhoAmI
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiUser'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Iam
  /iam/v1/{domain}/account:unlock:
    post:
      summary: 'WORK-IN-PROGRESS: Unlocks ripple or wave user account.'
      operationId: Iam_UnlockUserAccount
      responses:
        '200':
          description: A successful response.
          content:

# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/alphaus/refs/heads/main/openapi/alphaus-iam-api-openapi.yml