> ## Documentation Index > Fetch the complete documentation index at: https://docs.sendora.ai/llms.txt > Use this file to discover all available pages before exploring further. # Save voice-agent draft > Save voice-agent draft. See the request and response schemas for the complete public API contract. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout. ## OpenAPI ````yaml /openapi.json post /api/v1/public/voice-agents/drafts openapi: 3.1.0 info: description: >- Customer-facing API for managing outreach, leads, conversations, voice agents, knowledge bases, analytics, and webhooks. title: Sendora Public API version: 1.0.0 servers: - description: Production url: https://api.sendora.ai security: [] tags: - description: Build, launch, pause and stop campaigns, and enroll leads. name: Campaigns - description: Create, update, tag, enrich and import leads. name: Leads - description: Group leads into reusable lists. name: Lead lists - description: Find new prospects and research existing leads. name: Prospecting - description: Read conversations and send messages to leads. name: Inbox - description: Manage workspace-wide suppressions. name: Do not contact - description: Manage the content your agents answer from. name: Knowledge bases - description: Create, configure, test and publish voice agents. name: Voice agents - description: Give agents actions such as booking, lookups and transfers. name: Agent tools - description: Embed a voice agent on your website. name: Voice widgets - description: Start voice calls and read call results. name: Calls - description: Browse and preview the voices an agent can use. name: Voices - description: List numbers, bring your own, and route calls. name: Phone numbers - description: List the channel accounts connected to the workspace. name: Connected accounts - description: Register endpoints and review deliveries. name: Webhooks - description: Drive the workspace assistant programmatically. name: Copilot - description: Read workspace and campaign performance. name: Analytics - description: Track asynchronous operations. name: Jobs - description: Manage client workspaces, plans and branding. name: Agency paths: /api/v1/public/voice-agents/drafts: post: tags: - Voice agents summary: Save voice-agent draft description: >- Save voice-agent draft. See the request and response schemas for the complete public API contract. This operation can change workspace data or trigger an external side effect; review the request before sending it and do not retry blindly after a timeout. operationId: public_save_voice_agent_draft_api_v1_public_voice_agents_drafts_post parameters: - in: header name: X-API-Key required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - in: header name: Authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization requestBody: content: application/json: schema: $ref: '#/components/schemas/AgentCreate' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/PublicVoiceAgentOut' description: Successful Response '401': description: The X-API-Key header is missing, invalid, expired, or revoked. '402': description: >- The workspace is suspended for billing, or the request would exceed a plan or usage limit. '403': description: >- The key is valid but lacks the required scope, or the workspace has no active plan, lacks the entitlement, or has this feature turned off or view-only. '404': description: >- The resource does not exist or is not owned by the authenticated workspace. '409': description: >- The requested state transition conflicts with the resource's current state. '410': description: The workspace behind this key has been deleted. '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error '500': description: >- An unexpected Sendora error occurred. Retry only if the operation is safe to repeat. '503': description: >- An entitlement or billing check is temporarily unavailable. Retry after the Retry-After interval. security: - ApiKeyAuth: [] x-codeSamples: - label: cURL lang: bash source: >- curl -X POST 'https://api.sendora.ai/api/v1/public/voice-agents/drafts' -H "X-API-Key: $SENDORA_API_KEY" -H "Content-Type: application/json" \ -d '{"direction":"example","first_message":"example","first_message_delay_seconds":1.0}' - label: Python lang: python source: >- import requests url = 'https://api.sendora.ai/api/v1/public/voice-agents/drafts' headers = {'X-API-Key': '$SENDORA_API_KEY'} response = requests.post(url, headers=headers, json={'direction': 'example', 'first_message': 'example', 'first_message_delay_seconds': 1.0}) response.raise_for_status() print(response.json()) - label: JavaScript lang: javascript source: >- const response = await fetch("https://api.sendora.ai/api/v1/public/voice-agents/drafts", { method: "POST", headers: { 'X-API-Key': process.env.SENDORA_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({"direction": "example", "first_message": "example", "first_message_delay_seconds": 1.0}), }); if (!response.ok) throw new Error(await response.text()); console.log(await response.json()); - label: Go lang: go source: >- req, err := http.NewRequest("POST", "https://api.sendora.ai/api/v1/public/voice-agents/drafts", bytes.NewBufferString(`{"direction": "example", "first_message": "example", "first_message_delay_seconds": 1.0}`)) if err != nil { log.Fatal(err) } req.Header.Set("X-API-Key", os.Getenv("SENDORA_API_KEY")) req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer resp.Body.Close() components: schemas: AgentCreate: properties: direction: default: outbound description: >- 'outbound' (places calls) or 'inbound' (answers calls on assigned numbers) title: Direction type: string first_message: default: '' description: Opening words spoken by the agent at call start maxLength: 2000 title: First Message type: string first_message_delay_seconds: anyOf: - type: number - type: 'null' description: First message delay seconds returned by the Sendora API. title: First Message Delay Seconds first_speaker: default: agent description: '''agent'' or ''user''' title: First Speaker type: string inactivity_messages: anyOf: - items: {} type: array - type: 'null' description: Inactivity messages returned by the Sendora API. title: Inactivity Messages join_timeout_seconds: anyOf: - type: integer - type: 'null' description: Join timeout seconds returned by the Sendora API. title: Join Timeout Seconds language_hint: default: en description: BCP-47 language hint, e.g. 'en', 'de', 'es' maxLength: 16 title: Language Hint type: string max_duration_seconds: default: 300 description: Max duration seconds returned by the Sendora API. title: Max Duration Seconds type: integer model: default: voice service-v0.6 description: Model returned by the Sendora API. title: Model type: string name: default: New Agent description: Name returned by the Sendora API. maxLength: 200 title: Name type: string output_medium: default: voice description: '''voice'' or ''text''' title: Output Medium type: string recording_enabled: default: true description: Recording enabled returned by the Sendora API. title: Recording Enabled type: boolean system_prompt: default: >- You are a professional AI sales development representative making outbound calls. description: System prompt returned by the Sendora API. maxLength: 20000 title: System Prompt type: string temperature: default: 0.7 description: Temperature returned by the Sendora API. title: Temperature type: number time_exceeded_message: anyOf: - type: string - type: 'null' description: Time exceeded message returned by the Sendora API. title: Time Exceeded Message tools: anyOf: - items: {} type: array - type: 'null' description: voice service tool definitions (JSONB) title: Tools uninterruptible: default: false description: Uninterruptible returned by the Sendora API. title: Uninterruptible type: boolean voice_asset_id: anyOf: - maxLength: 160 type: string - type: 'null' description: >- The voice to use: the `asset_id` of a voice in List agent voice choices. title: Voice Asset Id voice_id: default: '' description: 'A voice''s id: the `id` from List available voices.' maxLength: 128 title: Voice Id type: string voicemail_enabled: default: false description: Drop a voicemail when a call this agent places reaches voicemail title: Voicemail Enabled type: boolean voicemail_script: anyOf: - maxLength: 600 type: string - type: 'null' description: >- Spoken live when voicemail is detected; supports {{lead.*}} and {{ai:...}} tokens title: Voicemail Script required: [] title: AgentCreate type: object PublicVoiceAgentOut: description: >- Deliberately minimal public representation of a voice agent. The authenticated operator API returns the full configuration, but public API keys must not receive system prompts, tool definitions, tenant IDs, or connected service resource identifiers as an incidental side effect of listing an agent. Configuration is accepted on write requests but is never echoed. properties: created_at: description: Created at returned by the Sendora API. format: date-time title: Created At type: string direction: default: outbound description: Direction returned by the Sendora API. title: Direction type: string display_name: anyOf: - type: string - type: 'null' description: Display name returned by the Sendora API. title: Display Name first_message: default: '' description: First message returned by the Sendora API. title: First Message type: string id: description: The voice agent's id. Pass it to any endpoint that takes `agent_id`. title: Id type: string is_active: default: false description: Is active returned by the Sendora API. title: Is Active type: boolean name: description: Name returned by the Sendora API. title: Name type: string ready: default: false description: Ready returned by the Sendora API. title: Ready type: boolean updated_at: anyOf: - format: date-time type: string - type: 'null' description: Updated at returned by the Sendora API. title: Updated At required: - id - name - created_at title: PublicVoiceAgentOut type: object HTTPValidationError: properties: detail: description: Detail returned by the Sendora API. items: $ref: '#/components/schemas/ValidationError' title: Detail type: array required: [] title: HTTPValidationError type: object ValidationError: properties: loc: description: Loc returned by the Sendora API. items: anyOf: - type: string - type: integer title: Location type: array msg: description: Msg returned by the Sendora API. title: Message type: string type: description: Type returned by the Sendora API. title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: ApiKeyAuth: description: Customer API key created in the Sendora dashboard. in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.