API docs

A public API is on the way

We’re building programmatic access to campaigns, submissions and reviews for providers who want to publish tasks and pull results from their own systems. It isn’t available yet — here’s what’s planned.

Preview

Endpoints below are illustrative of the planned shape — not yet live.

POST/v1/campaigns

Publish a campaign programmatically, including form_config for the category.

GET/v1/campaigns/:id/submissions

List submissions for a campaign, filterable by status.

POST/v1/submissions/:id/review

Approve, reject, or request a revision on a submission.

POST/v1/webhooks

Register a webhook for submission.created, submission.approved, and dispute.opened events.

Example — publishing a campaign (preview shape)

curl -X POST https://api.tasklabel.io/v1/campaigns \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d ’{
    "category": "ai_labeling",
    "title": "Classify support chat intent",
    "reward_cents": 90,
    "total_slots": 300,
    "form_config": { "items": [...], "labels": [...] }
  }’

Want early access?

Tell us what you’d want to automate first, and we’ll reach out when the API opens up.

api@tasklabel.io