Publish Job

curl -sS -X POST https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/publish \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain jobs publish --job-id <JOB_ID> --json

{
  "jobId": "<JOB_ID>"
}

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "OPEN",
  "alreadyPublished": false,
  "jobUrl": "https://app.opentrain.ai/jobs/<JOB_ID>",
  "publishAttemptId": "<ATTEMPT_ID>",
  "warnings": [],
  "sideEffects": {
    "dispatched": true,
    "status": "queued"
  }
}

{
  "error": "Daily publish limit reached",
  "code": "RATE_LIMITED",
  "requestId": "<REQUEST_ID>",
  "details": {
    "limit": 3,
    "windowHours": 24
  }
}

POST

api

public

jobs

{id}

publish

curl -sS -X POST https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/publish \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain jobs publish --job-id <JOB_ID> --json

{
  "jobId": "<JOB_ID>"
}

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "OPEN",
  "alreadyPublished": false,
  "jobUrl": "https://app.opentrain.ai/jobs/<JOB_ID>",
  "publishAttemptId": "<ATTEMPT_ID>",
  "warnings": [],
  "sideEffects": {
    "dispatched": true,
    "status": "queued"
  }
}

{
  "error": "Daily publish limit reached",
  "code": "RATE_LIMITED",
  "requestId": "<REQUEST_ID>",
  "details": {
    "limit": 3,
    "windowHours": 24
  }
}

Takes a publishReady draft live on the marketplace. The final step of the posting loop: create → gap-fill → publish. Idempotent — publishing an already-open job returns 200 with alreadyPublished: true. Every publish passes content moderation, and accounts have a daily publish limit (20/day claimed, 3/day unclaimed). A draft that is not publish-ready is rejected with the same validation detail the draft endpoints return — go back and patch the missing fields. Requirements: jobs:write scope + the public_api_job_publishing feature (check capabilities → capabilities.publish). Works pre-claim within the lower daily limit.

Request

string

required

The draft job ID.

No body.

Response

boolean

true on success.

string

The job ID.

string

OPEN — the job is live.

boolean

true when the job was already open (no-op).

string

Public listing URL.

string | null

Internal attempt identifier for support/audit, when available.

string[]

Non-blocking warnings (e.g. fields worth improving).

object

{dispatched, status} — whether post-publish side effects (distribution, notifications) were kicked off.

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	Draft is not publish-ready — `details.validation` carries the same `missingFields`/`issues` shape as the draft endpoints
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing scope, feature disabled, or moderation block (`details.reason: "moderation_blocked"` with `details.reasons[]`)
`404`	`NOT_FOUND`	No such job, or not yours
`429`	`RATE_LIMITED`	Daily publish limit reached — `details` carries `{limit, windowHours: 24}`

curl -sS -X POST https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/publish \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain jobs publish --job-id <JOB_ID> --json

{
  "jobId": "<JOB_ID>"
}

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "OPEN",
  "alreadyPublished": false,
  "jobUrl": "https://app.opentrain.ai/jobs/<JOB_ID>",
  "publishAttemptId": "<ATTEMPT_ID>",
  "warnings": [],
  "sideEffects": {
    "dispatched": true,
    "status": "queued"
  }
}

{
  "error": "Daily publish limit reached",
  "code": "RATE_LIMITED",
  "requestId": "<REQUEST_ID>",
  "details": {
    "limit": 3,
    "windowHours": 24
  }
}

Update Job

Close Job

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors