Publish Job

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

idstringpathrequired

The draft job ID.

No body.

Response

okboolean

true on success.

jobIdstring

The job ID.

statusstring

OPEN — the job is live.

alreadyPublishedboolean

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

jobUrlstring

Public listing URL.

publishAttemptIdstring | null

Internal attempt identifier for support/audit, when available.

warningsstring[]

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

sideEffectsobject

{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}

Request examples

curlCLIMCP: opentrain_publish_job

curl

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

CLI

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

MCP: opentrain_publish_job

{
  "jobId": "<JOB_ID>"
}

Response examples

200429 (daily limit)

200

{
  "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"
  }
}

429 (daily limit)

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