Update Platform Asset

curl --request POST \
  --url https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/update-asset \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "assetId": "<string>",
  "updates": {
    "name": "<string>",
    "budget": 123
  },
  "parentAssetId": "<string>",
  "adAccountId": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    assetId: '<string>',
    updates: {name: '<string>', budget: 123},
    parentAssetId: '<string>',
    adAccountId: '<string>'
  })
};

fetch('https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/update-asset', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/update-asset"

payload = {
    "assetId": "<string>",
    "updates": {
        "name": "<string>",
        "budget": 123
    },
    "parentAssetId": "<string>",
    "adAccountId": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

Campaign actions

Update Platform Asset

Advanced immediate provider operation to rename, pause, resume, archive, or rebudget supported campaigns and ad sets, plus supported ad-level actions. Normal Ads Manager requests should saveAdDraft first, read/review it, then explicitly publishAdDraft. Meta and Google budget writes require the version 1 budgetGuard from read-asset-budget, exact selected native owner/parent and a budget-only update with the unchanged cadence. Old unguarded absolute/relative budget bodies require a new review and submit no budget change. Bily never rebases the saved absolute amount or retargets an inherited Meta ad set. Google shared scope must be complete and at most 100; CUSTOM_PERIOD is unsupported. Generic Google status/name/removal is checked against the exact fresh native campaign and parent; classic VIDEO and budgets affecting VIDEO are read only. Dedicated Demand Gen video remains supported; the native v24+ responsive Video-ad-info and experiment exceptions are not generic update-asset operations. Native-owner arbitration covers separate jobs and authorized aliases. New unguarded budget drafts fail Save; overbound mixed financial jobs require a split review. Busy or unknown outcomes never replay automatically; unknown outcomes quarantine the exact owner with its original receipt beyond job retirement. ARCHIVED maps to native removal for Google, TikTok and Snapchat; require separate exact destructive approval rather than treating it as a reversible pause. Authorized Slack requests use this same workspace-scoped capability; pausing an ad requires its exact platform, asset type, and asset ID. This generic outer sourceAuthority remains GOOGLE_ADS only; Meta budget source is bound inside budgetGuard. Other providers and nonbudget fields keep their previous contracts. This is an execution endpoint. For a reviewed user change, save its supported capability/body as an immutable action draft, review it, and explicitly publish that draft. Check action-jobs/capabilities before staging; a catalog entry alone does not make it stageable.

POST

platform

{resourceUrl}

actions

update-asset

Update Platform Asset

curl --request POST \
  --url https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/update-asset \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "assetId": "<string>",
  "updates": {
    "name": "<string>",
    "budget": 123
  },
  "parentAssetId": "<string>",
  "adAccountId": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    assetId: '<string>',
    updates: {name: '<string>', budget: 123},
    parentAssetId: '<string>',
    adAccountId: '<string>'
  })
};

fetch('https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/update-asset', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.bily.ai/api/customer/v1/platform/{resourceUrl}/actions/update-asset"

payload = {
    "assetId": "<string>",
    "updates": {
        "name": "<string>",
        "budget": 123
    },
    "parentAssetId": "<string>",
    "adAccountId": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

{
  "error": "Store not found",
  "requestId": "<string>",
  "details": "<unknown>",
  "retryAfter": "<string>"
}

Authorizations

x-api-key

string

header

required

A server-side Bily API key created under Settings > AI tools > Access keys. Select the intended workspace before creating it.

Headers

x-bily-organization-id

string

An organization ID returned by GET /context or GET /organizations. Omit it when a scoped key supplies the organization. Otherwise provide it when no organization is selected.

Example:

"org_01J8W7T9G3E6ZQ4M2K5N8P1R0S"

Path Parameters

resourceUrl

string

required

Exact workspace URL returned by GET /context.

Body

application/json

For Meta/Google budget changes, first read the native budget and keep the returned guard unchanged. Send only budget and budgetType inside updates. Meta omits top-level sourceAuthority; its source is inside budgetGuard. Google supplies the exact top-level sourceAuthority pair. The path supplies resourceUrl; do not repeat it in the body.

platform

enum<string>

required

Available options:

FACEBOOK,

GOOGLE_ADS,

MICROSOFT,

LINKEDIN,

SNAPCHAT,

TIKTOK,

PINTEREST

assetType

enum<string>

required

Available options:

campaign,

adset,

ad

assetId

string

required

updates

object

required

Show child attributes

parentAssetId

string

Pattern: ^[1-9]\d{0,19}$

adAccountId

string

budgetGuard

object

Use the live quote unchanged. amountUnits must fit a positive signed 64-bit integer (at most 9223372036854775807). Selection, owner, currency, cadence and source must match the exact request. Google affectedCampaignIds is the complete unique lexically sorted scope, includes the selected campaign, and matches referenceCount. A JSON-shaped guard without a current matching fingerprint is not executable authority.

Option 1
Option 2

Show child attributes

sourceAuthority

object

GOOGLE_ADS only: use the exact enabled account and connector pair from the current workspace selection. Omit for other platforms.

Show child attributes

Response

Request completed. Inspect the returned state and any verification fields.

The response is of type object.

Getting started

Endpoint reference

Update Platform Asset

Authorizations

Headers

Path Parameters

Body

Response