Skip to main content
POST
TypeScript

Autorisationer

Authorization
string
header
påkrævet

A user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

bounty:submission:create

Overskrifter

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Eksempel:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Eksempel:

"2026-11-17"

Sti-parametre

id
string
påkrævet

The claimed attempt to submit for review (btys_ tag).

Krop

application/json
deliverable
object | null

Work to attach to a livestream attempt. Combine urls, file_ids, and caption freely; all are optional. If the attempt already went to review when its stream ended, the deliverable attaches to it once, until reviewers start voting. Data capture attempts take no deliverable.

Svar

attempt submitted for review

bounty_id
string
påkrævet

The bounty the work was submitted to, prefixed bnty_.

Eksempel:

"bnty_xxxxxxxxxxxxxx"

capture_clips
object[] | null
påkrævet
Eksempel:

null

capture_filename
string | null
påkrævet

The vendor filename stem Country_City_Site_Station_Operator, derived from the capture metadata. null until every component is present.

Eksempel:

"US_Austin_BurnetRd_Bay2_mwebb"

captured_clip_count
integer
påkrævet

Number of verified capture clips accepted for this submission so far. 0 for submissions whose deliverable doesn't accumulate clips.

Eksempel:

0

captured_duration_seconds
integer
påkrævet

Total verified duration of accepted capture clips, in whole seconds. 0 for submissions whose deliverable doesn't accumulate clips.

Eksempel:

0

city
string | null
påkrævet

Capture metadata: city the footage was recorded in. null unless capture metadata was provided.

Eksempel:

"Austin"

claimed_at
string | null
påkrævet

When the worker claimed the submission, as an ISO 8601 timestamp.

Eksempel:

"2026-01-01T12:00:00.000Z"

content
string | null
påkrævet

Written proof the worker submitted with their work.

Eksempel:

"Ceramic coating reveal, shot at the Burnet Rd bay"

country
string | null
påkrævet

Capture metadata: country the footage was recorded in. null unless capture metadata was provided.

Eksempel:

"US"

created_at
string
påkrævet

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

Eksempel:

"2026-01-01T12:00:00.000Z"

deliverable_type
enum<string> | null
påkrævet

How the work arrived when it came in through the API in one shot, informational only — read the work from deliverable_urls, files, and capture_clips directly. null for submissions whose proof is a livestream recording, including ones that attached links or files on submit.

Tilgængelige muligheder:
content_url,
media,
data_capture,
null
Eksempel:

"media"

deliverable_urls
string[] | null
påkrævet

Links submitted as work, followed by temporary download URLs for the uploaded files. null when the submission carries neither.

denial_reason
string | null
påkrævet

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

Eksempel:

"The clip never shows the finished paint."

device
string | null
påkrævet

Capture metadata: device the footage was recorded on. null unless capture metadata was provided.

Eksempel:

"iPhone 15 Pro"

files
object[]
påkrævet
fov
integer | null
påkrævet

Capture metadata: horizontal field of view in degrees. null when not reported.

Eksempel:

120

id
string
påkrævet

Submission ID, prefixed btys_.

Eksempel:

"btys_xxxxxxxxxxxxxx"

latest_proof_livestream_feed
object | null
påkrævet

Latest public proof livestream attached to the submission.

operator
string | null
påkrævet

Capture metadata: identifier of the person who recorded the footage. null unless capture metadata was provided.

Eksempel:

"mwebb"

resolved_at
string | null
påkrævet

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

Eksempel:

"2026-01-01T12:00:00.000Z"

site
string | null
påkrævet

Capture metadata: site or venue the footage was recorded at. null unless capture metadata was provided.

Eksempel:

"BurnetRd"

station
string | null
påkrævet

Capture metadata: station or position within the site. null unless capture metadata was provided.

Eksempel:

"Bay2"

status
enum<string> | null
påkrævet

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. null when the attempt ended without proof, taking it out of the public lifecycle — those attempts are absent from every public list and read.

Tilgængelige muligheder:
in_progress,
submitted,
approved,
denied,
null
Eksempel:

"submitted"

submitted_at
string | null
påkrævet

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

Eksempel:

"2026-01-01T12:00:00.000Z"

updated_at
string
påkrævet

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

Eksempel:

"2026-01-01T12:00:00.000Z"

worker
object
påkrævet

User who submitted the work.