{"uid":"cap_fXGQiAWFe4GUxfUv8Qlbw","slug":"agent-exec-listing-promotion-04b2d254","name":"agent-exec Listing Promotion","description":"Accountless, pay-per-use code execution for software agents: submit source code, get stdout, stderr and exit code back from an isolated, network-less sandbox. No account, no API key -- possession of valid payment is sufficient.","url":"https://agent-exec.448c.net/listings/promote?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["id","duration"],"properties":{"id":{"type":"string","description":"The listing to promote. You must pay from the wallet that owns it."},"duration":{"enum":["day","week","month"],"type":"string","description":"Which plan to buy -- see x-payment-info.pricing for the price of each."}}},"responseSchema":{"type":"object","required":["listing","promotion","payment"],"properties":{"listing":{"allOf":[{"type":"object","required":["url","name","description","tags","tier","lastSeenAlive","paidUntil","dead","lastProbeCode","operator","consecutiveFailures","deadSince","evictsAt","remedy","provenance","claimable","claim","id"],"properties":{"id":{"type":"string","description":"This row's id, present on every row. It is the one value `claim` (above) asks a curated row's real operator to POST back to `POST /listings/claim`, and it is also the only input `GET /listings/{id}/uptime` takes -- so a buying agent needs it too, to look up the uptime of a row it is deciding whether to call."},"url":{"type":"string"},"dead":{"type":"boolean","description":"3 consecutive failed probes with none since. Ranked last regardless of tier. Never deleted; one successful probe clears it."},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"tier":{"enum":["free","paid"],"type":"string","description":"This LISTING's placement tier in the directory -- \"paid\" means placement was bought via POST /listings/promote, ranking it above free listings. It says nothing about whether the advertised SERVICE itself is free to use: this deployment's own /execute, /storage and /listings/promote all charge over x402 and still read tier: \"free\" here, because placement was never promoted, not because they are free to call."},"claim":{"type":["string","null"],"description":"How to claim or remove this row, present only when `claimable` is true. Null otherwise."},"remedy":{"type":["string","null"],"description":"One-line, machine-readable fix for a dead row (re-POST the same id with a working url), or null while the row is not dead."},"evictsAt":{"type":["integer","null"],"description":"Unix ms this listing will be PERMANENTLY DELETED if nothing changes, or null while it is not dead. This is not owner-private data: an owner with no account and no contact field has no other channel to learn a deletion is coming. Re-POST the same listing id with a working url before this time to clear dead/consecutiveFailures and cancel it -- see `remedy`."},"operator":{"type":"boolean","description":"True when this listing is owned by this deployment's own receive wallet. Disclosed rather than hidden."},"claimable":{"type":"boolean","description":"True only when `provenance` is \"curated\" AND at least one claim credential is available: EITHER a claim address this service recorded at listing time (a signature from that wallet is the proof), OR -- for a curated row with no such address -- the well-known-file fallback (serve the expected challenge text at `/.well-known/agent-exec-listing-claim.txt` on this listing's own origin instead of signing anything). When true, the real operator may take this row over, or have it removed, via POST /listings/claim -- see `claim` for which of the two proofs this specific row needs."},"deadSince":{"type":["integer","null"],"description":"Unix ms this listing became continuously dead, or null while alive or never probed."},"paidUntil":{"type":["integer","null"],"description":"Unix ms the paid placement expires, or null while tier is free."},"provenance":{"enum":["owner","operator","curated"],"type":"string","description":"Who this row is FROM. \"owner\" -- signed by the party that actually runs the service, the default and the majority. \"operator\" -- this deployment's own products. \"curated\" -- listed BY US, ABOUT SOMEONE ELSE, who never asked to be listed and never claimed the row; see `claimable` and `claim`."},"description":{"type":"string"},"lastProbeCode":{"type":["string","null"],"description":"The outcome code of the last probe attempt, or null if never probed -- e.g. PROBE_OK, PROBE_TIMEOUT, PROBE_STATUS_DEAD. How an owner with no account and no support channel is told why their listing ranks last."},"lastSeenAlive":{"type":["integer","null"],"description":"Unix ms of the last successful liveness probe, or null before one has ever run."},"consecutiveFailures":{"type":"integer","description":"Probes since the last success. Reset to 0 by any success."},"ownerVerifiedAlternate":{"type":"object","required":["url","verifiedVia","signedByOwner"],"properties":{"url":{"type":"string","description":"A candidate replacement url, never substituted for `url` above."},"verifiedVia":{"type":"string"},"signedByOwner":{"type":"boolean"}},"description":"A dead row may also carry `ownerVerifiedAlternate: { url, verifiedVia, signedByOwner }` -- present only when a candidate replacement url's OWN x402 discovery document names the SAME owner as this row (proof by an address the candidate's operator actually controls, never a name or description match). This is surfaced ADDITIVELY and is NEVER substituted into `url` above -- see the \"Attribution\" section of /llms.txt for the byte-identical-url promise that field keeps regardless."}}},{"type":"object","required":["promote"],"properties":{"promote":{"type":"object","required":["url","method","plans"],"properties":{"url":{"type":"string","description":"Absolute URL of POST /listings/promote on this deployment."},"plans":{"type":"array","items":{"type":"object","required":["duration","name","days","priceUsd","price"],"properties":{"days":{"type":"number"},"name":{"type":"string","description":"Duplicates `duration` -- see `promotionCatalogue()`."},"price":{"type":"string","description":"The same amount as `priceUsd`, formatted as an x402 price string (e.g. \"$1.0000\")."},"duration":{"enum":["day","week","month"],"type":"string"},"priceUsd":{"type":"number"}}}},"method":{"enum":["POST"],"type":"string"}},"description":"Always present. Where and how to buy paid placement for THIS listing, and the live price table -- the same numbers the real POST /listings/promote 402 challenge charges, so this can never advertise a number the live charge disagrees with. See POST /listings/promote."}}}],"description":"This purchase's listing, in the SAME shape GET/POST/PUT /listings return it -- including the `promote` pointer, so a caller that just paid for placement also gets the live price table for renewing it before it lapses (see POST /listings/promote and `DirectoryStore.promote()`'s extend-not-replace semantics)."},"payment":{"type":"object","properties":{"asset":{"type":"string"},"payer":{"type":"string","description":"The paying wallet's address."},"amount":{"type":"string","description":"Atomic units of the settlement asset that were charged."},"network":{"type":"string"},"transaction":{"type":"string","description":"On-chain settlement transaction hash."}}},"promotion":{"type":"object","properties":{"duration":{"enum":["day","week","month"],"type":"string"},"priceUsd":{"type":"number"},"paidUntil":{"type":"integer","description":"Unix ms the paid placement now expires."},"durationMs":{"type":"integer"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0667","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0667/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0667","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0667","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0Lp5aoCCO4dwvs0ClhZi9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0667","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Promotes a listing in the agent-exec directory to a paid tier for a chosen duration (day, week, or month), paying via x402 USDC.","exampleAgentPrompt":"Promote my agent-exec listing with ID 'abc-123' to the paid tier for a week — pay whatever USDC is required.","exampleUseCases":[{"title":"Weekly boost for new API launch","prompt":"I just registered my code execution API on agent-exec — promote listing 'xyz-789' to paid placement for a week so it ranks above the free listings."},{"title":"Day promotion for a limited-time service","prompt":"Buy a one-day paid promotion for my agent-exec listing 'promo-456' so it gets top placement today."},{"title":"Monthly featured placement for production service","prompt":"Purchase a full month of promoted placement for listing 'prod-001' on agent-exec — I want it ranked in the paid tier all month long."}],"resultDescription":"Returns the updated listing object (including tier status, paidUntil, uptime ID, and other directory fields), the promotion record, and a payment confirmation — confirming the listing is now in the paid placement tier for the selected duration.","failureModes":["Listing ID not found or not owned by the paying wallet — returns error","Invalid duration value not in enum [day, week, month] — returns validation error","Payment insufficient or x402 payment failure — returns 402 with pricing info","Listing is dead/evicted and cannot be promoted — returns error","Malformed request body missing required fields"],"whenToPreferThis":"Use this endpoint when you own a listing in the agent-exec directory and want to elevate its placement above free listings for a defined period. This is the only way to buy paid-tier ranking in the agent-exec directory. Prefer daily duration for short-term visibility tests, weekly for regular promotion cycles, and monthly for stable production services.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:31:58.404Z","isFirstParty":false,"canonicalSlug":"agent-exec-listing-promotion-04b2d254"}