---
title: "Add Asset To Page"
method: POST
path: "/v1/assets/{id}/add-to-page"
tags: ["Assets"]
---

# Add Asset To Page

`POST /v1/assets/{id}/add-to-page`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/assets/{id}/add-to-page`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Instantiate an asset's widgets onto a report page (connectivity-aware: unconnected sources land as demo).

## Path parameters

- `id` string, required

## Request body

- AddAssetToPageRequest
  - `source_id` string, required: Report id to add the asset widgets to
  - `page_id` string, required: Page id to place the widgets on
  - `client_id` string, nullable: Client id the report belongs to — drives the connectivity → demo decision. Falls back to the report's client when omitted.

## Response `201`

Widgets instantiated

- AddAssetToPageResponse
  - `success` true, required
  - `data` object, required
    - `inserted_count` number, required
    - `widget_ids` string[], required

## Other responses

- `404`: Asset or report not found

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)