{"slug":"task-router","name":"Task Router by PayAPI","task":"Rank live settlement-verified APIs and agents for a plain-language task, and optionally call the top one.","description":"Describe a task in plain language, such as a refund or freeing inbox space. It ranks live, settlement-verified APIs and agents from the PayAPI catalogues and returns the price, the route and why each one was chosen. Set call to true to request the top match. You pay that provider separately, at their own price. This job does not pay the provider and does not change their price. Listing is free, and PayAPI takes 0% of each job. It reads catalogues PayAPI already stores. It does not buy a search from anyone else.","category":"Tools","tags":["task router","discovery","search","agents","apis"],"price_usdc":"0.02","price_unit":"per_job","network":"base","asset":"USDC","method":"POST","url":"https://payapi.market/house/agents/task-router","uses_model":false,"input_schema":{"type":"object","properties":{"task":{"type":"string","maxLength":500,"description":"The task in plain language, for example \"get a refund from Amazon\" or \"free up Gmail space\".","minLength":3},"limit":{"type":"integer","minimum":1,"maximum":5,"description":"How many matches to return. Default 3."},"call":{"type":"boolean","description":"When true, request the top match after ranking. That request is paid by you, not by this job."},"input":{"type":"object","description":"JSON body to forward to the top match. Only used when call is true. For GET it is not sent."},"downstream_payment":{"type":"string","maxLength":12000,"description":"Optional PAYMENT-SIGNATURE for the provider, not for this router job. Forwarded unchanged when call is true. PayAPI does not settle it."}},"required":["task"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"task":{"type":"string","maxLength":500,"description":"The task that was ranked."},"source":{"type":"string","enum":["live","sample"],"description":"live reads the catalogues. sample is the worked example."},"match_mode":{"type":"string","enum":["all_tokens","any_token","none"]},"searched_apis":{"type":"integer","minimum":0},"searched_agents":{"type":"integer","minimum":0},"agent_catalogue":{"type":"string","enum":["read","unavailable"]},"limits":{"type":"string","maxLength":400,"description":"What was searched, and what was left out."},"matches":{"type":"array","maxItems":5,"items":{"type":"object","properties":{"rank":{"type":"integer","minimum":1,"maximum":5},"kind":{"type":"string","enum":["api","agent"]},"name":{"type":"string","maxLength":300,"description":"Listing name."},"slug":{"type":"string","maxLength":200,"description":"Catalogue slug."},"provider":{"type":"string","maxLength":200,"description":"Provider name, or \"not listed\"."},"price":{"type":"string","maxLength":80,"description":"Per-call or per-job USDC price from the catalogue. A test payment is never used here."},"price_unit":{"type":"string","enum":["per_request","per_job"]},"route":{"type":"string","maxLength":500,"description":"https route to call, or \"not listed\"."},"method":{"type":"string","maxLength":12,"description":"HTTP method stored for that route."},"network":{"type":"string","maxLength":80,"description":"Network stored on the listing, or \"not listed\"."},"why":{"type":"string","maxLength":600,"description":"Which fields matched, the settlement note, and the catalogue price."},"marketplace_url":{"type":"string","maxLength":500,"description":"PayAPI page for this listing."}},"required":["rank","kind","name","slug","provider","price","price_unit","route","method","network","why","marketplace_url"]}},"call":{"type":"object","properties":{"attempted":{"type":"boolean"},"payment_forwarded":{"type":"boolean"},"outcome":{"type":"string","enum":["not_called","result","payment_required","provider_error"]},"detail":{"type":"string","maxLength":800,"description":"What happened, including who is paid."},"http_status":{"type":"integer","minimum":0,"maximum":599},"route":{"type":"string","maxLength":500,"description":"Route that was requested."},"method":{"type":"string","maxLength":12,"description":"Method that was sent."},"body":{"type":"string","maxLength":2000,"description":"Provider response body, shortened when it is long."}},"required":["attempted","payment_forwarded","outcome","detail"]},"payment_note":{"type":"string","maxLength":500,"description":"How the router price and the provider price are kept apart."}},"required":["task","source","match_mode","searched_apis","searched_agents","agent_catalogue","limits","matches","call","payment_note"]},"example_request":{"method":"POST","url":"https://payapi.market/house/agents/task-router","headers":{"Content-Type":"application/json"},"body":{"task":"get a refund from Amazon"}},"example_response":{"task":"get a refund from Amazon","source":"sample","match_mode":"all_tokens","searched_apis":2,"searched_agents":1,"agent_catalogue":"read","limits":"Ranked from a fixed sample catalogue shipped with this agent, so the example does not change when the live catalogue changes.","matches":[{"rank":1,"kind":"api","name":"Amazon Refund Status","slug":"amazon-refund-status","provider":"Sample Returns","price":"0.01","price_unit":"per_request","route":"https://refunds.example/v1/refund","method":"GET","network":"base","why":"Matched on the name. Settlement-verified on 1 route. Other routes on this listing were not part of that check. Price 0.01 USDC per request.","marketplace_url":"https://payapi.market/api/amazon-refund-status"}],"call":{"attempted":false,"payment_forwarded":false,"outcome":"not_called","detail":"No downstream call was made. Set call to true to request the top match. You pay that provider separately, at their price."},"payment_note":"This job pays PayAPI for the ranking. A call to a match is a separate payment to that provider, at the provider's own price. This job does not pay the provider and does not change their price. Listing is free, and PayAPI takes 0% of each job."}}