ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

business_access_assets

Update asset groups.

Update a batch of asset groups with the specified parameters.

patch/businesses/{business_id}/asset_groups

Path parameters

business_idstring required

Unique identifier of the requesting business.

Request body

Example request

{
  "asset_groups_to_update": [
    {
      "asset_group_types": [
        "BRAND",
        "LOCATION_OR_LANGUAGE",
        "PRODUCT_LINE",
        "OTHER"
      ]
    }
  ],
  "updated_asset_groups": [
    {
      "ad_accounts_ids": [
        "549755885175"
      ],
      "asset_group_description": "Asset group that has ad accounts used in Canada",
      "asset_group_name": "Canada Ad Accounts",
      "asset_group_types": [
        "LOCATION_OR_LANGUAGE"
      ],
      "catalogs_ids": [
        "4836859046874"
      ],
      "created_by": {
        "email": "business0101@business.com",
        "id": "549755885175",
        "username": "business0101"
      },
      "created_time": 1646767577816,
      "id": "666791336903426391",
      "owner": {
        "email": "business0101@business.com",
        "id": "549755885175",
        "username": "business0101"
      },
      "profiles_ids": [
        "630433785246278264"
      ],
      "updated_time": 1646767577816
    }
  ]
}

Response

The request has succeeded.

Example response

{
  "updated_asset_groups": [
    {
      "ad_accounts_ids": [
        "549755885175"
      ],
      "asset_group_description": "Asset group that has ad accounts used in Canada",
      "asset_group_name": "Canada Ad Accounts",
      "asset_group_types": [
        "LOCATION_OR_LANGUAGE"
      ],
      "catalogs_ids": [
        "4836859046874"
      ],
      "created_by": {
        "email": "business0101@business.com",
        "id": "549755885175",
        "username": "business0101"
      },
      "created_time": 1646767577816,
      "id": "666791336903426391",
      "owner": {
        "email": "business0101@business.com",
        "id": "549755885175",
        "username": "business0101"
      },
      "profiles_ids": [
        "630433785246278264"
      ],
      "updated_time": 1646767577816
    }
  ]
}

Changes

Changed in 3 of the 29 revisions of this API.219

Jun 4, 2026v5b698c180678a217See the full diff
- ▲
  the // response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the // response's property type changed from object to no type for status
  response-property-type-changed
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  the response optional property became read-only for the status
  response-optional-property-became-read-only
- ○
  the response optional property became read-only for the status
  response-optional-property-became-read-only
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
This revision also has 182 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 4, 2025v510f9eba4ad971See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 14, 2024v589c27ed39cfd1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history