Invite Freelancer to Job

curl -sS -X POST https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/invites \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"freelancerId": "<FREELANCER_ID>"}'

opentrain jobs invite --job-id <JOB_ID> --freelancer-id <FREELANCER_ID> --json

{
  "jobId": "<JOB_ID>",
  "freelancerId": "<FREELANCER_ID>"
}

{
  "ok": true,
  "proposalId": "<PROPOSAL_ID>",
  "jobId": "<JOB_ID>",
  "freelancerId": "<FREELANCER_ID>",
  "alreadyInvited": false
}

{
  "error": "Job is not published",
  "code": "CONFLICT",
  "requestId": "<REQUEST_ID>",
  "details": {
    "reason": "job_not_published"
  }
}

POST

api

public

jobs

{id}

invites

curl -sS -X POST https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/invites \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"freelancerId": "<FREELANCER_ID>"}'

opentrain jobs invite --job-id <JOB_ID> --freelancer-id <FREELANCER_ID> --json

{
  "jobId": "<JOB_ID>",
  "freelancerId": "<FREELANCER_ID>"
}

{
  "ok": true,
  "proposalId": "<PROPOSAL_ID>",
  "jobId": "<JOB_ID>",
  "freelancerId": "<FREELANCER_ID>",
  "alreadyInvited": false
}

{
  "error": "Job is not published",
  "code": "CONFLICT",
  "requestId": "<REQUEST_ID>",
  "details": {
    "reason": "job_not_published"
  }
}

Invites a specific AI trainer to a published job of yours, creating an invited proposal they can respond to. Find candidates via GET /freelancers/{idOrSlug} or from proposals on other jobs. Idempotent per freelancer: re-inviting returns 200 with alreadyInvited: true instead of creating a duplicate. Requirements: proposals:write scope + the public_api_hiring feature + a claimed account (unclaimed accounts get 403 with details.reason: "account_claim_required" and a claimUrl). The job must be yours and published.

Request

string

required

Your published job’s ID.

string

required

The AI trainer’s user ID.

Response

201 when a new invite was created, 200 when the freelancer was already invited.

boolean

true on success.

string

The invited proposal’s ID — track it via GET /proposals/{id}.

string

The job ID.

string

The invited AI trainer’s user ID.

boolean

true when this invite already existed (idempotent repeat).

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	Missing or invalid `freelancerId` (zod details)
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `proposals:write` scope, `public_api_hiring` disabled, or account not claimed (`details.reason: "account_claim_required"`, `details.claimUrl`)
`404`	`NOT_FOUND`	No such job (or not yours), or no such user
`409`	`CONFLICT`	Invite not possible — `details.reason` is one of `job_not_published`, `not_a_freelancer`, `freelancer_unavailable`

curl -sS -X POST https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/invites \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"freelancerId": "<FREELANCER_ID>"}'

opentrain jobs invite --job-id <JOB_ID> --freelancer-id <FREELANCER_ID> --json

{
  "jobId": "<JOB_ID>",
  "freelancerId": "<FREELANCER_ID>"
}

{
  "ok": true,
  "proposalId": "<PROPOSAL_ID>",
  "jobId": "<JOB_ID>",
  "freelancerId": "<FREELANCER_ID>",
  "alreadyInvited": false
}

{
  "error": "Job is not published",
  "code": "CONFLICT",
  "requestId": "<REQUEST_ID>",
  "details": {
    "reason": "job_not_published"
  }
}

Close Job

List Job Proposals

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Invite Freelancer to Job

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors