{"uid":"cap_RETTXRWe9bT0TWUw6eqwS","slug":"agent-exec-45-67-221-128-sslip-io-promote-listing-501da5b5","name":"agent-exec.45.67.221.128.sslip.io Promote Listing","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.45.67.221.128.sslip.io/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_vK1s9rwntorinZ9tTYiW9","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":"Purchase paid placement (day plan) for an existing listing in the agent-exec x402 services directory, boosting it above free listings for the duration of payment","exampleAgentPrompt":"Promote my agent-exec directory listing (id: abc123) to a paid day plan so it outranks free listings — buy the $0.0667 day promotion now.","exampleUseCases":[{"title":"Day-plan boost for new API listing","prompt":"I just created my x402 service listing on agent-exec and want it to show up above the free ones today — buy the day plan promotion for listing id xyz789, it should cost about $0.0667."},{"title":"Recovering lapsed weekly promotion","prompt":"My promoted listing on agent-exec lapsed overnight and dropped back below the free entries — re-promote listing id abc456 with the day plan so it's back at the top while I decide on a longer plan."},{"title":"Testing visibility before committing to longer plan","prompt":"Before I buy the week or month plan on agent-exec, I want to try a single day promotion on listing id qrs321 to see if the extra visibility is worth it — go ahead and pay for the day plan."}],"resultDescription":"A confirmation that the listing has been promoted, including the listing id, the plan purchased (day), the promotion start and expiration time, and the new ranked position within the agent-exec directory. Promotion automatically lapses when the paid period ends.","failureModes":["Listing id not found — listing must be created first via POST /listings before promotion","Payment failure or insufficient USDC balance — promotion is not applied","Invalid or expired x402 payment header — endpoint rejects the request","Plan pricing mismatch — live price from .well-known/x402.json differs from cached value, causing payment rejection","Duplicate promotion attempt on already-promoted listing — may return conflict or extend expiry depending on implementation"],"whenToPreferThis":"Use this endpoint when you have already created a free listing in the agent-exec x402 directory and want to purchase paid placement to outrank free listings. Prefer this over manually managing visibility or using a different directory when your service targets x402-native agent consumers and you want instant, accountless promotion paid in USDC. Check the live price table at .well-known/x402.json before paying to avoid stale-price rejections.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T00:31:51.173Z","isFirstParty":false,"canonicalSlug":"agent-exec-45-67-221-128-sslip-io-promote-listing-501da5b5"}