Skip to main content
POST
/
graphql
Assign Interviewer
curl --request POST \
  --url https://api.example.com/graphql \
  --header 'Content-Type: application/json' \
  --data '
{
  "candidateId": "<string>",
  "interviewerId": "<string>",
  "dateAndTime": "<string>",
  "status": "<string>"
}
'
{
  "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 -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

Response Example

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