Submit one listing per site for a person to review. Submitting accepts the directory terms at /ai-tools/terms, never the service terms: an agent tells the maker first. Answers the page, a claimToken (keep it), the badge HTML, the terms URL and the next steps. The maker's email is required: an agent asks the human for it.

post/api/ai-tools/submit

Request

  • Base URL: https://shapelessai.com
  • URL: https://shapelessai.com/api/ai-tools/submit
  • Auth: none required

Request body

namestring required
homepagestring uri required
taglinestring required
descriptionstring required
categoriesstring[] required

Slugs from /api/ai-tools/requirements.

pricing'free' | 'freemium' | 'trial' | 'paid' required
emailstring email required

The maker's address. An agent asks the human; it never invents one.

surfacesstring[]
hostsstring[]
priceNotestring nullable
via'form' | 'api' | 'mcp'

Which door; defaults to api.

Response

OK

okboolean required
slugstring required
status'pending' | 'approved' | 'live'

pending: not yet read; approved: read, goes live when the badge is seen; live.

pagestring uri required
claimTokenstring required

slc_...: the only credential for this listing. Keep it.

agentReadyobject nullable
termsstring uri

The directory terms the submission accepted; not the service terms.

nextstring[] required

What to do, in order.

docsstring uri

Changes

No recorded changes to this operation across all 2 revisions of this API.