{
"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"
}Asset Version object
Represents a specific version of an Asset, containing the actual content and metadata. Asset Versions are the core entities for version control, compliance tracking, and content management in Posta.
Key aspects:
- Content: Can be HTML templates (with variable support), images, fonts, or documents (e.g., PDFs).
- Status: Determines the overall status of the parent Asset (
draft,published,archived, ordeleted). - Version Control: Allows tracking changes and maintaining multiple iterations of an Asset.
- Compliance: Facilitates auditing and regulatory compliance through versioning.
HTML templates can use variables for dynamic content. Images and fonts can be referenced as variables within HTML templates. Documents (like PDFs) are static and used for rendering documents without dynamic components.
Represents the status of an Asset Version.
-
draft: An Asset Version that is being worked on and can be modified. This is the initial state for new Asset Version and cloned Asset Versions. -
published: An Asset Version that is finalized and available for use. Published Asset Versions cannot be edited. -
archived: An Asset Version unavailable for new uses but may still be accessible for historical purposes. It can be republished if needed. -
deleted: An Asset Version that has been deleted from the system. This is a terminal state.
State transitions:
- Draft Asset Versions can be published, archived, or deleted.
- Published Asset Versions can only be archived or deleted.
- Archived Asset Versions can be republished (becoming published) or deleted.
- Deleted is a terminal state with no further transitions.
Notes:
- Only one Asset Version can be in the published state at a time for a given Asset.
- Publishing a new Asset Versions will automatically archive the previously published one, if there was one.
- Cloning any non-deleted Asset Versions will create a new one in draft state.
- Deletion is permanent and should be used with caution.
draft, published, archived, deleted "draft"
Optional notes or comments about this specific Asset Version. Useful for tracking changes or providing context.
255"Initial version."
List of variables defined for this Asset Version. Used for content personalization in HTML templates.
Note: When using Assets with Variables with our Letter API, always review the variableHandling option on the Letter. If validationScope is set to none in the request, the defined variables and their behavior will not be evaluated at all. See further information on the Letter object.
128Show child attributes
Show child attributes