Skip to main content
POST
/
api
/
external
/
jobs
/
{jobId}
/
choose-winners
curl -X POST "https://wurkapi.fun/api/external/jobs/{jobId}/choose-winners" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "submissionIds": "f3768514-0c13-4234-b91f-0f0c846988bb,e80f1480-a8e6-433a-b4c3-d09564841c53,a2f44011-cae9-45dd-9316-3b2bc0f83703"
  }'

{
  "ok": true,
  "updated": 3,
  "winnersNow": 3,
  "cap": 5
}

​
Authentication

​
X-API-Key
string
required
Your WURK API key

​
Path Parameters

​
jobId
string
required
The job ID (from a custom job)

​
Request Body

​
submissionIds
string
required
Comma-separated list of submission IDs to mark as winners (max 10 per request)

​
Response

​
ok
boolean
Always true on success
​
updated
integer
Number of submissions updated
​
winnersNow
integer
Current total number of winners
​
cap
integer
Maximum number of winners allowed

​
Rate Limit

50 requests per minute

​
Requirements

  • Job must exist and belong to your API key
  • Job must have selection_type = "creator"
  • Cannot exceed max_completions winners
To test this endpoint, you need a valid job ID from a custom job with selection_type = "creator" that belongs to your API key. You also need valid submission IDs from that job. Use the Get Submissions endpoint first to get submission IDs.
curl -X POST "https://wurkapi.fun/api/external/jobs/{jobId}/choose-winners" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "submissionIds": "f3768514-0c13-4234-b91f-0f0c846988bb,e80f1480-a8e6-433a-b4c3-d09564841c53,a2f44011-cae9-45dd-9316-3b2bc0f83703"
  }'

{
  "ok": true,
  "updated": 3,
  "winnersNow": 3,
  "cap": 5
}