AI submit agent

Let an AI agent submit your AI product for you

The AIPO.ST submit agent lets an agent with your account token submit AI products: API manifest discovery, one product URL to submit, and the AI product page goes live after a quick review. Once your website is verified, agents can also prepare listing updates for you to confirm.

View the submit API Submit an AI product manually

How the submit agent works

Create a token

You create a submission token in My Products and store it in the agent’s credentials, never in a prompt.

Discover

The agent reads https://aipo.st/.well-known/agent-card.json and finds the submit AI product skill with the API endpoint.

Submit

The agent POSTs the product URL to /api/submit with the token — AIPO.ST auto-extracts the AI product name, tagline, icon and keywords.

Go live

After approval, the product has one public page and may use the website badge. Verify your website to maintain the listing with your agent.

Before your first submission

Create a submission token in your account and store it in your agent’s credentials. It submits new products; it cannot edit existing ones. To maintain an approved product, verify its website and create a product-scoped token. Your agent saves drafts and you confirm them. Read the maintenance guide.

Set up agent access

No SDK required

Copy a prompt and let your agent submit

This universal prompt works with mainstream agents that can access the web and use HTTP or shell tools. Keep your submission token in the agent's credential settings; the agent reads the live API docs, prepares the payload and submits after you confirm.

Claude CodeCodexGemini CLIGitHub CopilotCursorDevin / WindsurfReplit AgentAmazon Q DeveloperKiroClineRoo Code / RoomoteOpenHandsAiderOpenCodeGooseAmpWarpJetBrains JunieTraeManusOpenClawAny HTTP / shell agent

Product URL (optional before copying)

Submit my AI product to AIPO.ST.

Product URL: [PASTE YOUR PRODUCT URL HERE]

Perform the submission instead of only explaining the steps:
1. If the product URL is still a placeholder, ask me for the real, publicly accessible product URL. Do not guess it.
2. Read https://aipo.st/.well-known/agent-card.json and locate the submit-product skill.
3. Ensure I have created a new-product submission token at https://aipo.st/account/products and stored it in the agent credential settings or AIPOST_AGENT_TOKEN environment variable. Do not request, print or embed the secret in this prompt. GET https://aipo.st/api/submit to confirm the current JSON schema, invocation method and rate limits.
4. Prepare the minimal payload: {"url":"[PASTE YOUR PRODUCT URL HERE]","source":"agent"}. Add name, tagline and description only if the website cannot be autofilled. Never invent product details. Provide pricing only when confirmed; otherwise leave it Unknown.
5. Before publishing, show me the final JSON payload and remind me that submissions require review and repeats link to existing products. Wait for my confirmation.
6. After confirmation, use an available HTTP or shell tool to POST to https://aipo.st/api/submit?ref=agent-prompt with the Authorization: Bearer token from the credential store and an Idempotency-Key header containing a new UUID. The ref is a discovery label only. Reuse that same key and identical JSON for retries after network errors. Do not stop at sample code.
7. Return the submission ID, review status and existing flag. A null productPage means the product is not public yet; use badges only after approval.

For maintenance of an approved product, I will give you its product ID (shown in my product workspace at https://aipo.st/account/products) and a verified-product token. Read https://aipo.st/api/manage/docs, then GET /api/manage/products/{productId} and POST /api/manage/products/{productId}/revisions. Read the current version first, send only the fields that change, include a stable requestId for retries, and save a draft for my review; you cannot publish. Never create duplicate products for new features.

If the API returns 401, 403, 409, 422 or 429, preserve the error details and explain the cause and the next action I can take.

One call to submit an AI product

Any agent that can make an HTTP request — a coding agent, a tool-calling LLM, a CI script — can submit an AI product. The API is self-describing: GET /api/submit returns full usage docs.

Agent Card: /.well-known/agent-card.json
Submit endpoint: POST /api/submit
Review status: GET /api/manage/submissions/{id}
Metadata extraction: GET /api/site-meta?url=…

curl -X POST https://aipo.st/api/submit \
  -H "Idempotency-Key: <stable UUID>" \
  -H "Authorization: Bearer $AIPOST_AGENT_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"url": "https://your-product.com", "source": "agent"}'

{
  "id": "01JZ…",
  "productId": "01JZ…",
  "slug": "your-product",
  "status": "pending",
  "existing": false,
  "productPage": null,
  "embedBadge": null
}

curl https://aipo.st/api/manage/submissions/<submission id> \
  -H "Authorization: Bearer $AIPOST_AGENT_TOKEN"

Keep an approved product current with an agent

Verified owners can let an agent maintain their listing. The agent saves drafts; you review the before and after and confirm. Agents never publish.

Verify your official website in My Products with a verification file or a DNS TXT record.
Create a product token. Open the product workspace to copy its product ID, or copy the ready-made agent prompt there.
The agent reads the listing, then saves a profile or update draft with the current baseVersion and a stable requestId. It sends only the fields that change; the rest stay as they are.
You confirm the draft in the workspace. Stale drafts are rejected, and a retry with the same requestId never creates a duplicate.

Token scopes

products:submit — submission token: new products and review status only.
products:read — product token: read the listing, drafts and updates.
products:draft — save drafts for name, tagline, description, topics, pricing, features, audience and maker.
updates:draft — save product update drafts.

Tokens cannot publish, claim or transfer ownership, change the website URL or badges, delete products or create other tokens. Full reference: GET /api/manage/docs.

curl https://aipo.st/api/manage/products/<productId> \
  -H "Authorization: Bearer $AIPOST_PRODUCT_TOKEN"

curl -X POST https://aipo.st/api/manage/products/<productId>/revisions \
  -H "Authorization: Bearer $AIPOST_PRODUCT_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"kind":"profile","baseVersion":"<product.version>","requestId":"<stable uuid>","payload":{"tagline":"New one-line description"}}'

curl -X POST https://aipo.st/api/manage/products/<productId>/revisions \
  -H "Authorization: Bearer $AIPOST_PRODUCT_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"kind":"update","baseVersion":"<product.version>","requestId":"<stable uuid>","payload":{"title":"Batch export","version":"1.4","body":"What changed, in at least twenty characters."}}'

Why submit AI products with an agent

One URL is enough

With your submission token, an agent sends only the product URL; missing pricing stays Unknown until confirmed.

Quick review

A successful submit returns a submission ID and review status. An existing public product also returns its canonical page link.

Website badge

Every published AI product gets an embeddable “Listed on AIPO.ST” badge for its own website.

Fair rules

Agent submits follow the same rules as manual submits: one AI product per day, URL dedupe, rate limits. Tokens are revocable and never grant ownership.

FAQ

What is the AIPO.ST submit agent?+

The submit agent is how AI agents submit AI products to AIPO.ST: agents discover AIPO.ST through an agent-readable API manifest, call the JSON submit API with an account token, and the AI product page goes live after a quick review. After you verify your website, agents can also save listing drafts for you to confirm. Published updates can be corrected or withdrawn from your account.

What does an AI agent need to submit an AI product?+

An account-bound submission token that you create in My Products, plus the product URL. Use a stable Idempotency-Key for network retries. AIPO.ST extracts the name, tagline, description, icon and keywords from the product site automatically — or the agent can pass those fields explicitly.

Can an agent submit without a token?+

No. Anonymous agent submissions return 401. The token ties each submission to an account for limits and accountability, and it never makes that account the owner of a product.

How fast does a submitted AI product go live?+

A successful submit returns a submission ID and pending status. The page goes live after approval; repeat submissions link to the existing product. Each submitter can submit one AI product per day.

Can an agent update my product page?+

Yes, after you verify your official website. Create a product-scoped token, give your agent the product ID, and let it save profile or update drafts. Agents cannot publish: you review and confirm each draft in My Products, and confirmed edits to an approved listing go live without another review.

How do agents discover the submit API?+

AIPO.ST publishes an agent-readable API manifest at https://aipo.st/.well-known/agent-card.json describing product submission, verified-product maintenance and metadata extraction.

Does it cost anything to submit an AI product?+

No — submitting is free, and every published AI product gets an embeddable “Listed on AIPO.ST” badge for its website.

Submit your AI product now

Create an account token for your agent, or submit through the web form. New listings go live after approval.

Submit an AI product Agent Card