canonical: https://jentic.com/apis/placid.app/placid

# Placid App Placid API

API for generating images, videos, and PDFs from templates with dynamic content. The API exposes 15 endpoints secured with bearer authentication.

## For AI agents

Programmatically create a new image, retrieve an image by id. Covers 15 operations with bearer authentication.

## Scope

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

## Capabilities

- Create a new image
- Retrieve an image by ID
- Delete an image by ID

## Use cases

### Media and Content Operations

Use the Placid API to perform media operations programmatically. The API provides 15 endpoints covering core functionality including create a new image, retrieve an image by id, delete an image by id.

Example prompt: Call POST /images to create a new image

### Automated Images Management

Automate images operations by combining multiple Placid API endpoints. Agents can retrieve an image by id and then delete an image by id in a single workflow.

Example prompt: Call GET /images/{id} to retrieve an image by id, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Placid 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 new image', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /images | Create a new image |
| GET | /images/{id} | Retrieve an image by ID |
| DELETE | /images/{id} | Delete an image by ID |
| POST | /videos | Create a new video |
| GET | /videos/{id} | Retrieve a video by ID |
| DELETE | /videos/{id} | Delete a video by ID |
| POST | /pdfs | Create a new PDF |
| POST | /pdfs/merge | Merge multiple PDFs into one |

## Key resources

- **Images** — Operations related to Images
- **PDFs** — Operations related to PDFs
- **Templates** — Operations related to Templates
- **Videos** — Operations related to Videos

## Why Jentic

- **Setup:** Wiring Placid by hand means learning its bearer auth and building the request and polling plumbing for its image, video and PDF generation endpoints yourself. Through Jentic you install once, import Placid from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Placid puts the resource id in the URL path (/images/{id}, /videos/{id}), so a rule can pin your agent to one generated asset: it can create and read that asset and nothing else. You choose the operations it may call, so destructive ones like deleting an image or video are not included unless you add them.
- **Credential handling:** Your Placid 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 'create a new image' or 'merge PDFs', and Jentic returns the matching Placid 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 Placid API use?

The Placid 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 new image with the Placid API?

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

### What are the rate limits for the Placid 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 new image through Jentic?

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

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

The Placid API exposes 15 endpoints covering images, pdfs, templates operations.

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

Yes. Because you run Jentic One yourself, your own rules decide which Placid operations and credentials the agent may use. Since Placid puts the resource id in the URL path, such as /images/{id} and /videos/{id}, you can pin the agent to a single generated asset so it only creates and reads that asset. You choose the operations it may call, so destructive ones like deleting an image or video with DELETE /images/{id} or DELETE /videos/{id} are excluded unless you add them.