studiomeyer-io Consultation API

openapi: 3.2.0
info:
  title: StudioMeyer Public Consultation API
  version: 1.0.0
  description: Public website endpoints, no API key required. JSON bodies required for POST; quote accepts an empty object. Major versions use /api/v{major}; breaking changes receive a new major-version URL. Deprecations announce the replacement in documentation and response headers; a sunset date is published only when scheduled. The separate authenticated API Platform is documented at /api/openapi.
  contact:
    email: hello@studiomeyer.io
servers:
- url: https://studiomeyer.io
security: []
tags:
- name: Consultation
paths:
  /api/v1/consultation:
    post:
      summary: Request a free introductory consultation.
      operationId: post_consultation
      responses:
        '200':
          description: JSON response
          headers:
            RateLimit:
              description: Remaining requests and seconds to reset for the named policy (HTTP RateLimit draft).
              schema:
                type: string
            RateLimit-Policy:
              description: Named policy, request quota and window in seconds (HTTP RateLimit draft).
              schema:
                type: string
            X-RateLimit-Limit:
              description: Request quota for the policy.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Reset time as Unix epoch seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                  id:
                    type: string
                  message:
                    type: string
                  consultation:
                    type: object
                    properties:
                      type:
                        type: string
                      duration:
                        type: string
                      format:
                        type: string
                      topic:
                        type: string
                      responseTime:
                        type: string
                    required:
                    - type
                    - duration
                    - format
                    - topic
                    - responseTime
                required:
                - success
                - message
        '400':
          description: Invalid request or validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '405':
          description: HTTP method not supported by this endpoint
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            Allow:
              description: Supported HTTP methods.
              schema:
                type: string
        '409':
          description: Idempotency key conflicts with another body (IDEMPOTENCY_CONFLICT), or the original inquiry remains incomplete (IDEMPOTENCY_IN_PROGRESS). Keep the same key and body when checking an incomplete inquiry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            Retry-After:
              description: Seconds to wait before checking an in-progress inquiry with the same key and body. Present for IDEMPOTENCY_IN_PROGRESS.
              schema:
                type: integer
                minimum: 1
        '413':
          description: Request body too large (32KB limit)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded; observe Retry-After and rate-limit headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              description: Remaining requests and seconds to reset for the named policy (HTTP RateLimit draft).
              schema:
                type: string
            RateLimit-Policy:
              description: Named policy, request quota and window in seconds (HTTP RateLimit draft).
              schema:
                type: string
            X-RateLimit-Limit:
              description: Request quota for the policy.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Reset time as Unix epoch seconds.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
        '500':
          description: Consultation request could not be processed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        description: Use a random UUID for one intended inquiry and reuse the same key and JSON body when retrying. Completed results are replayed while their inbox entry is retained. A changed body returns 409 IDEMPOTENCY_CONFLICT. An unfinished request returns 409 IDEMPOTENCY_IN_PROGRESS with Retry-After; retry with the same key and body, and contact support if it remains incomplete. Never automatically switch keys to retry an incomplete inquiry. Requests without a key keep their existing behavior.
        schema:
          type: string
          minLength: 16
          maxLength: 128
          pattern: ^[A-Za-z0-9_-]{16,128}$
          description: Use a random UUID for one intended inquiry and reuse the same key and JSON body when retrying. Completed results are replayed while their inbox entry is retained. A changed body returns 409 IDEMPOTENCY_CONFLICT. An unfinished request returns 409 IDEMPOTENCY_IN_PROGRESS with Retry-After; retry with the same key and body, and contact support if it remains incomplete. Never automatically switch keys to retry an incomplete inquiry. Requests without a key keep their existing behavior.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 200
                email:
                  type: string
                  format: email
                  maxLength: 320
                  description: A real deliverable address; reserved example domains are rejected.
                phone:
                  type: string
                  maxLength: 30
                topic:
                  type: string
                  maxLength: 500
                website:
                  type: string
                  maxLength: 0
                  description: Honeypot; omit or leave empty.
              required:
              - name
              - email
      tags:
      - Consultation
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          const: false
        code:
          type: string
        message:
          type: string
        resolution:
          type: string
        error:
          type: string
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
            required:
            - field
            - message
        retryAfterMs:
          type: number
        availableIndustries:
          type: array
          items:
            type: string
        example:
          type: string
          format: uri
      required:
      - success
      - code
      - message
      - resolution
      - error