# Assets

## Attach an asset to a canvas

`$ flora projects:assets attach-asset`

**post** `/projects/{projectId}/assets/{assetId}/attach`

Attaches an existing ready asset to a project canvas as a static media node. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

### Parameters

- `--project-id: string`

  Project identifier

- `--asset-id: string`

  Asset identifier

### Returns

- `ProjectAssetAttachAssetResponse: object { asset_id, canvas_url, node_id, project_id }`

  - `asset_id: string`

    Asset identifier

  - `canvas_url: string`

    Project canvas URL

  - `node_id: string`

    Canvas node identifier

  - `project_id: string`

    Project identifier

### Example

```cli
flora projects:assets attach-asset \
  --api-key 'My API Key' \
  --project-id prj_abc123 \
  --asset-id asset_abc123
```

#### Response

```json
{
  "asset_id": "asset_abc123",
  "canvas_url": "https://example.com",
  "node_id": "node_abc123",
  "project_id": "prj_abc123"
}
```