---
title: "POST /renders"
method: POST
path: "/renders"
---

# POST /renders

`POST /renders`

## Request

- Base URL: `https://api.farpy.com/v1`
- URL: `https://api.farpy.com/v1/renders`
- Auth: HTTP bearer

Upload idempotency headers are optional as a group. If any one of the nine headers is supplied, all nine must be supplied together.

## Headers

- `Idempotency-Key` string
- `X-Farpy-Request-Fingerprint` string
- `X-Farpy-Filename` string
- `X-Farpy-Renderer` string
- `X-Farpy-Frame-Start` string
- `X-Farpy-Frame-End` string
- `X-Farpy-Frame-Count` string
- `X-Farpy-Size-Bytes` string
- `X-Farpy-Content-SHA256` string

## Response `200`

Render job created

- RenderObject
  - `webhook_configured` boolean: True when terminal render webhooks are configured.

## Other responses

- `401`: Invalid API key
- `415`: Multipart form data required

---

[API](https://skmtc.dev/farpy/apis/farpy-public-api.md) · [All operations](https://skmtc.dev/farpy/apis/farpy-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farpy/apis/farpy-public-api/revisions/fe4065160cb2?raw)