List assets
Ready assets, newest first by default. `folder` is a folder’s id (what’s directly in it), `top` (the top level) or `all`; without it, a search looks everywhere and a plain list shows the top level. Search matches the name or filename.
Ready assets, newest first by default. folder is a folder’s id (what’s directly in it), top (the top level) or all; without it, a search looks everywhere and a plain list shows the top level. Search matches the name or filename.
apiKey readAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
page?integerStarts at 1
1 <= value1pageSize?numberOne of 10, 25, 50, 100
25q?stringSearch
1 <= length <= 200kind?string"image""font"folder?|sort?stringOne of name, createdAt, bytes; prefix with - for descending
"-createdAt""name""-name""createdAt""-createdAt""bytes""-bytes"OK
application/json- response
items*array<>total*integerpage*integerpageSize*integercurl -X GET 'https://api.postforge.dev/v1/assets'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "folder": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" }, "kind": "image", "contentType": "image/png", "filename": "string", "bytes": 0, "width": 0, "height": 0, "status": "uploading", "url": "http://example.com", "uploadedBy": { "type": "user", "id": "string", "name": "string" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "archivedAt": "2019-08-24T14:15:22Z" } ], "total": 0, "page": 0, "pageSize": 0}Restore an archived custom field POST
Previous Page
Create an asset POST
Starts an asset: send its bytes next to `upload` (`PUT /v1/assets/{id}/content`). Images: PNG, JPEG or GIF up to 20 MB (not WebP, SVG or AVIF: classic Outlook shows nothing for them); fonts: WOFF2, WOFF, TTF or OTF up to 5 MB. 422 `asset_too_large` past its type's size. An asset whose bytes never arrive is removed after a day.