Skip to main content
GET
List Platform Assets

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.

Query Parameters

platform
string
assetType
enum<string>
Available options:
campaign,
adset,
ad
assetId
string
adAccountId
string
adAccountIds
string
parentAssetId
string
query
string
status
string
limit
integer

Native inventory accepts 1–500 rows. Follow the returned availability information instead of treating a bounded read as a complete account inventory.

Required range: 1 <= x <= 500
inventory
enum<string>

Request current native inventory. Requires one platform, advertiser and supported asset type; incompatible with aggregate availability/status filters.

Available options:
1
nativeAssetType
enum<string>
Available options:
asset_group
includeGoogleAssetGroups
enum<string>
Available options:
0,
1
dataSourceAdAccountId
string
dataSourceConnectorId
string

Response

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

The response is of type object.