Skip to main content
POST
/
api
/
v2
/
postings
/
{posting_id}
/
questions
/
reorder
Reorder questions
curl --request POST \
  --url https://api.heymilo.ai/api/v2/postings/{posting_id}/questions/reorder \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "order": [
    "<string>"
  ]
}
'
{
  "data": [
    {
      "id": "<string>",
      "posting_id": "<string>",
      "modality": "<string>",
      "text": "<string>",
      "object": "question",
      "rank": 1,
      "evaluation_criteria": "<string>",
      "score_of_1": "<string>",
      "score_of_5": "<string>",
      "score_weight": 123,
      "not_scored": true,
      "question_type": "<string>",
      "min_follow_ups": 123,
      "max_follow_ups": 123,
      "additional_instructions": "<string>",
      "post_processing_evaluation_criteria": "<string>",
      "expected_answer": "<string>",
      "expected_value": 123,
      "is_dealbreaker": true,
      "answer": "<unknown>",
      "is_knockout": true,
      "dropdown_values": [
        {}
      ],
      "is_answer_mandated": true,
      "mcq_type": "<string>",
      "operator": "<string>",
      "file_types": [
        "<string>"
      ],
      "allow_multiple_files": true,
      "slider_min": 123,
      "slider_max": 123,
      "slider_step": 123,
      "instructions": "<string>",
      "options": [
        "<string>"
      ],
      "structured_config": {},
      "created_at": 123,
      "updated_at": 123
    }
  ],
  "pagination": {
    "has_more": true,
    "total_count": 123,
    "url": "<string>"
  }
}

Authorizations

​
X-API-KEY
string
header
required

API key for authentication. Pass your key in the X-API-KEY header.

Headers

​
X-API-KEY
string | null
​
Authorization
string | null
​
X-Workspace-Id
string | null

Path Parameters

​
posting_id
string
required

Body

application/json

Request body for reordering questions within a modality.

​
modality
enum<string>
required

Modality to reorder: voice, sms, form, resume_eligibility, resume_scoring, voice_tags.

Available options:
voice,
sms,
form,
resume_eligibility,
resume_scoring,
voice_tags
Example:

"voice"

​
order
string[]
required

Ordered list of question IDs. Every active question for the specified modality must be included.

Example:
["Q1", "Q3", "Q2"]

Response

Successful Response

​
data
QuestionResponse · object[]
required
​
pagination
PaginationMeta · object
required