Launch defaults
The Meta settings new launches start from, for the workspace and per ad account.
Get the launch defaults
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
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
accounts- Per ad account: overrides, effective settings, version.
settings- Workspace defaults.
version- 0 until saved.
curl "$PLUTO_API/meta-defaults" \
-H "Authorization: Bearer $PLUTO_KEY"Set the launch defaults
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
expectedVersion- The version you last read. A mismatch is a conflict that returns the current entity.
settings- Keys to change.
Response
accounts- Per ad account: overrides, effective settings, version.
settings- Workspace defaults.
version- 0 until saved.
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 PUT "$PLUTO_API/meta-defaults" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 3d2c3ac8-1f7f-4172-b9a3-98572c0e1a88" \
-H "Content-Type: application/json" \
-d '{
"expectedVersion": 3,
"settings": {}
}'Set an ad account's defaults
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Required | The ad account'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
expectedVersion- The version you last read. A mismatch is a conflict that returns the current entity.
settings- Keys to change.
Response
accounts- Per ad account: overrides, effective settings, version.
settings- Workspace defaults.
version- 0 until saved.
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 PUT "$PLUTO_API/meta-defaults/accounts/act_741877585619437" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 40a4c6e8-a3c1-4d70-b51b-afdb782a22ba" \
-H "Content-Type: application/json" \
-d '{
"expectedVersion": 3,
"settings": {}
}'Remove an ad account's defaults
Drop an ad account's overrides.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Required | The ad account'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
accounts- Per ad account: overrides, effective settings, version.
settings- Workspace defaults.
version- 0 until saved.
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/meta-defaults/accounts/act_741877585619437" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 97e07746-e05a-4e5c-b912-a12c2f2b2348"