Launch groups
Launches, ad sets and ads with override-only inheritance.
List launch groups
Launch groups, the most recently changed first (a change to any of their campaigns counts). A launch group holds a launch's campaigns: one per platform, ad account, or objective or budget setup, each a launch of its own (children), with a status across them. Most launches have one. Guests see the groups with a campaign shared with them, and only those campaigns. Keyset-paged: pass nextAfter as after.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Optional | Part of the name or description. |
archived | string | Optional | true lists archived launch groups instead. |
multiPlatform | string | Optional | true: only those with two or more campaigns. |
after | string | Optional | Cursor: nextAfter from the previous page. |
limit | string | Optional | Page size (1-200, default 50). |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
items- This page.
items[].archivedAt- Archived (every campaign is).
items[].campaignCount- Listed campaigns.
items[].canDelete- Deleting is allowed: every campaign of it (archived ones too) is a draft never published. Anything else is archived.
items[].children- Its campaigns in the order they were added: the active ones (the archived ones of an archived group), on platforms the workspace may use.
items[].children[].adAccountId- Its ad account.
items[].children[].adAccountName- The ad account's name, as synced.
items[].children[].adCount- Ads.
items[].children[].adSetCount- Ad sets.
items[].children[].archivedAt- Archived.
items[].children[].campaignId- The existing campaign it publishes into.
items[].children[].canDelete- Deleting is allowed: a draft never published, nothing of it at its platform. Anything else is archived.
items[].children[].createdAt- Created.
items[].children[].currency- The ad account's currency (ISO 4217).
items[].children[].groupId- Its launch group.
items[].children[].id- The campaign (a launch ID).
items[].children[].label- Its own name in the launch group: a person's, else the launch group's name, with no suffix.
items[].children[].name- Its full name (what its campaign at the platform is named after).
items[].children[].newCampaignName- The new campaign's name.
items[].children[].platform- Its platform.
items[].children[].publishedAt- First published.
items[].children[].scheduleAt- Start.
items[].children[].sharedWithGuests- Shared with guests for review.
items[].children[].status- Status.One of
draft,publishing,published,failed items[].children[].updatedAt- Last change.
items[].children[].version- Version.
items[].createdAt- Created.
items[].description- Description.
items[].id- The launch group.
items[].name- Its own name.
items[].ownerId- The member who owns it.
items[].publishedCount- Listed campaigns that published.
items[].status- Across its listed campaigns: any publishing, else any failed, else all published, else some, else draft.One of
draft,publishing,published,some_published,failed items[].updatedAt- Last change to the group itself.
items[].version- Increments on every change; send as
expectedVersion. nextAfter- Cursor for the next page; null at the end.
curl "$PLUTO_API/launch-groups" \
-H "Authorization: Bearer $PLUTO_KEY"Create a launch group
A launch with one empty campaign per entry in children (default: one where POST /launches would start it; a 422 names the choice when there is one). A campaign is for another platform, ad account, or objective or budget setup; versions by audience, country, placement or creative are ad sets in one campaign. Each campaign's full name follows the naming rule: the launch's name while it has one campaign, "{name} {label}" with two or more.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
children- One campaign each.
children[].adAccountId- The ad account there.
children[].label- Its own name in the launch (default: its platform's name when it's the launch's only campaign there, else its objective's, ad account's or both).
children[].platform- A platform from
GET /platforms; a platform this workspace can't use is refused like an unknown one (422). description- Description (up to 10,000 characters).
name- Name (1-120 characters).
ownerId- A workspace member who owns it.
Response
archivedAt- Archived (every campaign is).
campaignCount- Listed campaigns.
canDelete- Deleting is allowed: every campaign of it (archived ones too) is a draft never published. Anything else is archived.
children- Its campaigns in the order they were added: the active ones (the archived ones of an archived group), on platforms the workspace may use.
children[].adAccountId- Its ad account.
children[].adAccountName- The ad account's name, as synced.
children[].adCount- Ads.
children[].adSetCount- Ad sets.
children[].archivedAt- Archived.
children[].campaignId- The existing campaign it publishes into.
children[].canDelete- Deleting is allowed: a draft never published, nothing of it at its platform. Anything else is archived.
children[].createdAt- Created.
children[].currency- The ad account's currency (ISO 4217).
children[].groupId- Its launch group.
children[].id- The campaign (a launch ID).
children[].label- Its own name in the launch group: a person's, else the launch group's name, with no suffix.
children[].name- Its full name (what its campaign at the platform is named after).
children[].newCampaignName- The new campaign's name.
children[].platform- Its platform.
children[].publishedAt- First published.
children[].scheduleAt- Start.
children[].sharedWithGuests- Shared with guests for review.
children[].status- Status.One of
draft,publishing,published,failed children[].updatedAt- Last change.
children[].version- Version.
createdAt- Created.
description- Description.
id- The launch group.
name- Its own name.
ownerId- The member who owns it.
publishedCount- Listed campaigns that published.
status- Across its listed campaigns: any publishing, else any failed, else all published, else some, else draft.One of
draft,publishing,published,some_published,failed updatedAt- Last change to the group itself.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/launch-groups" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 61932ea8-ef9a-425a-b4bd-f47f5803997e" \
-H "Content-Type: application/json" \
-d '{
"children": [
{
"adAccountId": "act_741877585619437",
"label": "Vitamin C Serum, UGC 9x16",
"platform": "422"
}
],
"description": "Two drops every morning for brighter, even skin.",
"name": "Vitamin C Serum, UGC 9x16",
"ownerId": "c7f25ce0-b477-48fc-9b7b-155702ae0ec2"
}'Get a launch group
The launch group with its campaigns (each a launch: GET /launches/{id} has its ad sets and ads).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
archivedAt- Archived (every campaign is).
campaignCount- Listed campaigns.
canDelete- Deleting is allowed: every campaign of it (archived ones too) is a draft never published. Anything else is archived.
children- Its campaigns in the order they were added: the active ones (the archived ones of an archived group), on platforms the workspace may use.
children[].adAccountId- Its ad account.
children[].adAccountName- The ad account's name, as synced.
children[].adCount- Ads.
children[].adSetCount- Ad sets.
children[].archivedAt- Archived.
children[].campaignId- The existing campaign it publishes into.
children[].canDelete- Deleting is allowed: a draft never published, nothing of it at its platform. Anything else is archived.
children[].createdAt- Created.
children[].currency- The ad account's currency (ISO 4217).
children[].groupId- Its launch group.
children[].id- The campaign (a launch ID).
children[].label- Its own name in the launch group: a person's, else the launch group's name, with no suffix.
children[].name- Its full name (what its campaign at the platform is named after).
children[].newCampaignName- The new campaign's name.
children[].platform- Its platform.
children[].publishedAt- First published.
children[].scheduleAt- Start.
children[].sharedWithGuests- Shared with guests for review.
children[].status- Status.One of
draft,publishing,published,failed children[].updatedAt- Last change.
children[].version- Version.
createdAt- Created.
description- Description.
id- The launch group.
name- Its own name.
ownerId- The member who owns it.
publishedCount- Listed campaigns that published.
status- Across its listed campaigns: any publishing, else any failed, else all published, else some, else draft.One of
draft,publishing,published,some_published,failed updatedAt- Last change to the group itself.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9" \
-H "Authorization: Bearer $PLUTO_KEY"Update a launch group
Its own name, description or owner. The campaigns keep their labels; the full names of drafts that never published and still follow the naming rule follow the new name (a published campaign is never renamed by itself).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
description- Description.
expectedVersion- The version you edited; without it the change applies over any other.
name- Name.
ownerId- A workspace member who owns it; null for nobody.
Response
archivedAt- Archived (every campaign is).
campaignCount- Listed campaigns.
canDelete- Deleting is allowed: every campaign of it (archived ones too) is a draft never published. Anything else is archived.
children- Its campaigns in the order they were added: the active ones (the archived ones of an archived group), on platforms the workspace may use.
children[].adAccountId- Its ad account.
children[].adAccountName- The ad account's name, as synced.
children[].adCount- Ads.
children[].adSetCount- Ad sets.
children[].archivedAt- Archived.
children[].campaignId- The existing campaign it publishes into.
children[].canDelete- Deleting is allowed: a draft never published, nothing of it at its platform. Anything else is archived.
children[].createdAt- Created.
children[].currency- The ad account's currency (ISO 4217).
children[].groupId- Its launch group.
children[].id- The campaign (a launch ID).
children[].label- Its own name in the launch group: a person's, else the launch group's name, with no suffix.
children[].name- Its full name (what its campaign at the platform is named after).
children[].newCampaignName- The new campaign's name.
children[].platform- Its platform.
children[].publishedAt- First published.
children[].scheduleAt- Start.
children[].sharedWithGuests- Shared with guests for review.
children[].status- Status.One of
draft,publishing,published,failed children[].updatedAt- Last change.
children[].version- Version.
createdAt- Created.
description- Description.
id- The launch group.
name- Its own name.
ownerId- The member who owns it.
publishedCount- Listed campaigns that published.
status- Across its listed campaigns: any publishing, else any failed, else all published, else some, else draft.One of
draft,publishing,published,some_published,failed updatedAt- Last change to the group itself.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X PATCH "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: a4ecca55-d44b-44b6-b3e0-abd7d291973e" \
-H "Content-Type: application/json" \
-d '{
"description": "Two drops every morning for brighter, even skin.",
"expectedVersion": 3,
"name": "Vitamin C Serum, UGC 9x16",
"ownerId": "c7f25ce0-b477-48fc-9b7b-155702ae0ec2"
}'Delete a launch group
Deletes the launch group and its campaigns when every campaign is a draft that never created anything at a provider; otherwise 409 (archive it instead).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
deleted- Deleted.
id- The launch group.
launchIds- The campaigns deleted with it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X DELETE "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 2a604c78-a89e-4e75-b66d-d940a6a8586e"Archive or restore a launch group
Archives every active campaign of the launch group and so the group; archived: false restores the group with every campaign of it, also ones archived on their own before.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
archived- false restores.
Response
archivedAt- Archived (every campaign is).
campaignCount- Listed campaigns.
canDelete- Deleting is allowed: every campaign of it (archived ones too) is a draft never published. Anything else is archived.
children- Its campaigns in the order they were added: the active ones (the archived ones of an archived group), on platforms the workspace may use.
children[].adAccountId- Its ad account.
children[].adAccountName- The ad account's name, as synced.
children[].adCount- Ads.
children[].adSetCount- Ad sets.
children[].archivedAt- Archived.
children[].campaignId- The existing campaign it publishes into.
children[].canDelete- Deleting is allowed: a draft never published, nothing of it at its platform. Anything else is archived.
children[].createdAt- Created.
children[].currency- The ad account's currency (ISO 4217).
children[].groupId- Its launch group.
children[].id- The campaign (a launch ID).
children[].label- Its own name in the launch group: a person's, else the launch group's name, with no suffix.
children[].name- Its full name (what its campaign at the platform is named after).
children[].newCampaignName- The new campaign's name.
children[].platform- Its platform.
children[].publishedAt- First published.
children[].scheduleAt- Start.
children[].sharedWithGuests- Shared with guests for review.
children[].status- Status.One of
draft,publishing,published,failed children[].updatedAt- Last change.
children[].version- Version.
createdAt- Created.
description- Description.
id- The launch group.
name- Its own name.
ownerId- The member who owns it.
publishedCount- Listed campaigns that published.
status- Across its listed campaigns: any publishing, else any failed, else all published, else some, else draft.One of
draft,publishing,published,some_published,failed updatedAt- Last change to the group itself.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9/archive" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 6880d7f3-4828-47b1-a0d1-008bed538833" \
-H "Content-Type: application/json" \
-d '{
"archived": false
}'Add a campaign
Adds a campaign (another platform, ad account, or objective or budget setup): empty, or with from a copy of one of its campaigns in that platform's own fields (what carries over, what that platform's defaults fill in and what's left out); on the source's own platform everything carries over and a new ad account brings its Page, pixel and audiences from its defaults. adAccountId is required unless the platform has exactly one active ad account in the workspace (then that one is used) or from is on the same platform (then the source's); otherwise 422 on adAccountId. Copied ads are linked to their originals (GET /ads/{id}/linked). dryRun: true with from answers the plan without adding (200). Answers the new campaign (a launch).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
adAccountId- The ad account there. Required unless the platform has only one.
dryRun- With
from: the plan, without adding. from- One of its campaigns (a launch ID) to copy; absent starts empty.
label- Its own name in the launch.
platform- A platform from
GET /platforms; a platform this workspace can't use is refused like an unknown one (422).
Response
code- Stable code.One of
bad_request,unauthenticated,forbidden,not_found,conflict,invalid,rate_limited,unavailable,internal current- The current entity, on a stale
expectedVersion(409). errors- Every field problem (422).
errors[].code- A registered reason's stable code (such as
ad_account_not_in_meta), so an app can saymessagein its own words; absent for a reason without one. errors[].field- JSON-pointer-like path.
errors[].message- Problem.
errors[].params- The values
code's sentence names (maybe none), present exactly whencodeis. requestId- The request's ID, as in the
x-request-idheader. Include it when you report a problem. status- HTTP status.
title- What went wrong, for the person or agent reading it.
titleCode- A registered
title's stable code (such asnot_found_the_launch), for an app to say the title in its language; absent for a title without one.titlereads the same either way. titleParams- The values
titleCode's sentence names, present exactly whentitleCodeis. traceId- The request's trace ID, as in the
x-trace-idheader. type- Documentation URL for
code.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9/campaigns" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 56975e5e-5015-447b-b96b-a0ddd559a535" \
-H "Content-Type: application/json" \
-d '{
"adAccountId": "act_741877585619437",
"dryRun": false,
"from": "b0d53bab-77e5-487e-9baa-1f16677ab4a3",
"label": "Vitamin C Serum, UGC 9x16",
"platform": "422"
}'Duplicate a launch group
A new launch group with the same description and owner, and a draft copy of each active campaign (its ad sets, ads and settings, on the same platform and ad account); each keeps the name a person gave it, else reads the new launch's. Archived campaigns stay behind. Every copy creates its own campaign when it publishes. Without name, "<name> copy". 409 when the launch group has no active campaign.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
name- The new launch group's name (default: "<name> copy").
Response
archivedAt- Archived (every campaign is).
campaignCount- Listed campaigns.
canDelete- Deleting is allowed: every campaign of it (archived ones too) is a draft never published. Anything else is archived.
children- Its campaigns in the order they were added: the active ones (the archived ones of an archived group), on platforms the workspace may use.
children[].adAccountId- Its ad account.
children[].adAccountName- The ad account's name, as synced.
children[].adCount- Ads.
children[].adSetCount- Ad sets.
children[].archivedAt- Archived.
children[].campaignId- The existing campaign it publishes into.
children[].canDelete- Deleting is allowed: a draft never published, nothing of it at its platform. Anything else is archived.
children[].createdAt- Created.
children[].currency- The ad account's currency (ISO 4217).
children[].groupId- Its launch group.
children[].id- The campaign (a launch ID).
children[].label- Its own name in the launch group: a person's, else the launch group's name, with no suffix.
children[].name- Its full name (what its campaign at the platform is named after).
children[].newCampaignName- The new campaign's name.
children[].platform- Its platform.
children[].publishedAt- First published.
children[].scheduleAt- Start.
children[].sharedWithGuests- Shared with guests for review.
children[].status- Status.One of
draft,publishing,published,failed children[].updatedAt- Last change.
children[].version- Version.
createdAt- Created.
description- Description.
id- The launch group.
name- Its own name.
ownerId- The member who owns it.
publishedCount- Listed campaigns that published.
status- Across its listed campaigns: any publishing, else any failed, else all published, else some, else draft.One of
draft,publishing,published,some_published,failed updatedAt- Last change to the group itself.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9/duplicate" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: d064e1d0-80c0-4734-9458-c5ccf6a4c790" \
-H "Content-Type: application/json" \
-d '{
"name": "Vitamin C Serum, UGC 9x16"
}'Compare across campaigns
Per linked creative (an unlinked ad is its own row), each published campaign's numbers from its platform's own insights over the period: spend, impressions, clicks, CTR and results in that platform's attribution and day basis (campaigns[].attribution, dayBasis). Campaigns are grouped by platform, then ad account. Numbers from different platforms are never added up, nor amounts in different currencies; subtotals per platform and currency are given only when exact in the currency's minor units (spend: null otherwise), counts as integers, never ratios.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The launch group's ID. |
since | string | Optional | First day (YYYY-MM-DD), in each ad account's days. |
until | string | Optional | Last day. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
campaigns- Grouped by platform, then ad account.
campaigns[].adAccountId- Its ad account.
campaigns[].adAccountName- The account's name.
campaigns[].attribution- How its platform attributes results.
campaigns[].currency- The account's currency.
campaigns[].dayBasisaccount(the ad account's time zone) orutc.campaigns[].label- Its name in the launch group.
campaigns[].launchId- The campaign (a launch).
campaigns[].platform- Its platform.
campaigns[].published- It published; only published campaigns have numbers.
creatives- The creatives.
creatives[].cells- One per ad, never added up across platforms.
creatives[].cells[].adId- Ad.
creatives[].cells[].currency- Its amounts' currency.
creatives[].cells[].launchId- Campaign.
creatives[].cells[].metrics- Its platform's metrics: decimal strings for money, absent when the platform reported nothing.
creatives[].cells[].platform- Platform.
creatives[].creativeLinkId- The link its ads share; null for an unlinked ad.
creatives[].mediaId- The first ad's file.
creatives[].name- The first ad's name.
periodperiod.since- First day.
period.until- Last day.
subtotals- Per platform and currency.
subtotals[].clicks- Clicks.
subtotals[].currency- Currency.
subtotals[].impressions- Impressions.
subtotals[].platform- Platform.
subtotals[].spend- Exact in the currency's minor units, else null.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/launch-groups/8f3e8466-e14a-4118-89d5-c2ff4f3d21d9/results" \
-H "Authorization: Bearer $PLUTO_KEY"