Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .changeset/fix-versioned-docs-mintignore.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
---

fix: restore versioned docs and repair broken links

Replaced blanket `dist/` in .mintignore with granular ignores so versioned doc
snapshots (2.5.3, 3.0.0-rc.2, etc.) are served by Mintlify again. Fixed 18
broken internal links where list_creative_formats and sync_creatives moved from
media-buy/task-reference/ to creative/task-reference/ in v3. Removed incorrect
Documentation wrapper group from non-default version nav configs.
14 changes: 13 additions & 1 deletion .mintignore
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
dist/
dist/schemas/
dist/db/
dist/index.js
dist/index.js.map
dist/creative-agent/
.addie-repos/
.context/
.changeset/
node_modules/
server/
tests/
scripts/
skills/
static/openapi/
*.test.*
*.spec.*
CHANGELOG.md
2 changes: 1 addition & 1 deletion dist/docs/3.0.0-rc.2/creative/formats.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -782,4 +782,4 @@ This ensures a consistent user experience regardless of what format metadata is
- [Asset Types](/dist/docs/3.0.0-rc.2/creative/asset-types) - Understanding asset specifications
- [Channel Guides](/dist/docs/3.0.0-rc.2/creative/channels/video) - Detailed format documentation by media type
- [Implementing Standard Format Support](/dist/docs/3.0.0-rc.2/media-buy/capability-discovery/implementing-standard-formats) - For sales agents
- [list_creative_formats Task](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) - API reference for format discovery
- [list_creative_formats Task](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) - API reference for format discovery
4 changes: 2 additions & 2 deletions dist/docs/3.0.0-rc.2/creative/private-assets.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ Set presigned URL expiration long enough to cover the full workflow, but no long
| --- | --- |
| [`build_creative`](/dist/docs/3.0.0-rc.2/creative/task-reference/build_creative) only | 1 hour |
| [`build_creative`](/dist/docs/3.0.0-rc.2/creative/task-reference/build_creative) + [`preview_creative`](/dist/docs/3.0.0-rc.2/creative/task-reference/preview_creative) | 2 hours |
| Full pipeline (build, preview, iterate, [`sync_creatives`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/sync_creatives)) | 4 hours |
| Full pipeline (build, preview, iterate, [`sync_creatives`](/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives)) | 4 hours |

<Warning>
If a presigned URL expires mid-workflow, the creative agent will receive an HTTP error when fetching the asset. The buyer agent must generate a new presigned URL and resubmit the request.
Expand Down Expand Up @@ -206,4 +206,4 @@ Presigned URLs avoid this by encoding authorization into the URL itself:
- [Creative manifests](/dist/docs/3.0.0-rc.2/creative/creative-manifests) — manifest structure and asset references
- [Asset types](/dist/docs/3.0.0-rc.2/creative/asset-types) — requirements for each asset type
- [`build_creative`](/dist/docs/3.0.0-rc.2/creative/task-reference/build_creative) — generating creatives from manifests
- [`sync_creatives`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/sync_creatives) — syncing creatives to a media buy
- [`sync_creatives`](/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives) — syncing creatives to a media buy
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Any agent implementing the Creative Protocol can serve `list_creative_formats`.

**Sales agents implementing both protocols** — return their own self-hosted format definitions alongside referenced formats. See [Creative capabilities on sales agents](/dist/docs/3.0.0-rc.2/creative/sales-agent-creative-capabilities).

See [list_creative_formats (Sales Agent)](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) for sales agent-specific behavior.
See [list_creative_formats (Sales Agent)](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) for sales agent-specific behavior.

## Request Parameters

Expand Down
2 changes: 1 addition & 1 deletion dist/docs/3.0.0-rc.2/learning/specialist/creative.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ Passing earns the **AdCP specialist — Creative** credential.
<Card title="preview_creative" icon="eye" href="/dist/docs/3.0.0-rc.2/creative/task-reference/preview_creative">
Preview creatives before deployment.
</Card>
<Card title="sync_creatives" icon="rotate" href="/dist/docs/3.0.0-rc.2/media-buy/task-reference/sync_creatives">
<Card title="sync_creatives" icon="rotate" href="/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives">
Synchronize creative assets with publisher platforms.
</Card>
</CardGroup>
Expand Down
2 changes: 1 addition & 1 deletion dist/docs/3.0.0-rc.2/learning/tracks/buyer.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ How creative assets flow through AdCP: `build_creative`, `preview_creative`, `sy
<Card title="preview_creative task" icon="eye" href="/dist/docs/3.0.0-rc.2/creative/task-reference/preview_creative">
Previewing creatives before deployment.
</Card>
<Card title="sync_creatives task" icon="rotate" href="/dist/docs/3.0.0-rc.2/media-buy/task-reference/sync_creatives">
<Card title="sync_creatives task" icon="rotate" href="/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives">
Synchronizing creative assets with publisher platforms.
</Card>
<Card title="Generative creative" icon="wand-magic-sparkles" href="/dist/docs/3.0.0-rc.2/creative/generative-creative">
Expand Down
2 changes: 1 addition & 1 deletion dist/docs/3.0.0-rc.2/learning/tracks/publisher.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ Deep dive on `list_creative_formats` and how buyer agents discover what your inv
<Card title="Example briefs" icon="clipboard-list" href="/dist/docs/3.0.0-rc.2/media-buy/product-discovery/example-briefs">
Real examples of product discovery queries from buyer agents.
</Card>
<Card title="list_creative_formats task" icon="palette" href="/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats">
<Card title="list_creative_formats task" icon="palette" href="/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats">
How creative format specifications work — dimensions, file types, render requirements.
</Card>
<Card title="Creative formats" icon="image" href="/dist/docs/3.0.0-rc.2/creative/formats">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -487,4 +487,4 @@ The reference creative agent maintains format versions and compatibility:
- [Creative Protocol Overview](/dist/docs/3.0.0-rc.2/creative) - How formats, manifests, and agents work together
- [Creative Formats](/dist/docs/3.0.0-rc.2/creative/formats) - Understanding format specifications and discovery
- [Channel Guides](/dist/docs/3.0.0-rc.2/creative/channels/video) - Detailed format documentation by media type
- [list_creative_formats Task](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) - API reference for format discovery
- [list_creative_formats Task](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) - API reference for format discovery
4 changes: 2 additions & 2 deletions dist/docs/3.0.0-rc.2/media-buy/capability-discovery/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,15 +41,15 @@ These capability discovery tasks provide the reference data needed for effective
### [`get_adcp_capabilities`](/dist/docs/3.0.0-rc.2/protocol/get_adcp_capabilities)
The primary capability discovery task. Returns protocol versions, supported features, portfolio information, and governance capabilities in a single call. Use this as your first interaction with any AdCP agent.

### [`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats)
### [`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats)
Discover all supported creative formats with detailed specifications including dimensions, file types, duration limits, and technical requirements.

## Integration Pattern

Capability discovery typically happens early in your AdCP workflow:

1. **Discover Capabilities**: Call [`get_adcp_capabilities`](/dist/docs/3.0.0-rc.2/protocol/get_adcp_capabilities) to learn what the agent supports
2. **Understand Formats**: Call [`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) to learn supported creative types
2. **Understand Formats**: Call [`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) to learn supported creative types
3. **Validate Authorization**: Check the `media_buy.portfolio` from capabilities, then verify via publisher `adagents.json`
4. **Discover Products**: Search for advertising inventory with [`get_products`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/get_products)
5. **Plan Creatives**: Match discovered products to available formats for production planning
Expand Down
2 changes: 1 addition & 1 deletion dist/docs/3.0.0-rc.2/media-buy/creatives/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -173,7 +173,7 @@ Creative operations have varying response times:

- **[`sync_creatives`](/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives)** - Bulk creative management with upsert semantics
- **[`list_creatives`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creatives)** - Advanced creative library querying and filtering
- **[`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats)** - Understanding format requirements
- **[`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats)** - Understanding format requirements
- **[Brand identity](/dist/docs/3.0.0-rc.2/brand-protocol/brand-json)** - Brand identity and asset management
- **[Creative Formats](/dist/docs/3.0.0-rc.2/creative/formats)** - Understanding format specifications and discovery
- **[Creative Channel Guides](/dist/docs/3.0.0-rc.2/creative/channels/video)** - Format examples across video, display, audio, DOOH, and carousels
Expand Down
4 changes: 2 additions & 2 deletions dist/docs/3.0.0-rc.2/media-buy/product-discovery/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ For catalog-driven campaigns (retail media, job boards, travel), pass a `catalog
Product discovery works hand-in-hand with creative planning:

1. **Products return format IDs** for required creative specifications
2. **Use [`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats)** to get detailed format requirements
2. **Use [`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats)** to get detailed format requirements
3. **Plan creative production** based on discovered format needs

## Brief Examples & Patterns
Expand Down Expand Up @@ -110,7 +110,7 @@ Explore comprehensive examples in [Example Briefs](/dist/docs/3.0.0-rc.2/media-b

Product discovery operations:
- **[`get_products`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/get_products)**: ~60 seconds (AI processing)
- **[`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats)**: ~1 second (database lookup)
- **[`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats)**: ~1 second (database lookup)

## Next Steps

Expand Down
2 changes: 1 addition & 1 deletion dist/docs/3.0.0-rc.2/media-buy/specification.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,7 @@ Each `get_products` request with `buying_mode: "refine"` is self-contained — s

**Schema**: [`media-buy/list-creative-formats-request.json`](https://adcontextprotocol.org/schemas/v2/media-buy/list-creative-formats-request.json) / [`media-buy/list-creative-formats-response.json`](https://adcontextprotocol.org/schemas/v2/media-buy/list-creative-formats-response.json)

**Reference**: [`list_creative_formats` task](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats)
**Reference**: [`list_creative_formats` task](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats)

Discover creative format requirements and specifications.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1397,7 +1397,7 @@ After discovering products:

1. **Review Options**: Compare products, pricing, and targeting capabilities
2. **Create Media Buy**: Use [`create_media_buy`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/create_media_buy) to execute campaign
3. **Prepare Creatives**: Use [`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) to see format requirements
3. **Prepare Creatives**: Use [`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) to see format requirements
4. **Upload Assets**: Use [`sync_creatives`](/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives) to provide creative assets

## Learn More
Expand Down
4 changes: 2 additions & 2 deletions dist/docs/3.0.0-rc.2/media-buy/task-reference/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Start here to understand what's available and plan your campaign.

- **[`get_adcp_capabilities`](/dist/docs/3.0.0-rc.2/protocol/get_adcp_capabilities)** - Discover agent capabilities, portfolio, and supported features (protocol-level task)
- **[`get_products`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/get_products)** - The core discovery task using natural language briefs
- **[`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats)** - Understand creative requirements
- **[`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats)** - Understand creative requirements

### Media Buy Management
Create and manage your advertising campaigns.
Expand Down Expand Up @@ -148,7 +148,7 @@ Long-running tasks provide:
1. **Discover Capabilities**: Use [`get_adcp_capabilities`](/dist/docs/3.0.0-rc.2/protocol/get_adcp_capabilities) to understand what the agent supports
2. **Find Inventory**: Use [`get_products`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/get_products) to find relevant inventory
3. **Refine Products**: Re-call [`get_products`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/get_products) with `buying_mode: "refine"` to iterate on budgets, pricing, and targeting
4. **Understand Formats**: Check [`list_creative_formats`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) for requirements
4. **Understand Formats**: Check [`list_creative_formats`](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) for requirements
5. **Sync Catalogs**: Use [`sync_catalogs`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/sync_catalogs) to push product feeds to the account
6. **Upload Creatives**: Use [`sync_creatives`](/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives) for asset management
7. **Create Campaign**: Use [`create_media_buy`](/dist/docs/3.0.0-rc.2/media-buy/task-reference/create_media_buy) with selected products
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -257,4 +257,4 @@ Configure `push_notification_config` on the request to receive webhook notificat
- [Catalogs](/dist/docs/3.0.0-rc.2/creative/catalogs) — Complete documentation on catalog types, sourcing, and format requirements
- [Account state](/dist/docs/3.0.0-rc.2/building/integration/account-state) — How catalogs fit into the account setup sequence
- [sync_creatives](/dist/docs/3.0.0-rc.2/creative/task-reference/sync_creatives) — Submit creatives that reference synced catalogs
- [list_creative_formats](/dist/docs/3.0.0-rc.2/media-buy/task-reference/list_creative_formats) — Discover format catalog requirements
- [list_creative_formats](/dist/docs/3.0.0-rc.2/creative/task-reference/list_creative_formats) — Discover format catalog requirements
Loading
Loading