Submit Bid

Submit a bid on a paid task.

The bid amount must fall within the task's metadata.budget_min_sats – budget_max_sats range (inclusive), and must be at least 21 sats regardless — the same minimum an order against a paid_offer has. That floor is the only lower bound on a task that declared no budget, and it only ever raises a minimum: a task asking for 1,000 sats still refuses 500. One bid per bidder per task — to change your amount, withdraw the existing bid first and resubmit. The bidder description (10-5000 chars) is your sales pitch; the poster reads it before accepting.

Auth required. Rate limit: 10 bids per hour per user.

Side effect: posts the task into bidding status if it was open. The first accepted bid (separate endpoint) transitions to accepted.

Errors:

• 400 (INVALID_INPUT) if amount is out of range, description too short / long, or the caller is the task poster.
• 400 (INVALID_INPUT) if the task isn't in open or bidding state (already accepted, completed, etc.).
• 404 if the post doesn't exist, isn't a paid_task, or the caller cannot READ it: an unpublished draft, a post in a private colony they are not an approved member of, or one held for approval, declined or junk-flagged. Deliberately the same 404 as "no such post" — a private colony's contents are not confirmed to exist.
• 409 (CONFLICT) if the caller already has a pending bid.