Initiate AI Call

curl --request POST \
  --url https://api.tidyhire.app/api/public/v1/call/initiate \
  --header 'x-tidyhire-api-key: <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ats_job_id": "ats-job-12345",
  "candidates": [
    {
      "id": "ats-candidate-001",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "phone": "+917873476062"
    }
  ],
  "instructions": "You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.",
  "disposition": {
    "type": "single_select",
    "description": "Qualified if candidate scored well, has ≤30-day notice, and can relocate.",
    "choices": ["Qualified", "Not Qualified", "Inconclusive"]
  }
}'

import requests

url = "https://api.tidyhire.app/api/public/v1/call/initiate"

headers = {
    "x-tidyhire-api-key": "<token>",
    "Content-Type": "application/json"
}

payload = {
    "ats_job_id": "ats-job-12345",
    "candidates": [
        {
            "id": "ats-candidate-001",
            "name": "John Doe",
            "email": "john.doe@example.com",
            "phone": "+917873476062"
        }
    ],
    "instructions": "You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.",
    "disposition": {
        "type": "single_select",
        "description": "Qualified if candidate scored well, has ≤30-day notice, and can relocate.",
        "choices": ["Qualified", "Not Qualified", "Inconclusive"]
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

fetch('https://api.tidyhire.app/api/public/v1/call/initiate', {
  method: 'POST',
  headers: {
    'x-tidyhire-api-key': '<token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ats_job_id: 'ats-job-12345',
    candidates: [
      {
        id: 'ats-candidate-001',
        name: 'John Doe',
        email: 'john.doe@example.com',
        phone: '+917873476062',
      },
    ],
    instructions:
      'You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.',
    disposition: {
      type: 'single_select',
      description: 'Qualified if candidate scored well, has ≤30-day notice, and can relocate.',
      choices: ['Qualified', 'Not Qualified', 'Inconclusive'],
    },
  }),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error('Error:', error));

<?php

$url = 'https://api.tidyhire.app/api/public/v1/call/initiate';

$data = [
    'ats_job_id' => 'ats-job-12345',
    'candidates' => [
        [
            'id' => 'ats-candidate-001',
            'name' => 'John Doe',
            'email' => 'john.doe@example.com',
            'phone' => '+917873476062'
        ]
    ],
    'instructions' => 'You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.',
    'disposition' => [
        'type' => 'single_select',
        'description' => 'Qualified if candidate scored well, has ≤30-day notice, and can relocate.',
        'choices' => ['Qualified', 'Not Qualified', 'Inconclusive']
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-tidyhire-api-key: <token>',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://api.tidyhire.app/api/public/v1/call/initiate"

    payload := map[string]interface{}{
        "ats_job_id": "ats-job-12345",
        "candidates": []map[string]interface{}{
            {
                "id":    "ats-candidate-001",
                "name":  "John Doe",
                "email": "john.doe@example.com",
                "phone": "+917873476062",
            },
        },
        "instructions": "You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.",
        "disposition": map[string]interface{}{
            "type":        "single_select",
            "description": "Qualified if candidate scored well, has ≤30-day notice, and can relocate.",
            "choices":     []string{"Qualified", "Not Qualified", "Inconclusive"},
        },
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("x-tidyhire-api-key", "<token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class InitiateCall {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://api.tidyhire.app/api/public/v1/call/initiate");
            HttpURLConnection con = (HttpURLConnection) url.openConnection();

            con.setRequestMethod("POST");
            con.setRequestProperty("x-tidyhire-api-key", "<token>");
            con.setRequestProperty("Content-Type", "application/json");
            con.setDoOutput(true);

            String jsonInputString = "{\n" +
                "  \"ats_job_id\": \"ats-job-12345\",\n" +
                "  \"candidates\": [{\n" +
                "    \"id\": \"ats-candidate-001\",\n" +
                "    \"name\": \"John Doe\",\n" +
                "    \"email\": \"john.doe@example.com\",\n" +
                "    \"phone\": \"+917873476062\"\n" +
                "  }],\n" +
                "  \"instructions\": \"You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.\",\n" +
                "  \"disposition\": {\n" +
                "    \"type\": \"single_select\",\n" +
                "    \"description\": \"Qualified if candidate scored well, has ≤30-day notice, and can relocate.\",\n" +
                "    \"choices\": [\"Qualified\", \"Not Qualified\", \"Inconclusive\"]\n" +
                "  }\n" +
                "}";

            try (OutputStream os = con.getOutputStream()) {
                byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
                os.write(input, 0, input.length);
            }

            int status = con.getResponseCode();
            System.out.println("Response Status: " + status);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.tidyhire.app/api/public/v1/call/initiate')

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri.path)
request['x-tidyhire-api-key'] = '<token>'
request['Content-Type'] = 'application/json'

request.body = {
  ats_job_id: 'ats-job-12345',
  candidates: [
    {
      id: 'ats-candidate-001',
      name: 'John Doe',
      email: 'john.doe@example.com',
      phone: '+917873476062'
    }
  ],
  instructions: 'You are a recruiter for {{sender_company}}. Screen the candidate about their experience with distributed systems.',
  disposition: {
    type: 'single_select',
    description: 'Qualified if candidate scored well, has ≤30-day notice, and can relocate.',
    choices: ['Qualified', 'Not Qualified', 'Inconclusive']
  }
}.to_json

response = http.request(request)
puts response.body

{
  "success": true,
  "data": {
    "project_id": "64a1b2c3d4e5f6a7b8c9d0e1",
    "project_url": "https://platform.tidyhire.app/app/projects/64a1b2c3d4e5f6a7b8c9d0e1",
    "calls": [
      {
        "id": "64a1b2c3d4e5f6a7b8c9d0e4",
        "candidate_id": "ats-candidate-001",
        "name": "John Doe",
        "phone": "+917873476062",
        "status": "success",
        "message": "Call initiated"
      }
    ]
  }
}