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

# List all published OpenAPI specifications

> Retrieves all published OpenAPI specifications from all platform services, sorted by service name. Returns the complete YAML content along with creation and update timestamps. Requires `devtools.documentation.viewer` permission.



## OpenAPI

````yaml api-reference/devtools.yaml post /documentation/openapi/list
openapi: 3.0.3
info:
  title: devtools
  description: >-
    The Devtools service automatically keeps API documentation current across
    all platform services by syncing OpenAPI specs from GitHub and publishing
    them to a central location. It scans the repository, cleans up the
    documentation files, and makes them available to developers without any
    manual work.
  version: 1.0.0
servers:
  - url: https://devtools.platform.arb.inc
security: []
tags:
  - name: /
  - name: documentation
paths:
  /documentation/openapi/list:
    post:
      tags:
        - documentation
      summary: List all published OpenAPI specifications
      description: >-
        Retrieves all published OpenAPI specifications from all platform
        services, sorted by service name. Returns the complete YAML content
        along with creation and update timestamps. Requires
        `devtools.documentation.viewer` permission.
      operationId: listOpenAPISpecs
      responses:
        '200':
          description: Successfully retrieved OpenAPI specifications
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    description: List of published OpenAPI specifications
                    items:
                      type: object
                      properties:
                        created:
                          type: string
                          format: date-time
                          description: When the specification was first created
                          example: '2025-08-01T14:30:00Z'
                        updated:
                          type: string
                          format: date-time
                          description: When the specification was last updated
                          example: '2025-08-15T10:30:00Z'
                        service:
                          type: string
                          description: Name of the service
                          example: auth
                        yaml:
                          type: string
                          description: Complete OpenAPI specification in YAML format
                          example: |-
                            openapi: 3.0.3
                            info:
                              title: auth
                              version: 1.0.0
                            ...
        '403':
          description: Forbidden - missing required permission
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'missing required permission: devtools.documentation.viewer'
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````