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
| Field | Notes | |
|---|---|---|
name | required | Product name, up to 80 characters. |
website | required | Product URL. The domain is the duplicate key. |
contact_email | required | Or email. Work email on the website's domain. Gets the code and the "your listing is live" email. Never shown publicly. |
category | optional | A category slug from the category list (e.g. video-generation). We assign one if missing. |
pricing_model | optional | free, freemium, paid or enterprise. |
tagline, description | optional | Plain text. |
features | optional | Array or comma/newline-separated text. |
starting_price, hq, founded_year, logo_url | optional | Empty 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
| Status | Meaning |
|---|---|
202 | Step 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. |
400 | Not 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). |
410 | Code expired, already used, or out of tries. Submit again. |
429 | Rate limited. |
503 | We 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/, methodPOST, content typeapplication/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}}"
}