SDK reference.

const agents = await client.agents.list()

for (const agent of agents) {
  console.log(agent.id, agent.agent_name, agent.status)
}

const agent = await client.agents.get('agt_abc123')

console.log(agent.business_name)  // 'Acme Corp'
console.log(agent.phone_number)   // '+14155551234'

const agent = await client.agents.create({
  business_name: 'Acme Corp',
  agent_name: 'After-Hours Support',
  voice_id: 'KR1TkIhkSykEjI4B0DtH', // Sarah
  greeting: 'Thanks for calling Acme Corp after hours.',
  system_prompt: `You are the after-hours support agent for Acme Corp.
    Take messages and let callers know someone will follow up
    during business hours.`,
  escalation_policy: 'requested',
  forwarding_number: '+14155559876',
  business_hours: {
    enabled: true,
    timezone: 'America/New_York',
    schedule: {
      monday: { open: '17:00', close: '09:00', enabled: true },
      tuesday: { open: '17:00', close: '09:00', enabled: true },
      // ...
    },
  },
  faq: [
    {
      question: 'When will someone call me back?',
      answer: 'A team member will return your call the next business day by noon.',
    },
  ],
})

console.log(agent.id)     // 'agt_def456'
console.log(agent.status) // 'active'

const updated = await client.agents.update('agt_abc123', {
  greeting: 'Hey! Thanks for calling Acme Corp.',
  escalation_policy: 'always',
})

console.log(updated.greeting) // updated greeting

await client.agents.delete('agt_abc123')
// Agent and all associated data removed

const functions = await client.agents.listFunctions(agent.id)

for (const fn of functions) {
  console.log(fn.function_name, fn.enabled)
}

const fn = await client.agents.enableFunction(agent.id, 'scheduleMeeting', {
  enabled: true,
  params: {
    calendly_url: 'https://calendly.com/acme/30min',
  },
})

console.log(fn.function_name, fn.enabled) // 'scheduleMeeting' true

await client.agents.disableFunction(agent.id, 'scheduleMeeting')

const { integrations, summary } = await client.agents.listIntegrations(agent.id)

console.log(summary.connected_integrations + '/' + summary.total_integrations + ' connected')

for (const int of integrations) {
  console.log(int.function_name, int.connected ? 'connected' : 'disconnected')
}

const detail = await client.agents.getIntegration(agent.id, 'sendGmail')

console.log(detail.integration.connected) // true
console.log(detail.integration.expired)   // false

const updated = await client.agents.updateIntegrationConfig(agent.id, 'readGoogleSheet', {
  spreadsheet_id: '1BxiM...',
  tab_name: 'Leads',
  header_row: 1,
})

const sheets = await client.agents.listSheets(agent.id)

for (const sheet of sheets) {
  console.log(sheet.name, sheet.id)
}

const tabs = await client.agents.listSheetTabs(agent.id, '1BxiM...')

for (const tab of tabs) {
  console.log(tab.title, tab.rowCount + ' rows')
}

// Search for San Francisco numbers
const numbers = await client.phoneNumbers.search({
  country: 'US',
  areaCode: '415',
  pageSize: 5,
})

for (const num of numbers) {
  console.log(num.friendlyName, num.capabilities)
}
// (415) 555-1234 { voice: true, SMS: true, MMS: true }
// (415) 555-5678 { voice: true, SMS: true, MMS: false }

const bundles = await client.phoneNumbers.getRegulatoryBundles('GB')

const approved = bundles.filter(b => b.status === 'twilio-approved')
console.log(approved.length, 'approved bundles')

const transcripts = await client.transcripts.list('agt_abc123', {
  limit: 10,
  type: 'Sales Inquiry',
})

for (const t of transcripts) {
  console.log(`[${t.date}] ${t.caller} — ${t.outcome}`)
  console.log(`  Summary: ${t.summary}`)
  console.log(`  Duration: ${t.duration_minutes}m`)
}

const transcript = await client.transcripts.get('agt_abc123', 'tr_xyz789')

// Access the full conversation
for (const turn of transcript.conversation) {
  console.log(`${turn.speaker}: ${turn.text}`)
}
// agent: Hello, thanks for calling Acme Corp!
// caller: Hi, I wanted to ask about your pricing.
// agent: Of course! We have three plans...

const voices = await client.voices.list()

for (const voice of voices) {
  console.log(`${voice.name} (${voice.accent}, ${voice.gender})`)
  console.log(`  ${voice.description}`)
}
// Kevin (American, Male)
//   Professional, warm, and articulate
// Sarah (American, Female)
//   Confident, friendly, and approachable
// Lucy (British, Female)
//   Energetic, clear, and engaging

const profile = await client.user.get()

console.log(profile.email)    // 'jane@acmecorp.com'
console.log(profile.company)  // 'Acme Corp'
console.log(profile.timezone) // 'America/New_York'

const { integrations, function_schemas } = await client.integrations.catalog()

for (const int of integrations) {
  console.log(int.name + ' (' + int.auth_type + ') — ' + int.description)
  console.log('  Functions:', int.functions.join(', '))
}

const sub = await client.subscription.get()

console.log(sub.plan)       // 'professional'
console.log(sub.status)     // 'active'
console.log(sub.usage.used) // 142
console.log(sub.usage.limit) // 500

const remaining = sub.usage.limit - sub.usage.used
console.log(`${remaining} calls remaining this period`)