canonical: https://jentic.com/apis/twilio.com/twilio---preview

# Twilio - Preview

This is the public Twilio REST API. The API exposes 34 endpoints secured with basic authentication.

## For AI agents

Programmatically updates a specific authorizationdocument., fetch a specific authorizationdocument.. Covers 34 operations with basic authentication.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Updates a specific AuthorizationDocument.
- Fetch a specific AuthorizationDocument.
- Create an AuthorizationDocument for authorizing the hosting of phone number capa
- Retrieve a list of AuthorizationDocuments belonging to the account initiating th
- Monitor Twilio - Preview operational status and events

## Use cases

### Developer Tools Operations

Use the Twilio - Preview to perform developer tools operations programmatically. The API provides 34 endpoints covering core functionality including updates a specific authorizationdocument., fetch a specific authorizationdocument., create an authorizationdocument for authorizing the hosting of phone number capa.

Example prompt: Call POST /HostedNumbers/AuthorizationDocuments/{Sid} to updates a specific authorizationdocument.

### Automated PreviewHostedNumbersAuthorizationDocument Management

Automate previewhostednumbersauthorizationdocument operations by combining multiple Twilio - Preview endpoints. Agents can fetch a specific authorizationdocument. and then create an authorizationdocument for authorizing the hosting of phone number capa in a single workflow.

Example prompt: Call GET /HostedNumbers/AuthorizationDocuments/{Sid} to fetch a specific authorizationdocument., then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Twilio - Preview endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle basic tokens manually.

Example prompt: Search Jentic for 'updates a specific authorizationdocument.', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /HostedNumbers/AuthorizationDocuments/{Sid} | Updates a specific AuthorizationDocument. |
| GET | /HostedNumbers/AuthorizationDocuments/{Sid} | Fetch a specific AuthorizationDocument. |
| POST | /HostedNumbers/AuthorizationDocuments | Create an AuthorizationDocument for authorizing the hosting of phone number capa |
| GET | /HostedNumbers/AuthorizationDocuments | Retrieve a list of AuthorizationDocuments belonging to the account initiating th |
| GET | /HostedNumbers/AuthorizationDocuments/{SigningDocumentSid}/DependentHostedNumberOrders | Retrieve a list of dependent HostedNumberOrders belonging to the AuthorizationDo |
| POST | /HostedNumbers/HostedNumberOrders/{Sid} | Updates a specific HostedNumberOrder. |
| GET | /HostedNumbers/HostedNumberOrders/{Sid} | Fetch a specific HostedNumberOrder. |
| DELETE | /HostedNumbers/HostedNumberOrders/{Sid} | Cancel the HostedNumberOrder (only available when the status is in `received`). |

## Key resources

- **PreviewHostedNumbersAuthorizationDocument** — Operations related to PreviewHostedNumbersAuthorizationDocument
- **PreviewHostedNumbersDependentHostedNumberOrder** — Operations related to PreviewHostedNumbersDependentHostedNumberOrder
- **PreviewHostedNumbersHostedNumberOrder** — Operations related to PreviewHostedNumbersHostedNumberOrder

## Why Jentic

- **Setup:** Wiring Twilio Preview by hand means setting up HTTP basic auth with your account SID and auth token against the preview.twilio.com host and handling retries yourself. Through Jentic you install once, import Twilio Preview from the API Directory, store the account SID and auth token once, and your agent calls it.
- **Permission scoping:** Twilio Preview puts the resource Sid in the URL path (/HostedNumbers/AuthorizationDocuments/{Sid}), so a rule can pin your agent to one authorization document or hosted number order. You choose the operations it may call, so destructive ones like deleting a hosted number order are not included unless you add them.
- **Credential handling:** Your Twilio account SID and auth token are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'update an authorization document' or 'list hosted number orders', and Jentic returns the matching Twilio Preview operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the Twilio - Preview use?

The Twilio - Preview uses HTTP Basic authentication with username and password. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I updates a specific authorizationdocument. with the Twilio - Preview?

Yes. Use the POST /HostedNumbers/AuthorizationDocuments/{Sid} endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Twilio - Preview?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I updates a specific authorizationdocument. through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'updates a specific authorizationdocument.'. Jentic returns the matching Twilio - Preview operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Twilio - Preview have?

The Twilio - Preview exposes 34 endpoints covering previewhostednumbersauthorizationdocument, previewhostednumbersdependenthostednumberorder, previewhostednumbershostednumberorder operations.

### Can I limit what my agent is allowed to do with the Twilio Preview API?

Yes. Because you run Jentic One yourself, your own rules decide which Twilio Preview operations and credentials the agent may use. Twilio Preview puts the resource Sid in the URL path, such as /HostedNumbers/AuthorizationDocuments/{Sid}, so you can pin the agent to a single authorization document or hosted number order. You also choose which operations it may call, so a destructive request like canceling a hosted number order stays out of reach unless you add it.