# Canvas API Specs

> Control canvas background color and background image via the API

- **URL**: https://orshot.com/docs/orshot-studio/api-specs

---

In addition to the dynamic parameters you set on individual elements, every template has two canvas-level properties you can override via the API.

## Canvas Parameters

| Parameter               | Type     | Description                                                              |
| :---------------------- | :------- | :----------------------------------------------------------------------- |
| `canvasBackgroundColor` | `string` | Background color for the canvas. Supports HEX, RGBA, and linear-gradient |
| `canvasBackgroundImage` | `string` | Background image URL (must be publicly accessible)                       |

## Example```json
{
  "templateId": "your-template-id",
  "modifications": {
    "title": "Hello World",
    "canvasBackgroundColor": "linear-gradient(135deg, #667eea 0%, #764ba2 100%)",
    "canvasBackgroundImage": "https://example.com/bg-pattern.png"
  },
  "response": {
    "format": "png",
    "type": "url"
  }
}
```