Create a segment or view asset

post

https://api.liveramp.com/asset-building-api/v1/assets

Creates one asset. Set assetType to SEGMENT or VIEW and supply a matching rule (advanced or simple).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for POST /v1/assets.

owningOrgID

string

Owning organization id. Optional when LR-Org-ID is set on the asset-builder facade; the facade may inject this for the upstream call.

name

string

required

Display name for the new asset.

assetType

string

enum

required

Asset kind:

SEGMENT — segment asset (default for most flows)
VIEW — view asset (for example CAPI-related use cases)

Allowed:

ruleType

string

enum

How rule is interpreted:

ADVANCED — tree of segment logic (AdvancedRule with include/exclude). - SIMPLE — flat combine of feed selectors (SimpleRule; default).
Optional; this API defaults to SIMPLE when omitted.

Allowed:

description

string

Optional human-readable description of the asset.

rule

object

required

Rule payload; shape depends on ruleType and AssetRule discriminator.

requestedAt

string

Client timestamp for the request (ISO 8601 UTC date-time).

requestedBy

string

Requester identifier (user id or email), if you track it.

Headers

Authorization

string

required

Bearer Authorization using the access token generated with your service account

LR-Org-ID

string

required

LiveRamp Org ID to make requests as. Starting Jan 2022, this is recommended over the Liveramp Customer ID header

Responses

201Created. Response body includes the new asset id.

400Malformed or unsupported request. See StandardError.

401Missing or invalid credentials. See StandardError.

403Caller is not allowed to create this asset. See StandardError.

409Conflict with existing state (for example duplicate name). See StandardError.

422Semantically invalid payload. See StandardError.