Get Drafting Capabilities

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

featureKeystring

Always public_api_job_drafting.

namespacestring

Always job-drafts.

rolloutModestring

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

actorIsAdminboolean

Whether the account is a platform admin.

capabilitiesobject

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

capabilities fields

draftImportboolean

Structured imports via POST /job-drafts.

draftCreateboolean

Draft creation.

draftUpdateboolean

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

draftUrlReadboolean

Draft/review URL reads.

publishboolean

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

hiringboolean

Hiring and inviting (public_api_hiring).

messagingWritesboolean

Sending messages (public_api_messaging_writes).

teamboolean

Team invites (public_api_team).

paymentsWriteboolean

Milestone funding/approval (public_api_payments_write).

creditsboolean

Credits endpoints (public_api_credits).

webhooksboolean

Webhook subscriptions (public_api_webhooks).

draftobject

Machine-readable drafting contract.

draft fields

importFormatsstring[]

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

updateKeysstring[]

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

enumsobject

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).

authBootstrapstring

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

enabledboolean

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)

Request examples

curlMCP: opentrain_capabilities

curl

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

MCP: opentrain_capabilities

{}

Response examples

200403

200

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

403

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