Assign Interviewer

Assign an interviewer to a candidate and schedule an interview

POST /graphql

Assign Interviewer

cURL

curl --request POST \
  --url https://api.example.com/graphql \
  --header 'Content-Type: application/json' \
  --data '
{
  "candidateId": "<string>",
  "interviewerId": "<string>",
  "dateAndTime": "<string>",
  "status": "<string>"
}
'

200 OK

{
  "data": {
    "assignInterviewer": {
      "message": "Interview scheduled successfully",
      "result": {
        "acknowledged": true,
        "insertedId": "68e8fd74d5aa0cdd7f206c34",
        "_id": "68e8fd74d5aa0cdd7f206c34"
      }
    }
  }
}

Overview

Schedule an interview by assigning an interviewer to a candidate with a specific date and time.

Endpoint

POST /graphql
Content-Type: application/json

GraphQL Mutation

mutation assignInterviewer($input: AssignInterviewerInput!) {
  assignInterviewer(input: $input) {
    message
    result {
      acknowledged
      insertedId
      _id
    }
  }
}

Request Parameters

candidateId · string · required

Unique identifier of the candidate

interviewerId · string · required

Unique identifier of the interviewer

dateAndTime · string · required

Interview date and time in ISO 8601 format (UTC)

status · string · required

Interview status (typically “Scheduled”)

Request Example

cURL

curl -X POST https://api.exterview.ai/graphql \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation assignInterviewer($input: AssignInterviewerInput!) { assignInterviewer(input: $input) { message result { acknowledged insertedId _id } } }",
    "variables": {
      "input": {
        "candidateId": "C100",
        "interviewerId": "I99",
        "dateAndTime": "2025-10-22T18:45:00.000Z",
        "status": "Scheduled"
      }
    }
  }'

Response

data · object

Show data properties

assignInterviewer · object

Show assignInterviewer properties

message · string

Success or error message

result · object

Database operation result

Show result properties

acknowledged · boolean

Whether the operation was acknowledged

insertedId · string

ID of the created interview record

_id · string

Database ID of the interview

Response Example

200 OK

{
  "data": {
    "assignInterviewer": {
      "message": "Interview scheduled successfully",
      "result": {
        "acknowledged": true,
        "insertedId": "68e8fd74d5aa0cdd7f206c34",
        "_id": "68e8fd74d5aa0cdd7f206c34"
      }
    }
  }
}