Skip to main content
POST
Create Bounty Submission

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-07-08-1"

Body

application/json
bounty_id
string
required

The bounty to submit to (bnty_ tag).

affiliate_code
string | null

Affiliate code crediting the referrer, when the worker arrived through one.

deliverable
object | null

The submitted work, matching one of the bounty's accepted deliverable types.

Response

submission created with an inline deliverable

bounty_id
string
required

The bounty the work was submitted to, prefixed bnty_.

content
string | null
required

Written proof the worker submitted with their work.

created_at
string
required

When the submission was created, as an ISO 8601 timestamp.

deliverable_type
enum<string> | null
required

Deliverable shape the worker submitted. content_url is links to posted content; media is uploaded files. null on submissions authored before deliverable types existed.

Available options:
content_url,
media,
null
Example:

"content_url"

deliverable_urls
string[] | null
required

The submitted content links. Only set when deliverable_type is content_url.

denial_reason
string | null
required

Why the submission was denied, when a presentable reason exists. Always null unless status is denied.

id
string
required

Submission ID, prefixed btys_.

resolved_at
string | null
required

When the submission was approved or denied, as an ISO 8601 timestamp. null until then.

status
enum<string>
required

Lifecycle state. in_progress submissions are active attempts that have not submitted proof yet; submitted submissions await review; approved submissions were accepted and paid; denied submissions were rejected.

Available options:
in_progress,
submitted,
approved,
denied
Example:

"in_progress"

submitted_at
string | null
required

When proof was submitted for review, as an ISO 8601 timestamp. null while the attempt is in progress.

updated_at
string
required

When the submission was last updated, as an ISO 8601 timestamp.

worker
object
required

User who submitted the work.