Update Job

curl -sS -X PATCH https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID> \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "headcount": 8,
    "pricePerHour": 14
  }'

opentrain jobs update-published --job-id <JOB_ID> \
  --set headcount=8 \
  --set pricePerHour=14 --json

{
  "jobId": "<JOB_ID>",
  "patch": {
    "headcount": 8,
    "pricePerHour": 14
  }
}

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "OPEN",
  "moderation": {
    "decision": "ALLOW",
    "reasons": []
  }
}

{
  "error": "Job update applied but failed moderation; job unpublished",
  "code": "CONFLICT",
  "requestId": "<REQUEST_ID>",
  "details": {
    "jobId": "<JOB_ID>",
    "reason": "moderation_blocked",
    "reasons": ["contact_information_in_description"],
    "status": "DRAFT"
  }
}

PATCH

api

public

jobs

{id}

curl -sS -X PATCH https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID> \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "headcount": 8,
    "pricePerHour": 14
  }'

opentrain jobs update-published --job-id <JOB_ID> \
  --set headcount=8 \
  --set pricePerHour=14 --json

{
  "jobId": "<JOB_ID>",
  "patch": {
    "headcount": 8,
    "pricePerHour": 14
  }
}

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "OPEN",
  "moderation": {
    "decision": "ALLOW",
    "reasons": []
  }
}

{
  "error": "Job update applied but failed moderation; job unpublished",
  "code": "CONFLICT",
  "requestId": "<REQUEST_ID>",
  "details": {
    "jobId": "<JOB_ID>",
    "reason": "moderation_blocked",
    "reasons": ["contact_information_in_description"],
    "status": "DRAFT"
  }
}

Patches a published, open job — same field keys and types as PATCH /job-drafts/{jobId} (the authoritative key list is draft.updateKeys in capabilities). For unpublished drafts use the draft endpoint instead; this one requires the job to be OPEN. Every edit to a live job is re-moderated. If moderation rejects the edited content, the update is still applied but the job is unpublished back to DRAFT — fix the flagged content and publish again. Requirements: jobs:write scope + the public_api_job_publishing feature. The job must be yours and OPEN.

Request

string

required

The published job’s ID.

Body: a JSON object with one or more job fields — identical schema to the draft update endpoint. Unknown keys → 400 with zod issue details.

Response

boolean

true on success.

string

The job ID.

string

OPEN — the job stayed live.

object

{decision: "ALLOW", reasons: []} when the edit passed moderation.

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	Empty body, invalid JSON, unknown keys, or wrong types (`details` carries zod issues)
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `jobs:write` scope or feature disabled
`404`	`NOT_FOUND`	No such job, or not yours
`409`	`CONFLICT`	Job is not `OPEN` — `details: {jobId, status, requiredStatus: "OPEN"}`; for `DRAFT` jobs the message points you to `PATCH /job-drafts/{jobId}`
`409`	`CONFLICT`	Moderation rejected the edit — the update was applied but the job was unpublished to `DRAFT`; `details: {jobId, reason: "moderation_blocked", reasons: [...], status: "DRAFT"}`

curl -sS -X PATCH https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID> \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "headcount": 8,
    "pricePerHour": 14
  }'

opentrain jobs update-published --job-id <JOB_ID> \
  --set headcount=8 \
  --set pricePerHour=14 --json

{
  "jobId": "<JOB_ID>",
  "patch": {
    "headcount": 8,
    "pricePerHour": 14
  }
}

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "OPEN",
  "moderation": {
    "decision": "ALLOW",
    "reasons": []
  }
}

{
  "error": "Job update applied but failed moderation; job unpublished",
  "code": "CONFLICT",
  "requestId": "<REQUEST_ID>",
  "details": {
    "jobId": "<JOB_ID>",
    "reason": "moderation_blocked",
    "reasons": ["contact_information_in_description"],
    "status": "DRAFT"
  }
}

Get Job

Publish 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