save_to_project
Save generated components, pages, or design system changes to a Symbols project, creating a new version.
Instructions
Save components, pages, or design system data to a Symbols project.
This applies changes to the project and creates a new version. Use after generate_component/generate_page to persist the output.
The changes parameter is a JSON string with the data to merge into the project. Structure mirrors the project data format:
{
"components": {
"Header": {
"extends": "Flex",
"props": { "flow": "x", "gap": "B", "padding": "A B" },
"Logo": { "extends": "Icon", "props": { "name": "logo" } },
"Nav": { "extends": "Flex", "gap": "A" }
}
},
"pages": {
"home": {
"extends": "Page",
"Header": {},
"Hero": { "extends": "Flex" }
}
},
"designSystem": { ... },
"state": { ... },
"functions": { ... }
}Only include the sections you want to update — omitted sections are left unchanged.
Args: project: Project key (pr_xxxx) or project ID. changes: JSON string with project data to save (components, pages, designSystem, state, functions). token: JWT access token from login. api_key: API key (sk_live_...) from project integration settings. message: Version commit message describing the changes. branch: Branch to save to (default: "main").
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | ||
| branch | No | main | |
| api_key | No | ||
| changes | Yes | ||
| message | No | ||
| project | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |