studiomeyer-io Generate Agents Json API

openapi: 3.2.0
info:
  title: StudioMeyer Public Generate Agents Json 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: Generate Agents Json
paths:
  /api/v1/generate-agents-json:
    post:
      summary: Generate agents.json and agent-card.json for any business.
      operationId: post_generate_agents_json
      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:
                  agency:
                    type: string
                  generatedFor:
                    type: string
                  businessType:
                    type: string
                  files:
                    type: object
                    properties:
                      agents.json:
                        type: object
                        properties:
                          schema_version:
                            type: string
                          name:
                            type: string
                          description:
                            type: string
                          url:
                            type: string
                            format: uri
                          contact:
                            type: object
                            properties:
                              email:
                                type: string
                            required:
                            - email
                          tools:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                description:
                                  type: string
                                endpoint:
                                  type: string
                                method:
                                  type: string
                                parameters:
                                  type: object
                                  additionalProperties:
                                    type: object
                                    properties:
                                      type:
                                        type: string
                                      description:
                                        type: string
                                      required:
                                        type: boolean
                                      enum:
                                        type: array
                                        items:
                                          type: string
                                    required:
                                    - type
                                    - description
                              required:
                              - name
                              - description
                              - endpoint
                              - method
                              - parameters
                          capabilities:
                            type: object
                            properties:
                              webmcp:
                                type: boolean
                              a2a:
                                type: boolean
                              languages:
                                type: array
                                items:
                                  type: string
                            required:
                            - webmcp
                            - a2a
                            - languages
                        required:
                        - schema_version
                        - name
                        - description
                        - url
                        - contact
                        - tools
                        - capabilities
                      agent-card.json:
                        type: object
                        properties:
                          name:
                            type: string
                          description:
                            type: string
                          supportedInterfaces:
                            type: array
                            items:
                              type: object
                              properties:
                                url:
                                  type: string
                                  format: uri
                                protocolBinding:
                                  type: string
                                protocolVersion:
                                  type: string
                              required:
                              - url
                              - protocolBinding
                              - protocolVersion
                          provider:
                            type: object
                            properties:
                              organization:
                                type: string
                              url:
                                type: string
                                format: uri
                            required:
                            - organization
                            - url
                          version:
                            type: string
                          capabilities:
                            type: object
                            properties:
                              streaming:
                                type: boolean
                              pushNotifications:
                                type: boolean
                            required:
                            - streaming
                            - pushNotifications
                          defaultInputModes:
                            type: array
                            items:
                              type: string
                          defaultOutputModes:
                            type: array
                            items:
                              type: string
                          skills:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                name:
                                  type: string
                                description:
                                  type: string
                                tags:
                                  type: array
                                  items:
                                    type: string
                                inputModes:
                                  type: array
                                  items:
                                    type: string
                                outputModes:
                                  type: array
                                  items:
                                    type: string
                              required:
                              - id
                              - name
                              - description
                              - tags
                              - inputModes
                              - outputModes
                        required:
                        - name
                        - description
                        - supportedInterfaces
                        - provider
                        - version
                        - capabilities
                        - defaultInputModes
                        - defaultOutputModes
                        - skills
                    required:
                    - agents.json
                    - agent-card.json
                  implementation:
                    type: object
                    properties:
                      note:
                        type: string
                      agentCard:
                        type: string
                      nextjs:
                        type: string
                      wordpress:
                        type: string
                      static:
                        type: string
                    required:
                    - note
                    - agentCard
                    - nextjs
                    - wordpress
                    - static
                  upgrade:
                    type: object
                    properties:
                      message:
                        type: string
                      pricing:
                        type: string
                      includes:
                        type: array
                        items:
                          type: string
                      contact:
                        type: string
                    required:
                    - message
                    - pricing
                    - includes
                    - contact
                required:
                - agency
                - generatedFor
                - businessType
                - files
                - implementation
                - upgrade
        '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
        '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: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                businessName:
                  type: string
                  minLength: 1
                  maxLength: 200
                  description: Public name of the business.
                businessType:
                  type: string
                  description: Business category used to choose the generated tool template.
                  enum:
                  - restaurant
                  - immobilien
                  - handwerk
                  - corporate
                  - ecommerce
                url:
                  type: string
                  format: uri
                  maxLength: 500
                  description: Canonical HTTPS website URL to place in the generated files.
                description:
                  type: string
                  maxLength: 1000
                  description: Short factual description of the business and its offer.
                language:
                  type: string
                  maxLength: 5
                  description: Language code for generated labels; defaults to de.
                  default: de
              required:
              - businessName
              - businessType
      tags:
      - Generate Agents Json
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