Akeyless

Akeyless List Roles API

The List Roles API from Akeyless — 1 operation(s) for list roles.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 1

POST /list-roles List roles #

Documentation

📖
Documentation
https://docs.akeyless.io/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/akeyless/refs/heads/main/openapi/akeyless-list-roles-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/akeyless/refs/heads/main/json-schema/akeyless-secret.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/akeyless/refs/heads/main/json-schema/akeyless-auth.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/akeyless/refs/heads/main/json-schema/akeyless-dynamic-secret.json

Other Resources

🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/akeyless/refs/heads/main/vocabulary/akeyless-vocabulary.yml
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/akeyless/refs/heads/main/json-ld/akeyless-context.jsonld

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/akeyless:akeyless-list-roles-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.

GitHub Google LinkedIn

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

OpenAPI Specification

akeyless-list-roles-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: support@akeyless.io
    name: Akeyless
    url: http://akeyless.io
  description: The purpose of this application is to provide access to Akeyless API.
  title: Akeyless List Roles API
  version: '2.0'
servers:
- url: https://api.akeyless.io/
tags:
- name: List Roles
paths:
  /list-roles:
    post:
      operationId: listRoles
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/listRoles'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRolesOutput'
          description: listRolesResponse wraps response body.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONError'
          description: 'errorResponse wraps any error to return it as a JSON object with one "error"

            field.'
      tags:
      - List Roles
      x-codegen-request-body-name: body
      summary: List roles
      x-summary-source: derived
components:
  schemas:
    RuleAssigner:
      example:
        unique_id: unique_id
        access_id: access_id
      properties:
        access_id:
          type: string
          x-go-name: AccessId
        unique_id:
          type: string
          x-go-name: UniqueId
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
    ListRolesOutput:
      example:
        next_page: next_page
        roles:
        - role_name: role_name
          client_permissions:
          - client_permissions
          - client_permissions
          role_auth_methods_assoc:
          - assoc_id: assoc_id
            auth_method_name: auth_method_name
            auth_method_sub_claims:
              key:
              - auth_method_sub_claims
              - auth_method_sub_claims
            auth_method_access_id: auth_method_access_id
            sub_claims_case_sensitive: true
          - assoc_id: assoc_id
            auth_method_name: auth_method_name
            auth_method_sub_claims:
              key:
              - auth_method_sub_claims
              - auth_method_sub_claims
            auth_method_access_id: auth_method_access_id
            sub_claims_case_sensitive: true
          access_date: 2000-01-23 04:56:07+00:00
          modification_date: 2000-01-23 04:56:07+00:00
          comment: comment
          rules:
            path_rules:
            - path: path
              start_time: 5
              capabilities:
              - capabilities
              - capabilities
              number_of_allowed_access: 5
              is_limit_access: true
              assigners:
              - unique_id: unique_id
                access_id: access_id
              - unique_id: unique_id
                access_id: access_id
              number_of_access_used: 1
              type: type
              ttl: 2
            - path: path
              start_time: 5
              capabilities:
              - capabilities
              - capabilities
              number_of_allowed_access: 5
              is_limit_access: true
              assigners:
              - unique_id: unique_id
                access_id: access_id
              - unique_id: unique_id
                access_id: access_id
              number_of_access_used: 1
              type: type
              ttl: 2
            admin: true
          creation_date: 2000-01-23 04:56:07+00:00
        - role_name: role_name
          client_permissions:
          - client_permissions
          - client_permissions
          role_auth_methods_assoc:
          - assoc_id: assoc_id
            auth_method_name: auth_method_name
            auth_method_sub_claims:
              key:
              - auth_method_sub_claims
              - auth_method_sub_claims
            auth_method_access_id: auth_method_access_id
            sub_claims_case_sensitive: true
          - assoc_id: assoc_id
            auth_method_name: auth_method_name
            auth_method_sub_claims:
              key:
              - auth_method_sub_claims
              - auth_method_sub_claims
            auth_method_access_id: auth_method_access_id
            sub_claims_case_sensitive: true
          access_date: 2000-01-23 04:56:07+00:00
          modification_date: 2000-01-23 04:56:07+00:00
          comment: comment
          rules:
            path_rules:
            - path: path
              start_time: 5
              capabilities:
              - capabilities
              - capabilities
              number_of_allowed_access: 5
              is_limit_access: true
              assigners:
              - unique_id: unique_id
                access_id: access_id
              - unique_id: unique_id
                access_id: access_id
              number_of_access_used: 1
              type: type
              ttl: 2
            - path: path
              start_time: 5
              capabilities:
              - capabilities
              - capabilities
              number_of_allowed_access: 5
              is_limit_access: true
              assigners:
              - unique_id: unique_id
                access_id: access_id
              - unique_id: unique_id
                access_id: access_id
              number_of_access_used: 1
              type: type
              ttl: 2
            admin: true
          creation_date: 2000-01-23 04:56:07+00:00
      properties:
        next_page:
          type: string
          x-go-name: NextPage
        roles:
          items:
            $ref: '#/components/schemas/Role'
          type: array
          x-go-name: Roles
      title: ListRolesOutput is a list of roles.
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
    Rules:
      example:
        path_rules:
        - path: path
          start_time: 5
          capabilities:
          - capabilities
          - capabilities
          number_of_allowed_access: 5
          is_limit_access: true
          assigners:
          - unique_id: unique_id
            access_id: access_id
          - unique_id: unique_id
            access_id: access_id
          number_of_access_used: 1
          type: type
          ttl: 2
        - path: path
          start_time: 5
          capabilities:
          - capabilities
          - capabilities
          number_of_allowed_access: 5
          is_limit_access: true
          assigners:
          - unique_id: unique_id
            access_id: access_id
          - unique_id: unique_id
            access_id: access_id
          number_of_access_used: 1
          type: type
          ttl: 2
        admin: true
      properties:
        admin:
          description: Is admin
          type: boolean
          x-go-name: Admin
        path_rules:
          description: The path the rules refers to
          items:
            $ref: '#/components/schemas/PathRule'
          type: array
          x-go-name: PathRules
      title: Rules are a part of AKEYLESS RBAC.
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
    listRoles:
      properties:
        filter:
          description: Filter by item name or part of it
          type: string
          x-go-name: Filter
        json:
          description: Set output format to JSON
          type: boolean
          x-go-name: Json
        pagination-token:
          description: Next page reference
          type: string
          x-go-name: PaginationToken
        token:
          description: Authentication token (see `/auth` and `/configure`)
          type: string
          x-go-name: Profile
        uid-token:
          description: The universal identity token, Required only for universal_identity authentication
          type: string
          x-go-name: UIDToken
      title: listRoles is a command that returns a list of roles.
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/client/commands
    Role:
      example:
        role_name: role_name
        client_permissions:
        - client_permissions
        - client_permissions
        role_auth_methods_assoc:
        - assoc_id: assoc_id
          auth_method_name: auth_method_name
          auth_method_sub_claims:
            key:
            - auth_method_sub_claims
            - auth_method_sub_claims
          auth_method_access_id: auth_method_access_id
          sub_claims_case_sensitive: true
        - assoc_id: assoc_id
          auth_method_name: auth_method_name
          auth_method_sub_claims:
            key:
            - auth_method_sub_claims
            - auth_method_sub_claims
          auth_method_access_id: auth_method_access_id
          sub_claims_case_sensitive: true
        access_date: 2000-01-23 04:56:07+00:00
        modification_date: 2000-01-23 04:56:07+00:00
        comment: comment
        rules:
          path_rules:
          - path: path
            start_time: 5
            capabilities:
            - capabilities
            - capabilities
            number_of_allowed_access: 5
            is_limit_access: true
            assigners:
            - unique_id: unique_id
              access_id: access_id
            - unique_id: unique_id
              access_id: access_id
            number_of_access_used: 1
            type: type
            ttl: 2
          - path: path
            start_time: 5
            capabilities:
            - capabilities
            - capabilities
            number_of_allowed_access: 5
            is_limit_access: true
            assigners:
            - unique_id: unique_id
              access_id: access_id
            - unique_id: unique_id
              access_id: access_id
            number_of_access_used: 1
            type: type
            ttl: 2
          admin: true
        creation_date: 2000-01-23 04:56:07+00:00
      properties:
        access_date:
          format: date-time
          type: string
          x-go-name: AccessDate
        client_permissions:
          items:
            type: string
          type: array
          x-go-name: ClientPermissions
        comment:
          type: string
          x-go-name: Comment
        creation_date:
          format: date-time
          type: string
          x-go-name: CreationDate
        modification_date:
          format: date-time
          type: string
          x-go-name: ModificationDate
        role_auth_methods_assoc:
          items:
            $ref: '#/components/schemas/RoleAuthMethodAssociation'
          type: array
          x-go-name: RoleAuthMethodsAssoc
        role_name:
          type: string
          x-go-name: RoleName
        rules:
          $ref: '#/components/schemas/Rules'
      title: Role includes role details.
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
    PathRule:
      example:
        path: path
        start_time: 5
        capabilities:
        - capabilities
        - capabilities
        number_of_allowed_access: 5
        is_limit_access: true
        assigners:
        - unique_id: unique_id
          access_id: access_id
        - unique_id: unique_id
          access_id: access_id
        number_of_access_used: 1
        type: type
        ttl: 2
      properties:
        assigners:
          items:
            $ref: '#/components/schemas/RuleAssigner'
          type: array
          x-go-name: Assigners
        capabilities:
          description: The approved/denied capabilities in the path
          items:
            type: string
          type: array
          x-go-name: Capabilities
        is_limit_access:
          description: flag that indicate that this rule is allowed to be access RemainingAccess of times.
          type: boolean
          x-go-name: IsLimitAccess
        number_of_access_used:
          format: int64
          type: integer
          x-go-name: NumberOfAccessUsed
        number_of_allowed_access:
          format: int64
          type: integer
          x-go-name: NumberOfAllowedAccess
        path:
          description: The path the rule refers to
          type: string
          x-go-name: Path
        start_time:
          format: int64
          type: integer
          x-go-name: StartTime
        ttl:
          format: int64
          type: integer
          x-go-name: TTL
        type:
          title: PathRuleType defines a kind of every PathRule assigned to a Role.
          type: string
          x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
      title: PathRule is a single rule used in AKEYLESS RBAC.
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
    RoleAuthMethodAssociation:
      description: 'RoleAuthMethodAssociation includes details of an association between a role

        and an auth method.'
      example:
        assoc_id: assoc_id
        auth_method_name: auth_method_name
        auth_method_sub_claims:
          key:
          - auth_method_sub_claims
          - auth_method_sub_claims
        auth_method_access_id: auth_method_access_id
        sub_claims_case_sensitive: true
      properties:
        assoc_id:
          type: string
          x-go-name: AssociationID
        auth_method_access_id:
          type: string
          x-go-name: AuthMethodAccessID
        auth_method_name:
          type: string
          x-go-name: AuthMethodName
        auth_method_sub_claims:
          additionalProperties:
            items:
              type: string
            type: array
          type: object
          x-go-name: AuthMethodSubClaims
        sub_claims_case_sensitive:
          type: boolean
          x-go-name: IsSubClaimsCaseSensitive
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/infra/types
    JSONError:
      properties:
        error:
          type: string
          x-go-name: Err
      title: JSONError wraps an error with JSON object.
      type: object
      x-go-package: akeyless.io/akeyless-main-repo/go/src/client