> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instaview.sk/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoke New Call Attempt

> Creates a new call attempt for an interview. Optionally schedules it for a future time. Individual call attempt management is strictly forbidden for ONLINE interviews.

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.

<Warning>
  **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](/api-reference/interviews/delete-interview) endpoint.
</Warning>

## 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:

```json theme={null}
{
  "scheduledAt": null
}
```

### Scheduled Call Attempt

Provide a future ISO 8601 timestamp to schedule the call for a specific time:

```json theme={null}
{
  "scheduledAt": "2026-05-01T10:00:00Z"
}
```

<Info>
  **Next Steps**: After invoking a call attempt, you can monitor its status by fetching the interview via the [Get Interview](/api-reference/interviews/get-interview) endpoint and inspecting the `callAttempts` array.
</Info>


## OpenAPI

````yaml POST /interviews/{id}/call-attempts
openapi: 3.0.0
info:
  title: InstaView API
  description: |-
    InstaView API Documentation

    ## Authentication

    All endpoints require API key authentication using Bearer token:
    ```
    Authorization: Bearer sk_your_api_key_here
    ```

    ## API Key Management

    The API Key module provides comprehensive key management for:
    - **Direct Client Keys**: Company-scoped keys for your applications
    - **ATS Partner Keys**: Resource-scoped keys for ATS integrations

    ### Key Features
    - HMAC-SHA256 hashing for API key storage
    - Configurable rate limiting
    - Comprehensive audit logging
    - Company-level isolation
    - Resource scoping for ATS partners
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.instaview.sk
    description: Production API Gateway
security: []
tags: []
paths:
  /interviews/{id}/call-attempts:
    post:
      tags:
        - Interviews
      summary: Invoke new call attempt
      description: >-
        Creates a new call attempt for an interview. Optionally schedules it for
        a future time. Individual call attempt management is strictly forbidden
        for ONLINE interviews.
      operationId: PublicInterviewsController_invokeCallAttempt_v1
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
            format: uuid
        - name: companyId
          required: false
          in: query
          description: >-
            Required for ATS API keys to specify which company to access.
            Ignored for standard company API keys.
          schema:
            type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicInvokeCallAttemptDto'
      responses:
        '201':
          description: Call attempt created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
      security:
        - bearer: []
components:
  schemas:
    PublicInvokeCallAttemptDto:
      type: object
      properties:
        scheduledAt:
          type: string
          description: >-
            Optional scheduled time for the call attempt (ISO string). If not
            provided, call will be invoked immediately.
          example: '2026-05-01T10:00:00Z'
          format: date-time
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: API key for authentication using Bearer scheme

````