Another Directory Submissions API

openapi: 3.2.0
info:
  version: '1'
  description: 'List a software tool on Another Directory without an account. An AI agent writes the listing and sends it with the maker''s email; nothing is generated on the server. Then it adds the badge to the tool''s site (free plan) or pays for Pro or Boost, and the listing goes live. Editing the text later needs an account with the same email. Step by step, as text: https://another.directory/submit.md'
  title: Another Directory agent Submissions API
servers:
- url: https://another.directory
tags:
- name: Submissions
paths:
  /api/submissions:
    post:
      description: 'Creates the listing. It is published only once a plan is picked, so send `plan`: "free" with `badge_url` checks the badge and publishes it when found; "pro" or "boost" returns a Stripe `checkout_url`, and it goes live when the payment lands. Without `plan` it stays an unpublished draft (finish it through `actions`). The text can''t be changed through the API afterwards.'
      summary: Send a listing
      operationId: createSubmission
      responses:
        '201':
          description: 'Created. Keep `status_url`: it''s the only way to follow the listing without an account.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Submission'
        '409':
          description: '`already_listed` (the domain is live already) or `recently_submitted` (sent without an account in the last 24 hours).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: '`invalid`: `errors` maps each field to its problems. Fix them and send the whole listing again.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '429':
          description: 'Too many requests: wait and retry.'
      tags:
      - Submissions
components:
  schemas:
    Submission:
      type: object
      properties:
        message:
          type: string
          description: Where the listing is, in a sentence or two.
        status:
          type: string
          enum:
          - draft
          - awaiting_badge
          - awaiting_payment
          - live
          - rejected
        plan:
          type: string
          enum:
          - free
          - pro
          - boost
        listing:
          type: object
          description: The listing as stored. Once it's in the maker's account, only `website` and `page_url`.
        actions:
          type: object
          description: '`verify_badge` and `checkout`, when available: method, url and body to send.'
        status_label:
          type: string
        badge:
          type:
          - object
          - 'null'
          properties:
            where:
              type: string
            html:
              type: string
        next_steps:
          type: array
          items:
            type: string
        status_url:
          type: string
          format: uri
        checkout_url:
          type: string
          format: uri
          description: 'On creation with plan pro or boost: the Stripe page to pay on.'
        plan_error:
          type: string
          enum:
          - badge_not_verified
          - checkout_unavailable
          description: On creation, when the plan sent couldn't be taken. The listing is saved; finish it through actions.
    ValidationError:
      type: object
      required:
      - error
      - message
      - errors
      properties:
        error:
          const: invalid
          type: string
        message:
          type: string
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    Error:
      type: object
      required:
      - error
      - message
      properties:
        error:
          type: string
        message:
          type: string
        submission:
          $ref: '#/components/schemas/Submission'