Close Job

Closes a job — it leaves the public marketplace and stops accepting proposals. Existing contracts on the job are unaffected (end those separately via POST /contracts/{id}/end). Idempotent: closing an already-closed job returns 200 with alreadyClosed: true.

Requirements: jobs:write scope + the public_api_job_publishing feature. The job must be yours.

Request

idstringpathrequired

The job ID.

No body.

Response

okboolean

true on success.

jobIdstring

The job ID.

statusstring

ARCHIVED.

alreadyClosedboolean

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

Errors

Status	code	Meaning
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Missing jobs:write scope or feature disabled
404	NOT_FOUND	No such job, or not yours

Request examples

curlCLIMCP: opentrain_close_job

curl

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

CLI

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

MCP: opentrain_close_job

{
  "jobId": "<JOB_ID>"
}

Response examples

200

{
  "ok": true,
  "jobId": "<JOB_ID>",
  "status": "ARCHIVED",
  "alreadyClosed": false
}