Skip to main content

Source of truth

This reference is aligned with the public JavaScript SDK and public API schema.
  • OpenAPI schema: https://api.sippet.ai/api/open_api
OpenAPI uses snake_case keys. SDK field selection uses camelCase.

Common request props

All RPC functions accept transport options:
  • headers?: Record<string, string>
  • fetchOptions?: RequestInit
  • customFetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>
List actions that support pagination use:
page?: { limit?: number; offset?: number; count?: boolean }
     | { limit?: number; after?: string; before?: string }

Public actions

RPC actionSDK functionDomain props
accept_team_invitationacceptTeamInvitationinput
list_gatewayslistGatewaysfields, filter?, sort?, page?
list_operator_statuseslistOperatorStatusesfields, filter?, sort?, page?
set_operator_statussetOperatorStatusinput, fields?
list_conversationslistConversationsfields, filter?, sort?, page?
create_conversationcreateConversationinput?, fields?
update_conversationupdateConversationidentity, input?, fields?
list_call_queue_entrieslistCallQueueEntriesfields, filter?, sort?, page?
accept_call_queue_entryacceptCallQueueEntryidentity, input, fields?
get_call_queue_entrygetCallQueueEntryinput, fields
list_call_participantslistCallParticipantsfields, filter?, sort?, page?
list_queueslistQueuesfields, filter?, sort?, page?
list_call_transcriptslistCallTranscriptsfields, filter?, sort?, page?
list_callslistCallsfields, filter?, sort?
create_callcreateCallinput, fields?
call_codeccallCodecinput
barge_callbargeCallinput
resume_ai_callresumeAiCallinput
issue_sip_accessissueSipAccessinput
revoke_sip_accessrevokeSipAccessinput
end_callendCallinput
start_outbound_callstartOutboundCallinput
list_conversation_itemslistConversationItemsfields, filter?, sort?, page?
list_conversation_items_by_public_idlistConversationItemsByPublicIdinput, fields, filter?, sort?
list_phone_numberslistPhoneNumbersfields, filter?, sort?, page?
issue_operator_sip_accessissueOperatorSipAccessnone
list_contactslistContactsfields, filter?, sort?, page?
create_contactcreateContactinput, fields?
update_contactupdateContactidentity, input, fields?
delete_contactdeleteContactidentity
organisation_wallet_summaryorganisationWalletSummarynone
sign_in_with_passwordsignInWithPasswordinput, fields, metadataFields?
confirm_emailconfirmEmailinput
who_am_iwhoAmIfields
logoutlogoutnone
list_call_ai_audit_eventslistCallAiAuditEventsfields, filter?, sort?, page?
list_operator_status_eventslistOperatorStatusEventsfields, filter?, sort?, page?
list_ai_agentslistAiAgentsfields, filter?, sort?, page?
For each action there is also a validator variant: validate<ActionName>(...).

Input objects

AcceptTeamInvitationInput
  • token: string
  • fullName?: string
  • password?: string
  • passwordConfirmation?: string
SetOperatorStatusInput
  • sipUserId: UUID
  • status?: "available" | "on_break" | "logged_out"
  • source?: "widget" | "api" | "system" | null
CreateConversationInput
  • channel?: "chat" | "call"
  • mode?: "text" | "voice"
  • metadata?: Record<string, any> | null
  • aiAgentId?: UUID | null
UpdateConversationInput
  • status?: "active" | "ended"
  • mode?: "text" | "voice"
  • metadata?: Record<string, any> | null
  • aiAgentId?: UUID | null
AcceptCallQueueEntryInput
  • operatorName: string
GetCallQueueEntryInput
  • id: UUID
CreateCallInput
  • direction: "inbound" | "outbound"
  • fromNumber: string
  • toNumber: string
  • sipUsername?: string | null
  • callUuid: string
  • callSource?: string
  • status?: "initiated" | "ringing" | "answered" | "completed" | "failed" | "busy" | "no_answer" | null
  • conversationId?: UUID | null
  • startedAt?: UtcDateTimeUsec | null
CallCodecInput
  • callUuid: string
BargeCallInput
  • callUuid: string
ResumeAiCallInput
  • callUuid: string
IssueSipAccessInput
  • callUuid: string
RevokeSipAccessInput
  • callUuid: string
  • reason?: string
EndCallInput
  • callUuid: string
StartOutboundCallInput
  • contactId: UUID
  • aiAgentId: UUID
ListConversationItemsByPublicIdInput
  • publicId: string
CreateContactInput
  • fullName: string
  • email?: string | null
  • phoneE164?: string | null
  • notes?: string | null
UpdateContactInput
  • fullName?: string
  • email?: string | null
  • phoneE164?: string | null
  • notes?: string | null
SignInWithPasswordInput
  • email: string
  • password: string
ConfirmEmailInput
  • token: string
SignInWithPassword metadata fields
  • token

Selectable fields (fields)

Gateway
  • id, name, provider, username, realm, proxy, register, fromDomain, fromUser, inboundAcl, password
OperatorStatus
  • id, sipUserId, agentName, status, source, changedByUserId
Conversation
  • id, status, channel, mode, publicId, metadata, aiAgentId
CallQueueEntry
  • id, callUuid, queueName, callerIdNumber, callerIdName, state, agentName, waitStartedAt, answeredAt, completedAt, abandonedAt
CallParticipant
  • id, memberUuid, role, joinedAt, leftAt, callId, organisationId
Queue
  • id, queueName, strategy, mohSound, maxWaitTime
CallTranscript
  • id, content, speaker, itemId, contentIndex, occurredAt, callId
Call
  • id, direction, fromNumber, toNumber, sipUsername, status, callUuid, callSource, startedAt, endedAt, durationSeconds, conversationId
ConversationItem
  • id, role, modality, content, metadata, itemId, contentIndex, occurredAt, conversationId
PhoneNumber
  • id, phoneE164, label
Contact
  • id, fullName, email, phoneE164, notes
User
  • id, fullName, email, sipUsername
CallAiAuditEvent
  • id, eventType, toolName, toolCallId, toolArgumentsRaw, toolArguments, toolOutput, error, success, stateId, stateLabel, stepIndex, totalSteps, progressPercent, tokenUsage, inputTokens, outputTokens, totalTokens, inputTextTokens, inputAudioTokens, inputImageTokens, inputCachedTokens, inputCachedTextTokens, inputCachedAudioTokens, inputCachedImageTokens, outputTextTokens, outputAudioTokens, outputImageTokens, model, payload, callUuid, roomId, agentId, occurredAt, callId, organisationId
OperatorStatusEvent
  • id, sipUserId, agentName, status, source, changedByUserId
AiAgent
  • id, name, voice, tone, languages, workflow, systemPrompt, safetyGuardrails, published
  • Quickstart: /quickstart
  • Getting started (classic): /guides/getting-started-classic
  • Realtime patterns: /guides/realtime-telephony-patterns