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 '
{
  "modality": "voice",
  "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,
      "response_format": "text",
      "instructions": "<string>",
      "options": [
        "<string>"
      ],
      "structured_config": {},
      "created_at": 123,
      "updated_at": 123
    }
  ],
  "pagination": {
    "has_more": true,
    "total_count": 123,
    "url": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.heymilo.ai/llms.txt

Use this file to discover all available pages before exploring further.

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
required

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