Assets

List a site's uploaded assets

Lists the files uploaded under assets/, sorted by key within a page, one page at a time (up to 1,000 per page). Follow nextCursor until it is null. This is not the list of pages — use the content endpoints for those. Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish.

get/api/v1/sites/{slug}/assets

Request

  • Base URL: https://api.dotsy.ai
  • URL: https://api.dotsy.ai/api/v1/sites/{slug}/assets
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

slugstring required
Example:acme-studio

Site slug or site id (UUID). An old slug answers 301/308 and a site id 307 to the canonical slug path.

Query parameters

limitinteger

Page size, 1–1,000. Defaults to 1,000; larger values are capped.

cursorstring

Opaque cursor from the previous page's nextCursor. Pass it back unchanged.

Response

One page of assets.

nextCursorstring nullable required

Pass as cursor for the next page. Null on the last page.

Example response

{
  "assets": [
    {
      "key": "photos/hero.webp",
      "contentType": "image/webp",
      "originalKey": "photos/hero.jpg"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.