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

# Download OpenAPI specification (YAML)

> Returns the OpenAPI 3 document as YAML (no authentication).



## OpenAPI

````yaml /openapi.yaml get /api/v1/openapi.yaml
openapi: 3.0.3
info:
  title: Folkyn API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://folkyn.com
  description: >-
    Team API key; responses in `data`, errors in `error` with `X-Request-Id`.
    Spec at `/api/v1/openapi.yaml` and `/api/v1/openapi.json` (no key). **60
    requests/minute** per key on `/api/v1/*`.
servers:
  - url: https://api.folkyn.com
    description: Production
security:
  - bearerAuth: []
  - ApiKeyHeader: []
tags:
  - name: Specification
    description: OpenAPI document download (no authentication)
  - name: Project codes
    description: Team project codes
  - name: Team tags
    description: Team tags
  - name: Teams
    description: Organizational teams (team units) and member lists
  - name: Missions
    description: Team missions
  - name: Freelancers
    description: Team freelancers and invitations
  - name: Activity reports
    description: Activity reports (CRA)
  - name: Accounting
    description: Accounting entries
paths:
  /api/v1/openapi.yaml:
    get:
      tags:
        - Specification
      summary: Download OpenAPI specification (YAML)
      description: Returns the OpenAPI 3 document as YAML (no authentication).
      operationId: getOpenApiYaml
      responses:
        '200':
          description: OpenAPI 3.0 document
          content:
            text/yaml:
              schema:
                type: string
        '404':
          description: Specification file missing on server
          content:
            text/plain:
              schema:
                type: string
        '500':
          description: Invalid or unreadable specification
          content:
            text/plain:
              schema:
                type: string
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Use `Authorization: Bearer <your_api_key>`'
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-Api-Key

````