Create a marketplace job post (Open Role)

POST

/marketplace/job-posts

• Production
• QA

Create an Open Role under the calling key’s org. The role’s title, description (the client’s JD), criteria, comp, and openings live in the body. Send status="published" to go live to talent immediately, or "draft" (default) to stage it and publish later via PATCH.

Authorizations

• BearerAuth

Parameters

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

object

commission_plan_version_id

Any of:

string

string format: uuid

null

null

countries

Any of:

Array<string>

Array<string>

null

null

deal_size_band

Any of:

string

string

null

null

description

Any of:

string

string

null

null

engagement_type

string

default: monthly <= 30 characters

industries

Any of:

Array<string>

Array<string>

null

null

languages

Any of:

Array<string>

Array<string>

null

null

monthly_rate_usd_max

Any of:

number

number

string

string

null

null

monthly_rate_usd_min

Any of:

number

number

string

string

null

null

openings_count

integer

default: 1 >= 1

per_meeting_rate_usd

Any of:

number

number

string

string

null

null

regions

Any of:

Array<string>

Array<string>

null

null

role_type

required

string

<= 40 characters

seniority

Any of:

string

string

null

null

status

string

default: draft

title

required

string

<= 200 characters

tools

Any of:

Array<string>

Array<string>

null

null

Responses

201

Successful Response

object

data

required

object

key

additional properties

any

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string