Skip to main content
GET /api/v2/buyer/campaigns/:id/workspace Returns the CampaignWorkspace projection: a presentation-ready view over Get campaign that assembles phase, handling, budget, source, media buys, and per-seller creative approval status into one response. It’s built for a single-call dashboard read — the campaign drill-in widget uses it — not a substitute for get_campaign, which remains the source of the raw campaign resource.

​
Request

​
Parameters

​
Response

Returns the CampaignWorkspace for the campaign — the base campaign fields plus mediaBuys[] and creatives[]. See the getCampaignWorkspace schema in the API reference for the authoritative response shape and field types; the key fields are summarized in Sections below. Conditional fields (for example source, and each media buy’s attentionNote) appear only when they apply to the campaign. CampaignWorkspace also declares readiness, spend, pacing, outcome, and recentActivity top-level fields, and dimensions/previewUrl/placements on each creative — but this endpoint does not hydrate any of them today. They are simply absent from the response, not falsy or zero.

​
Sections

creatives[].readiness is the worst status across that creative’s sellerReviews[] — rejected outranks in_review/missing, which outranks ready. A creative with no seller reviews yet omits readiness entirely rather than defaulting to ready. mediaBuys[] and creatives[] are drawn directly from the campaign’s own media buys, so this is a single-fetch read — no extra round-trip per media buy or creative.

​
Access

A directed-mode campaign requires the directed-campaigns rollout to be enabled for the account, same as Get campaign. When it isn’t, the request fails with 403 FEATURE_NOT_ENABLED rather than returning a partial workspace.

​
Errors

  • 404 NOT_FOUND — no campaign with this ID is visible to the authenticated account.
  • 403 FEATURE_NOT_ENABLED — the campaign is directed-mode and the directed-campaigns rollout is not enabled for this account.
See Errors for the full error contract.

Get campaign

The full campaign resource this projects from

List campaigns

Compact summaries across campaigns

Get media buy status

Poll live ADCP status

Campaign overview

Fields, lifecycle, and concepts