Skip to main content
POST
/
interviews
/
{id}
/
call-attempts
Invoke new call attempt
curl --request POST \
  --url https://api.instaview.sk/interviews/{id}/call-attempts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scheduledAt": "2026-05-01T10:00:00Z"
}
'
{
  "success": true,
  "message": "<string>"
}
Creates a new call attempt for an existing phone interview. This allows you to manually trigger a call or schedule a retry if a previous attempt was unsuccessful.
ONLINE Interviews: Individual call attempt management is strictly forbidden for ONLINE interviews. For ONLINE interviews, you must manage the entire interview lifecycle using the Delete Interview endpoint.

​
Overview

The invoke call attempt endpoint allows you to trigger a new call for a phone interview. This is useful when:
  • A previous call attempt failed (e.g., no answer, busy) and you want to try again manually.
  • You want to override the automatic retry logic and trigger a call immediately.
  • You want to schedule a specific time for the next call attempt.

​
Constraints and Behavior

  • Queue Management: When a new call attempt is invoked, any existing scheduled attempts for that interview are automatically cancelled and replaced by the new attempt.
  • In-Progress Protection: If a call is already in progress for the interview, you cannot invoke a new attempt.
  • Transactional Integrity: The creation of a call attempt and its synchronization with the processing queue is handled transactionally.

​
Examples

​
Immediate Call

Omit scheduledAt to trigger a call attempt as soon as possible: 
{
  "scheduledAt": null
}

​
Scheduled Call Attempt

Provide a future ISO 8601 timestamp to schedule the call for a specific time: 
{
  "scheduledAt": "2026-05-01T10:00:00Z"
}
Next Steps: After invoking a call attempt, you can monitor its status by fetching the interview via the Get Interview endpoint and inspecting the callAttempts array.

Authorizations

​
Authorization
string
header
required

API key for authentication using Bearer scheme

Path Parameters

​
id
string<uuid>
required

Query Parameters

​
companyId
string

Required for ATS API keys to specify which company to access. Ignored for standard company API keys.

Body

application/json
​
scheduledAt
string<date-time>

Optional scheduled time for the call attempt (ISO string). If not provided, call will be invoked immediately.

Example:

"2026-05-01T10:00:00Z"

Response

201 - application/json

Call attempt created successfully

​
success
boolean
​
message
string