# Placid

> Generate branded images and PDFs from your Placid templates: fill in the layers and get back a ready-to-use file.

App · Images & Design · 4 actions. Web page: https://docs.lodol.com/docs/integrations/placid

## Actions

### Create image

Generate an image from a Placid template, filling in its layers. Returns the image URL once it's ready.

**Inputs**

- Template (`template_uuid`, text, required): The Placid template to generate from.
- Layers (`layers`, object, required): The content for each of the template's layers. Text layers take text; picture layers take an image URL. Leave a layer blank to keep the template's default.

**Outputs**

- `id` (number): The image's ID (use it to poll).
- `imageUrl` (text): URL of the finished image, or empty while queued.
- `pollingUrl` (text): URL to check the image's status.
- `status` (text): 'queued', 'finished', or 'error'.

**Example output**

```json
{
  "id": 1,
  "imageUrl": "https://placid.app/u/generated-image.png",
  "pollingUrl": "https://api.placid.app/api/rest/images/1",
  "status": "finished"
}
```

### Create PDF

Generate a PDF from a Placid template, filling in its layers. PDFs are queued; use 'Get PDF' to fetch the finished file.

**Inputs**

- Template (`template_uuid`, text, required): The Placid template to generate from.
- Layers (`layers`, object, required): The content for each of the template's layers. Text layers take text; picture layers take an image URL. Leave a layer blank to keep the template's default.

**Outputs**

- `id` (number): The PDF's ID (use it to poll).
- `pdfUrl` (text): URL of the finished PDF, or empty while queued.
- `pollingUrl` (text): URL to check the PDF's status.
- `status` (text): 'queued', 'finished', or 'error'.

**Example output**

```json
{
  "id": 1,
  "pdfUrl": "",
  "pollingUrl": "https://api.placid.app/api/rest/pdfs/1",
  "status": "queued"
}
```

### Get image

Check a previously created image and get its URL once finished.

**Inputs**

- Image ID (`image_id`, text, required): The ID returned by 'Create image'.

**Outputs**

- `id` (number): The image's ID (use it to poll).
- `imageUrl` (text): URL of the finished image, or empty while queued.
- `pollingUrl` (text): URL to check the image's status.
- `status` (text): 'queued', 'finished', or 'error'.

**Example output**

```json
{
  "id": 1,
  "imageUrl": "https://placid.app/u/generated-image.png",
  "pollingUrl": "https://api.placid.app/api/rest/images/1",
  "status": "finished"
}
```

### Get PDF

Check a previously created PDF and get its URL once finished.

**Inputs**

- PDF ID (`pdf_id`, text, required): The ID returned by 'Create PDF'.

**Outputs**

- `id` (number): The PDF's ID (use it to poll).
- `pdfUrl` (text): URL of the finished PDF, or empty while queued.
- `pollingUrl` (text): URL to check the PDF's status.
- `status` (text): 'queued', 'finished', or 'error'.

**Example output**

```json
{
  "id": 1,
  "pdfUrl": "",
  "pollingUrl": "https://api.placid.app/api/rest/pdfs/1",
  "status": "queued"
}
```