Create position for integrations

Authorization

APIKeyHeader

X-API-Key<token>

In: header

Request Body

application/json

name*string

Position name

job_description*string

Position description

company_position_uuid*string

Customer-managed external position ID (opaque string)

location?|

Optional position location label

job_mode?|

Optional job mode override. Accepts dashboard-like values Remote/Hibird/Presential and normalizes them to remote/hybrid/onsite.

language?|

Optional interview language override. Defaults to en.

duration?|

Optional interview duration in minutes

challenge_level?|

Optional challenge level override (1-10)

depth_level?|

Optional depth level override (1-10)

evaluation_criteria?array<>

Customer-provided evaluation criteria labels

extract_data?array<>

Custom fields to extract from the interview

interview_channel?string

Default"chat:google_meet"

assistant_provider?string

Default"elevenlabs"

interview_type?string

Type of interview (e.g., 'blue-collar', 'white-collar')

Default"white-collar"

Value in"blue-collar" | "white-collar"

Response Body

`application/json`

curl -X POST "https://api.hirevoice.dev/api/integration/v1/positions" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "job_description": "string",    "company_position_uuid": "string"  }'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "job_description": "string",
  "company_position_uuid": "string"
}

{
  "detail": "string",
  "code": "string"
}

Empty

{
  "detail": "string",
  "code": "string"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

{
  "detail": "string",
  "code": "string"
}

Create position for integrations

Authorization

Request Body

Response Body

201application/json

400application/json

401

409application/json

422application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`