Manage assets

The V2 Assets API separates assets your organization owns from assets that are
associated with it. Every list or create request uses an asset_type of
owned or associated.

Prerequisite

Get an OAuth access token (see Authentication).

List assets of one type

GET /v2/assets requires asset_type. The list also supports
platform_name, brand_ids, brand_names, limit, and offset.

curl --request GET \
  --url "https://api.doppel.com/v2/assets?asset_type=owned" \
  --header "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

The response contains data, count, and an asset_type on every returned
asset. Omitting asset_type returns 422 Unprocessable Entity.

Create an asset

Use POST /v2/assets with one or more brand IDs, the asset value, and its type:

curl --request POST \
  --url "https://api.doppel.com/v2/assets" \
  --header "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "brand_ids": ["123e4567-e89b-12d3-a456-426614174000"],
    "asset_value": "https://example.com",
    "asset_type": "owned"
  }'

A successful create returns 201 Created with the new asset. A brand that your
organization cannot read returns 404 Not Found.

Create an asset from an alert

POST /v2/alert/assets derives the asset value and brand from an existing
alert. Identify the alert with exactly one of id or entity; the request body
contains only asset_type.

curl --request POST \
  --url "https://api.doppel.com/v2/alert/assets?id=ACM-1234" \
  --header "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{"asset_type": "associated"}'

A successful create returns 201 Created. An alert that your organization
cannot read returns 404 Not Found.

Deprecated compatibility routes

Existing integrations can continue to use these V2 routes, but new integrations
should use /v2/assets:

• GET /v2/protected-assets returns owned and associated assets together and
  cannot filter by type.
• POST /v2/protected-asset creates an owned asset.

DELETE /v2/protected-asset/{id} is not deprecated and continues to delete
either asset type.