# Outbound Calls

Initiate outbound calls

## Initiate outbound call

> Initiates an outbound call via the telephony provider.\
> The from\_number must be owned by the organization and have outbound enabled.<br>

```json
{"openapi":"3.0.3","info":{"title":"KrosAI Cockpit API","version":"1.3.0"},"tags":[{"name":"Outbound Calls","description":"Initiate outbound calls"}],"servers":[{"url":"https://api.krosai.com/v1","description":"Production API"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key in format `kros_live_xxxx` for production or `kros_test_xxxx` for testing.\nAlso accepts JWT tokens from Supabase Auth for dashboard sessions.\n\n**Alternative:** You can also use the `x-api-key` header instead of Authorization Bearer.\n"}},"parameters":{"OrganizationId":{"name":"x-organization-id","in":"header","required":false,"description":"Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.","schema":{"type":"string","format":"uuid"}}},"schemas":{"OutboundCallResponse":{"type":"object","properties":{"status":{"type":"string","enum":["initiated","queued","failed"]},"provider":{"type":"string"},"call_id":{"type":"string","format":"uuid"},"from_number":{"type":"string"},"to_number":{"type":"string"},"message":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","description":"Machine-readable error code"},"details":{"type":"object","additionalProperties":true,"description":"Additional error details"}}}},"responses":{"BadRequest":{"description":"Bad request - Invalid parameters or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PaymentRequired":{"description":"Insufficient balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/outbound-calls":{"post":{"tags":["Outbound Calls"],"summary":"Initiate outbound call","description":"Initiates an outbound call via the telephony provider.\nThe from_number must be owned by the organization and have outbound enabled.\n","operationId":"initiateOutboundCall","parameters":[{"$ref":"#/components/parameters/OrganizationId"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["from_number","to_number"],"properties":{"from_number":{"type":"string","description":"E.164 formatted phone number owned by org"},"to_number":{"type":"string","description":"E.164 formatted destination number"},"endpoint_id":{"type":"string","format":"uuid","description":"Optional endpoint to connect after answer"},"metadata":{"type":"object","additionalProperties":true,"description":"Custom metadata to pass to the call"}}}}}},"responses":{"200":{"description":"Call initiated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundCallResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"description":"Outbound not enabled for this number","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.krosai.com/api-reference/reference/outbound-calls.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.