openapi: 3.0.3
info:
    title: devtools
    description: Devtools is like a toolbox just for engineers working on the platform. It holds special functions and processes that make their work faster and easier, like gathering all the platform’s documentation in one place and publishing it. This service isn’t built for end users to interact with directly, but it plays a big part in keeping the platform organized and up to date.
    version: 1.0.0
servers:
    - url: https://devtools.platform.arb.inc
paths:
    /:
        get:
            summary: Get basic service information
            description: Returns a plain text welcome message with the service name and creation date.
            operationId: getRoot
            responses:
                '200':
                    description: Successfully retrieved welcome message.
                    content:
                        text/plain:
                            schema:
                                type: string
                                example: Welcome to the devtools service. Created on July 30, 2025 by Al Beebe
            tags:
                - /
    /documentation/openapi/list:
        post:
            summary: List OpenAPI specifications
            description: Retrieves a list of OpenAPI YAML definitions for services.
            operationId: listOpenAPIDocs
            security:
                - bearerAuth: []
            responses:
                '200':
                    description: A list of OpenAPI specs.
                    content:
                        application/json:
                            schema:
                                type: object
                                properties:
                                    results:
                                        type: array
                                        items:
                                            type: object
                                            properties:
                                                created:
                                                    type: string
                                                    format: date-time
                                                    description: Timestamp when the OpenAPI spec was created.
                                                    example: "2024-01-15T10:00:00Z"
                                                updated:
                                                    type: string
                                                    format: date-time
                                                    description: Timestamp when the OpenAPI spec was last updated.
                                                    example: "2024-06-12T08:30:00Z"
                                                service:
                                                    type: string
                                                    description: The name of the service the OpenAPI spec belongs to.
                                                    example: "devtools"
                                                yaml:
                                                    type: string
                                                    description: The full OpenAPI spec in YAML format.
                                                    example: |
                                                        openapi: 3.0.3
                                                        info:
                                                          title: Devtools Service
                                                          version: 1.0.0
            tags:
                - documentation
components:
    securitySchemes:
        bearerAuth:
            type: http
            description: access token
            scheme: bearer
            bearerFormat: JWT
tags:
    - name: /
    - name: documentation