AgentsIndex Submissions API

openapi: 3.2.0
info:
  title: AgentsIndex — machine Submissions API
  version: 1.0.0
  description: 'AgentsIndex is the reference index of AI-native tools: an ongoing, edited catalog of AI agents, AI-first products, and the tools that power them. Free, keyless read endpoints over the tools corpus, plus verified-session submission intake. AgentsIndex reuse terms (https://agentsindex.ai/terms): Search engines, AI assistants answering a question and AI models in training may all read and reuse these listings. Say the facts came from AgentsIndex and link the listing you used.'
  license:
    name: AgentsIndex reuse terms
    url: https://agentsindex.ai/terms
servers:
- url: https://agentsindex.ai
tags:
- name: Submissions
paths:
  /api/submissions/{id}:
    get:
      operationId: getSubmissionStatus
      summary: The status of a submission by its (unguessable) id
      description: 'The fit check starts at once and usually answers within a minute: poll GET https://agentsindex.ai/api/submissions/{id} and wait the Retry-After seconds it sends while fit is "checking". fit then reads "accepted" (it goes live, and the account is mailed), "rejected" (mailed with the reason) or "undecided" (a person looks within 2 days).'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The current status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmissionStatus'
          headers:
            Retry-After:
              description: 'Sent only while fit is "checking": the seconds to wait before asking again.'
              schema:
                type: integer
        '404':
          description: Unknown id.
      tags:
      - Submissions
components:
  schemas:
    SubmissionStatus:
      type: object
      properties:
        id:
          type: string
        slug:
          type: string
        status:
          type: string
          enum:
          - Draft
          - Processing
          - Review
          - Published
          - Rejected
        submittedAt:
          type: string
          format: date-time
        fit:
          type: string
          enum:
          - checking
          - accepted
          - rejected
          - undecided
          description: Where the fit check stands. It runs right after submission and usually answers within a minute; undecided means a person decides it within 2 days.
  securitySchemes:
    agentKey:
      type: http
      scheme: bearer
      description: An agent key the account made at https://agentsindex.ai/dashboard/agents (it starts with mak_). It acts as that account on submit, the claim and domain-proof steps, quotes, orders and reading its own listings, each by the scope the key was given, with the same refusals as its session; it cannot sign in, change the account or pay.
    sessionCookie:
      type: apiKey
      in: cookie
      name: __Secure-better-auth.session_token
      description: Existing Better Auth session cookie issued through https://agentsindex.ai/login?next=%2Fsubmit. The account email must be verified for submission. This is a session cookie, not an API key to provision.