---
title: "Notion Card Attach Artifact"
method: POST
path: "/api/notion/card/attach-artifact"
tags: ["notion"]
---

# Notion Card Attach Artifact

`POST /api/notion/card/attach-artifact`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/notion/card/attach-artifact`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

Attach a Flage artifact to a card.

Deliberate deviation from a byte upload: artifact bytes live behind the
object store with per-entry logical paths, so the durable, always-valid
representation is the artifact's Flage URL. The op appends a bookmark
block pointing at it (C-4 allows this fallback; a native file upload can
replace it without changing the op surface).

## Request body

- CardAttachArtifactPayload
  - `artifact_id` string, required
  - `idempotency_key` string, required
  - `page_id` string, required

## Response `200`

Successful Response

- NotionArtifactAttachmentResponse
  - `artifact_id` string, required
  - `artifact_url` string, required
  - `attached` boolean, required
  - `binding_id` string, required
  - `mode` 'link', required
  - `replayed` boolean, required
  - `result` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)