> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List API key permissions

> Retrieve all available API key permissions. Permissions define specific actions on specific resource types that can be granted to API keys. This is reference data and does not require specific resource permissions.



## OpenAPI

````yaml https://api.sevalla.com/v3/openapi.json get /resources/rbac/api-key-permissions
openapi: 3.1.0
info:
  title: Sevalla API docs
  version: 1.0.0
servers:
  - url: https://api.sevalla.com/v3
security:
  - bearerAuth: []
paths:
  /resources/rbac/api-key-permissions:
    get:
      tags:
        - Resources
      summary: List API key permissions
      description: >-
        Retrieve all available API key permissions. Permissions define specific
        actions on specific resource types that can be granted to API keys. This
        is reference data and does not require specific resource permissions.
      operationId: listApiKeyPermissionsV3
      responses:
        '200':
          description: List of available API key permissions
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                      pattern: >-
                        ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                      description: Unique identifier for the permission
                      example: fb5e5168-4281-4bec-94c5-0d1584e9e657
                    name:
                      type: string
                      description: Name of the permission
                      example: app:read
                    description:
                      type: string
                      description: >-
                        Human-readable description of what this permission
                        allows
                      example: View applications
                    resource:
                      type: string
                      enum:
                        - APP
                        - PIPELINE
                        - DATABASE
                        - STATIC_SITE
                        - LOAD_BALANCER
                        - OBJECT_STORAGE
                        - BILLING
                        - COMPANY
                        - PROJECT
                        - WEBHOOK
                        - API_KEY
                        - REGISTRY_CREDENTIAL
                      description: >-
                        Resource type this permission applies to. `APP` -
                        applications. `PIPELINE` - pipelines. `DATABASE` -
                        databases. `STATIC_SITE` - static sites. `LOAD_BALANCER`
                        - load balancers. `OBJECT_STORAGE` - object storage.
                        `BILLING` - billing. `COMPANY` - company settings.
                        `PROJECT` - projects. `WEBHOOK` - webhooks. `API_KEY` -
                        API keys. `REGISTRY_CREDENTIAL` - Docker registry
                        credentials.
                      example: APP
                    action:
                      type: string
                      enum:
                        - CREATE
                        - READ
                        - UPDATE
                        - DELETE
                      description: >-
                        Action this permission allows on the resource. `CREATE`
                        - create new resources. `READ` - view resources.
                        `UPDATE` - modify resources. `DELETE` - remove
                        resources.
                      example: READ
                  required:
                    - id
                    - name
                    - description
                    - resource
                    - action
                  additionalProperties: false
                description: List of available API key permissions
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Unauthorized
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 401
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
                    example: Internal Server Error
                  status:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: HTTP status code
                    example: 500
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err-abc-123
                        type: string
                      message:
                        description: Additional error details or instructions
                        example: >-
                          If you need assistance, please contact support and
                          provide this error code.
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication. Pass your API key as a Bearer token in the
        Authorization header.

````