Add a template by URL, or get a presigned upload URL
Adds a blank form to your organization's template library.
The two request shapes match [POST /v1/files](https://docs.cloudraker.com/api/cloud-raker-api/files/create-file):
- `{ url, name? }` — fetched over http(s) for you.
- `{ name, mimeType }` — returns `uploadUrl` plus `uploadExpiresAt` (15 minutes); `PUT` the bytes with a `Content-Type` equal to the `mimeType` you sent.
```json
{ "url": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "name": "w9.pdf" }
```
<Note>
Templates are deliberately never parsed or indexed — they are documents to be filled, not read. That is why a template reaches `ready` as soon as its bytes land, with no `processing` stage. Pass one to [fill](https://docs.cloudraker.com/api/cloud-raker-api/capabilities/fill) as `template: { "id": "…" }`.
</Note>
**Learn more:** [Form filling guide](https://docs.cloudraker.com/capabilities/fill)
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
OR
Response
The template.
object
id
name
mimeType
status
createdAt
kind
downloadUrl
uploadUrl
uploadExpiresAt
Errors
422
Unprocessable Entity Error
429
Too Many Requests Error