Skip to main content
GET
/
assets
/
{id}
/
versions
List asset versions
curl --request GET \
  --url https://api.posta.co/assets/{id}/versions \
  --header 'X-Api-Key: <api-key>'
{
  "items": [
    {
      "id": "astv_2jyk1xYhW4n0vVfHirU5eJeXsbw",
      "status": "draft",
      "notes": "Minor changes to the footer.",
      "content": {
        "source": "inline",
        "type": "text/html",
        "content": "<html><body>Hello {{firstName}}</body></html>"
      },
      "variableDefinitions": [
        {
          "name": "name",
          "behavior": "required",
          "allowEmpty": false
        }
      ],
      "contentType": "text/html",
      "contentLength": 100,
      "contentUrl": "https://api.posta.co/assets/astv_2jyk1xYhW4n0vVfHirU5eJeXsbw/content",
      "publish": false,
      "createdAt": "2023-06-07T12:34:56Z",
      "modifiedAt": "2023-06-07T12:34:56Z"
    }
  ],
  "nextToken": "<string>"
}
Results are ordered from newest to oldest.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
string
required

The unique identifier of the asset. Format: 'ast_' followed by alphanumeric characters.

Query Parameters

​
includeArchived
boolean

Include archived versions in the results. Default is false.

​
pageSize
integer

The number of items to return per page. The maximum pageSize is 100 items.

​
nextToken
string

A cursor for the next page of results.

Response

The request has succeeded.

​
items
object[]
required

Array of items for the current page.

​
nextToken
string

A cursor for the next page of results.

Last modified on December 23, 2025