canonical: https://jentic.com/apis/urlbox.com/urlbox

# Urlbox API

Urlbox generates high-quality screenshots, PDFs, videos, metadata, and HTML from website URLs and HTML content. The API exposes 3 endpoints secured with bearer authentication.

## For AI agents

Programmatically create a render synchronously, create a render asynchronously. Covers 3 operations with bearer authentication.

## Scope

Does not handle payments, communications, or crm - use for media and content only.

## Capabilities

- Create a render synchronously
- Check the status of a render
- Integrate Urlbox API into automated workflows
- Query and filter Urlbox API records by parameters
- Monitor Urlbox API operational status and events

## Use cases

### Media and Content Operations

Use the Urlbox API to perform media operations programmatically. The API provides 3 endpoints covering core functionality including create a render synchronously, create a render asynchronously, check the status of a render.

Example prompt: Call POST /v1/render/sync to create a render synchronously

### Automated Renders Management

Automate renders operations by combining multiple Urlbox API endpoints. Agents can create a render asynchronously and then check the status of a render in a single workflow.

Example prompt: Call POST /v1/render/async to create a render asynchronously, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Urlbox API 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 bearer tokens manually.

Example prompt: Search Jentic for 'create a render synchronously', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /v1/render/sync | Create a render synchronously |
| POST | /v1/render/async | Create a render asynchronously |
| GET | /v1/render/{renderId} | Check the status of a render |

## Key resources

- **Renders** — Operations related to Renders

## Why Jentic

- **Setup:** Wiring the Urlbox API by hand means attaching its bearer token, choosing between synchronous and asynchronous render calls, and polling for a render id yourself. Through Jentic you install once, import Urlbox from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Urlbox drives its renders through request bodies, with only the render id in the path for lookups, so limit the agent to the operations it needs, such as a synchronous render and fetching a render by id. You choose that operation set, so asynchronous renders are not included unless you add them.
- **Credential handling:** Your Urlbox token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'render a web page as an image synchronously' or 'fetch a render by id', and Jentic returns the matching Urlbox operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Cloudinary** — Alternative media API
- **Mux** — Alternative media API

## FAQ

### What authentication does the Urlbox API use?

The Urlbox API uses a Bearer token in the Authorization header. 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 create a render synchronously with the Urlbox API?

Yes. Use the POST /v1/render/sync endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Urlbox API?

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 create a render synchronously through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'create a render synchronously'. Jentic returns the matching Urlbox API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Urlbox API have?

The Urlbox API exposes 3 endpoints covering renders operations.

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

Yes. Because Jentic One is self-hosted by you, your own rules decide which Urlbox operations and credentials the agent may use. Urlbox drives its renders through request bodies with only the render id in the path for lookups, so you can grant the agent just the operations it needs, such as creating a synchronous render and fetching a render by id, while leaving asynchronous renders out of its allowed set. The stored token is injected only when the agent calls an operation you have permitted.