POST
/
interview
Create a new interview
curl --request POST \
  --url https://public.api.micro1.ai/interview \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "interview_name": "Full Stack Engineer Interview",
  "skills": [
    {
      "name": "React",
      "description": "Must be proficient in React Context API"
    }
  ],
  "custom_question_list": [
    {
      "question": "What are your strengths and weaknesses?",
      "time": 2,
      "type": "audio"
    }
  ],
  "interview_language": "en",
  "can_change_interview_language": false,
  "only_coding_round": false,
  "is_coding_round_required": false,
  "selected_coding_language": "python",
  "coding_exercise_details": "Make the DSA problem extremely difficult and focus on a problem that will require recursion to solve efficiently.",
  "is_proctoring_required": true
}'
{
  "status": true,
  "message": "Interview created successfully",
  "data": {
    "interview_id": "123e4567-e89b-12d3-a456-426614174000",
    "invite_url": "https://interview.micro1.ai/intro/micro1?uid=123e4567-e89b-12d3-a456-426614174000"
  }
}

Authorizations

​
x-api-key
string
header
required

API key to access the API

Body

application/json

Request body to create an interview

Request to create an interview

​
interview_name
string
required

Name of the interview

Example:

"Full Stack Engineer Interview"

​
skills
object[]

Required skills for the interview (max 5)

Example:
[
  {
    "name": "React",
    "description": "Must be proficient in React Context API"
  }
]
​
custom_question_list
object[]

Custom questions for the interview (max 20)

Example:
[
  {
    "question": "What are your strengths and weaknesses?",
    "time": 2,
    "type": "audio"
  }
]
​
interview_language
enum<string>
default:en

The language in which the AI interview will be conducted

Available options:
en,
fr,
de,
he,
hi,
pt,
es,
tr,
es-la,
ja,
sv,
ar
Example:

"en"

​
can_change_interview_language
boolean
default:false

Whether the candidate can change the language

​
only_coding_round
boolean
default:false

Whether the interview is a coding round only

​
is_coding_round_required
boolean
default:false

​​Whether the coding round is required

​
selected_coding_language
enum<string>
default:user_choice

The coding language for the coding round

Available options:
user_choice,
javascript,
cpp,
c,
csharp,
go,
java,
kotlin,
php,
python,
ruby,
rust,
swift,
typescript
Example:

"python"

​
coding_exercise_details
string

Add more details to tailor the coding exercise (optional) - Note: The candidate won't be able to use outside libraries.

Example:

"Make the DSA problem extremely difficult and focus on a problem that will require recursion to solve efficiently."

​
is_proctoring_required
boolean
default:true

Whether the proctoring is required

Response

Successful response

Response for creating an interview

​
status
boolean

Whether the request was successful

Example:

true

​
message
string

The message for the response

Example:

"Interview created successfully"

​
data
object

Interview details