List your tool

AurionX directory API

Two calls add an AI tool to the directory, so an AI agent can list a company for the people who run it. It is the same pipeline as the submit form: we check the site, fill in details, and send the listing to review. Duplicates (same website domain) are never created twice. Machine-readable spec: /openapi.json.

1. Submit a tool

POST https://aurionx.ai/api/submit/ with a JSON body (content-type: application/json) or a form post. A body of the form {"fields": {…}} is also accepted.

{
  "name": "Vellm",
  "website": "https://vellm.app/",
  "contact_email": "founder@vellm.app",
  "category": "video-generation",
  "pricing_model": "paid",
  "tagline": "Turn people and pet photos into short AI videos",
  "description": "What the tool does, who it is for, how it is priced.",
  "features": "Photo-to-video templates, Text-to-video, Image generation"
}

The answer is 202 with {"status": "pending_email_verification", "verification_id": "…", "sent_to": "founder@vellm.app", "expires_in": 1800}. We email a 6-digit code to contact_email.

2. Confirm the email code

Ask the person who owns that mailbox for the code, then send it back within 30 minutes:

POST https://aurionx.ai/api/submit/verify/
{ "verification_id": "…", "code": "123456" }

The answer is 202 with {"ok": true, "status": "in_review" | "published" | "rejected", "slug": "…"}. The email also has a link, so the owner can confirm in a browser without the agent.

Rules that keep the directory honest: contact_email must be a work email on the tool's own domain (a tool at vellm.app needs …@vellm.app, never Gmail or Outlook). Each code works once, for 30 minutes, with 5 tries. At most 3 codes an hour go to one address. Nothing is listed until the code is confirmed.

Fields

FieldNotes
namerequiredProduct name, up to 80 characters.
websiterequiredProduct URL. The domain is the duplicate key.
contact_emailrequiredOr email. Work email on the website's domain. Gets the code and the "your listing is live" email. Never shown publicly.
categoryoptionalA category slug from the category list (e.g. video-generation). We assign one if missing.
pricing_modeloptionalfree, freemium, paid or enterprise.
tagline, descriptionoptionalPlain text.
featuresoptionalArray or comma/newline-separated text.
starting_price, hq, founded_year, logo_urloptionalEmpty strings are ignored.

Authentication and limits

Public submissions need no key, are limited to 10 an hour per visitor, and always go through the email code above. Server-to-server senders we have vetted (a CRM or lead router delivering signups it already verified) send the header x-intake-token with the token we issue, which skips the email code and the limit. Ask thomas@aurionx.ai for a token.

Responses

StatusMeaning
202Step 1: code sent (pending_email_verification). Step 2, or a token sender: {"ok": true, "status": "in_review" | "published" | "rejected", "slug": "…", "reason": "…"}. A duplicate also returns 202 and changes nothing.
400Not JSON / form data; name, website or contact_email missing; email not on the tool's domain; or a wrong code (tries_left says how many are left).
410Code expired, already used, or out of tries. Submit again.
429Rate limited.
503We could not send the email. Try again later.

KontrolX buyer delivery

To route KontrolX intakes to the directory, add a Buyer with delivery mode webhook, then use it in the workflow's routing step:

  • URL: https://aurionx.ai/api/submit/, method POST, content type application/json, format raw.
  • Header: x-intake-token: <your token>.
  • Body template (field names as captured on the submit form):
{
  "name": "{{name}}",
  "website": "{{website}}",
  "contact_email": "{{contact_email}}",
  "category": "{{category}}",
  "pricing_model": "{{pricing_model}}",
  "tagline": "{{tagline}}",
  "description": "{{description}}",
  "starting_price": "{{starting_price}}",
  "features": "{{features}}",
  "hq": "{{hq}}",
  "founded_year": "{{founded_year}}",
  "logo_url": "{{logo_url}}"
}