Get Drafting Capabilities

curl -sS https://app.opentrain.ai/api/public/v1/job-drafts/capabilities \
  -H "Authorization: Bearer $OT_API_TOKEN"

{}

{
  "featureKey": "public_api_job_drafting",
  "namespace": "job-drafts",
  "rolloutMode": "ALL",
  "actorIsAdmin": false,
  "capabilities": {
    "draftImport": true,
    "draftCreate": true,
    "draftUpdate": true,
    "draftUrlRead": true,
    "publish": true,
    "hiring": true,
    "messagingWrites": true,
    "team": true,
    "paymentsWrite": true,
    "credits": true,
    "webhooks": true
  },
  "draft": {
    "importFormats": [
      "text",
      "opentrain_canonical",
      "schema_org_job_posting",
      "indeed_xml",
      "hr_xml"
    ],
    "updateKeys": [
      "jobTitle",
      "jobDescription",
      "labelingOverview",
      "datasetDescription",
      "dataType",
      "subjectMatter",
      "dataVolume",
      "dataVolumeUnit",
      "labelingSoftware",
      "headcount",
      "experienceLevel",
      "paymentType",
      "pricePerHour",
      "pricePerLabel",
      "fixedPrice",
      "countries",
      "languages",
      "labelTypes",
      "..."
    ],
    "enums": {
      "paymentType": ["PAY_PER_LABEL", "PAY_PER_HOUR", "FIXED_PRICE"],
      "experienceLevel": ["EXPERT", "ENTRY_LEVEL", "INTERMEDIATE", "ANY_EXPERIENCE_LEVEL"],
      "dataVolumeUnit": [
        "HOURS_OF_RECORDING_AUDIO_VIDEO",
        "NUMBER_OF_FILES",
        "NUMBER_OF_WORDS",
        "UNKNOWN_NOT_SPECIFIED"
      ]
    }
  },
  "authBootstrap": "token",
  "enabled": true
}

{
  "error": "Public API feature not enabled for actor",
  "code": "FORBIDDEN",
  "requestId": "<REQUEST_ID>",
  "details": {
    "featureKey": "public_api_job_drafting",
    "mode": "OFF"
  }
}

GET

api

public

job-drafts

capabilities

curl -sS https://app.opentrain.ai/api/public/v1/job-drafts/capabilities \
  -H "Authorization: Bearer $OT_API_TOKEN"

{}

{
  "featureKey": "public_api_job_drafting",
  "namespace": "job-drafts",
  "rolloutMode": "ALL",
  "actorIsAdmin": false,
  "capabilities": {
    "draftImport": true,
    "draftCreate": true,
    "draftUpdate": true,
    "draftUrlRead": true,
    "publish": true,
    "hiring": true,
    "messagingWrites": true,
    "team": true,
    "paymentsWrite": true,
    "credits": true,
    "webhooks": true
  },
  "draft": {
    "importFormats": [
      "text",
      "opentrain_canonical",
      "schema_org_job_posting",
      "indeed_xml",
      "hr_xml"
    ],
    "updateKeys": [
      "jobTitle",
      "jobDescription",
      "labelingOverview",
      "datasetDescription",
      "dataType",
      "subjectMatter",
      "dataVolume",
      "dataVolumeUnit",
      "labelingSoftware",
      "headcount",
      "experienceLevel",
      "paymentType",
      "pricePerHour",
      "pricePerLabel",
      "fixedPrice",
      "countries",
      "languages",
      "labelTypes",
      "..."
    ],
    "enums": {
      "paymentType": ["PAY_PER_LABEL", "PAY_PER_HOUR", "FIXED_PRICE"],
      "experienceLevel": ["EXPERT", "ENTRY_LEVEL", "INTERMEDIATE", "ANY_EXPERIENCE_LEVEL"],
      "dataVolumeUnit": [
        "HOURS_OF_RECORDING_AUDIO_VIDEO",
        "NUMBER_OF_FILES",
        "NUMBER_OF_WORDS",
        "UNKNOWN_NOT_SPECIFIED"
      ]
    }
  },
  "authBootstrap": "token",
  "enabled": true
}

{
  "error": "Public API feature not enabled for actor",
  "code": "FORBIDDEN",
  "requestId": "<REQUEST_ID>",
  "details": {
    "featureKey": "public_api_job_drafting",
    "mode": "OFF"
  }
}

Runtime feature discovery: which Public API features are enabled for this account, plus the accepted draft import formats, the full list of patchable draft keys, and the canonical enum values. Features are rolled out per account, so probe this endpoint before planning a multi-step flow — and re-check it when a write returns a feature-disabled 403. Requirements: any valid token — no specific scope. (An in-app session also works.) The public_api_job_drafting feature itself must be enabled for the account, otherwise 403.

Request

No parameters.

Response

string

Always public_api_job_drafting.

string

Always job-drafts.

string

How the drafting feature is rolled out for this account (e.g. ALL, ALLOWLIST).

boolean

Whether the account is a platform admin.

object

Per-feature booleans for this account. Any false here means the matching endpoints return 403 until the feature is enabled.

Show capabilities fields

boolean

Structured imports via POST /job-drafts.

boolean

Draft creation.

boolean

Draft patching via PATCH /job-drafts/{jobId}.

boolean

Draft/review URL reads.

boolean

Publishing, closing, and editing live jobs (public_api_job_publishing).

boolean

Hiring and inviting (public_api_hiring).

boolean

Sending messages (public_api_messaging_writes).

boolean

Team invites (public_api_team).

boolean

Milestone funding/approval (public_api_payments_write).

boolean

Credits endpoints (public_api_credits).

boolean

Webhook subscriptions (public_api_webhooks).

object

Machine-readable drafting contract.

Show draft fields

string[]

Accepted import formats: text, opentrain_canonical, schema_org_job_posting, indeed_xml, hr_xml.

string[]

Every key accepted by PATCH /job-drafts/{jobId} — ~50 keys including jobTitle, jobDescription, paymentType, pricePerHour, pricePerLabel, fixedPrice, experienceLevel, languages, countries, headcount.

object

Canonical enum values: paymentType (PAY_PER_LABEL, PAY_PER_HOUR, FIXED_PRICE), experienceLevel (EXPERT, ENTRY_LEVEL, INTERMEDIATE, ANY_EXPERIENCE_LEVEL), dataVolumeUnit (HOURS_OF_RECORDING_AUDIO_VIDEO, NUMBER_OF_FILES, NUMBER_OF_WORDS, UNKNOWN_NOT_SPECIFIED).

string

token when authenticated by bearer token, session when by in-app session.

boolean

Always true on a 200 (a disabled drafting feature returns 403 instead).

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing, invalid, expired, or revoked token (and no session)
`403`	`FORBIDDEN`	`public_api_job_drafting` not enabled for this account (`details.featureKey`, `details.mode`)

curl -sS https://app.opentrain.ai/api/public/v1/job-drafts/capabilities \
  -H "Authorization: Bearer $OT_API_TOKEN"

{}

{
  "featureKey": "public_api_job_drafting",
  "namespace": "job-drafts",
  "rolloutMode": "ALL",
  "actorIsAdmin": false,
  "capabilities": {
    "draftImport": true,
    "draftCreate": true,
    "draftUpdate": true,
    "draftUrlRead": true,
    "publish": true,
    "hiring": true,
    "messagingWrites": true,
    "team": true,
    "paymentsWrite": true,
    "credits": true,
    "webhooks": true
  },
  "draft": {
    "importFormats": [
      "text",
      "opentrain_canonical",
      "schema_org_job_posting",
      "indeed_xml",
      "hr_xml"
    ],
    "updateKeys": [
      "jobTitle",
      "jobDescription",
      "labelingOverview",
      "datasetDescription",
      "dataType",
      "subjectMatter",
      "dataVolume",
      "dataVolumeUnit",
      "labelingSoftware",
      "headcount",
      "experienceLevel",
      "paymentType",
      "pricePerHour",
      "pricePerLabel",
      "fixedPrice",
      "countries",
      "languages",
      "labelTypes",
      "..."
    ],
    "enums": {
      "paymentType": ["PAY_PER_LABEL", "PAY_PER_HOUR", "FIXED_PRICE"],
      "experienceLevel": ["EXPERT", "ENTRY_LEVEL", "INTERMEDIATE", "ANY_EXPERIENCE_LEVEL"],
      "dataVolumeUnit": [
        "HOURS_OF_RECORDING_AUDIO_VIDEO",
        "NUMBER_OF_FILES",
        "NUMBER_OF_WORDS",
        "UNKNOWN_NOT_SPECIFIED"
      ]
    }
  },
  "authBootstrap": "token",
  "enabled": true
}

{
  "error": "Public API feature not enabled for actor",
  "code": "FORBIDDEN",
  "requestId": "<REQUEST_ID>",
  "details": {
    "featureKey": "public_api_job_drafting",
    "mode": "OFF"
  }
}

Update Job Draft

Get Proposal

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Get Drafting Capabilities

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors