v8
OpenAPI 3.1.02026-08-033623795.0 MBCreate Bounty
Creates a bounty and escrows its reward pool. Publishes immediately, or as a scheduled draft when you set publish_at.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
Request body
Number of submissions that can be accepted (winner slots). Defaults to 1. The escrowed total is gross_reward_amount times this limit and must be at least $5.
Account whose balance funds the bounty pool (biz_ tag). Defaults to the caller's personal balance. Requires permission to move the account's funds.
Countries whose residents can work the bounty, as ISO 3166 alpha-2 codes. Empty means worldwide.
What the poster wants the work to achieve, declared once here.
Full task instructions shown to workers.
Experience to host the bounty in (exp_ tag). Any visibility — public for an open bounty, private for an invited one. Required unless account_id is set, in which case the bounty anchors in that account's public forum.
How often the schedule creates a new bounty. Each occurrence is a separate bounty. Defaults to once; only applies with publish_at.
Gross bounty-pool amount (USD) escrowed per accepted submission, in whole dollars. Platform fees and affiliate shares are paid from this amount.
ISO 8601 time to publish the bounty. When set, the bounty is created as a hidden draft and funded + published at this time instead of immediately.
IANA timezone for recurring occurrences. Required when publish_at is set.
Short name of the task shown to workers.
Example request
{
"business_goal_type": "clipping",
"frequency": "weekly"
}Response
bounty created
Submissions accepted so far.
Number of submissions that can be accepted (winner slots).
Total gross budget committed to the bounty: gross_reward_amount times accepted_submissions_limit.
What the poster wants the work to achieve, declared once at create. null for bounties created before the taxonomy rolled out.
When cancellation was requested, as an ISO 8601 timestamp. On a closed bounty this means the cancel is pending: submissions are stopped and the bounty cancels once in-flight submissions resolve. On a canceled bounty it records when the cancellation was requested. null when no cancellation was ever requested.
When the bounty was created, as an ISO 8601 timestamp.
Currency for all amounts on the bounty, as a lowercase ISO 4217 code.
Full task instructions shown to workers.
Experience the bounty is hosted in, prefixed exp_. null for platform-wide bounties; may belong to a different account than the funder.
Gross amount paid out from the bounty pool across accepted submissions — worker payouts, platform fees, and affiliate shares together. Tips and reviewer rewards are excluded.
Gross bounty-pool amount allocated per accepted submission, in whole currency units.
Bounty ID, prefixed bnty_.
How often the schedule creates a new bounty. Each occurrence is a separate bounty; the original is not republished.
When a scheduled bounty will publish, as an ISO 8601 timestamp. null once published, for bounties that were never scheduled, and for terminally failed drafts parked for manual rescheduling.
Unfilled winner capacity: accepted_submissions_limit minus accepted_submissions_count, clamped to zero. Not a signal that the bounty currently accepts new claims.
Lifecycle state. scheduled bounties are unpublished drafts, visible to their poster and the account's authorized managers; open bounties accept new submissions; closed bounties are live but no longer accept new submissions; completed bounties paid out every winner slot; canceled bounties ended before filling their slots.
When new submissions stopped being accepted, as an ISO 8601 timestamp. Set when a cancellation is requested on a bounty with work in flight, so in-flight submissions can resolve before the bounty cancels. null when submissions were never stopped — including completed bounties that simply filled every winner slot.
Short name of the task shown to workers.
Submissions still awaiting an outcome: in progress or pending review.
When the bounty was last updated, as an ISO 8601 timestamp.
Example response
{
"accepted_deliverable_types": [
"content_url"
],
"business_goal_type": "clipping",
"capture_spec": {
"video": {
"stabilization_mode": "off"
}
},
"currency": "usd",
"scheduled_frequency": "once",
"status": "scheduled"
}