Skip to main content
POST
Create an Asset

Authorizations

Authorization
string
header
required

Bearer token

Headers

X-Account-ID
string<uuid>
required

Account ID

x-integration-managed
enum<string>

Claim integration ownership atomically; requires entity.integration.claim. Updates must include organization_id.

Available options:
true
x-integration-source-id
string

The integration's id for this record. Requires x-integration-managed. A repeated id returns the asset it created, unchanged, with 200.

Required string length: 1 - 500

Path Parameters

assetTypeName
string
required

Asset type name

Body

application/json

Asset data (structure depends on asset type definition)

Asset data (structure depends on asset type definition)

organization_id
string<uuid>
required

Organization ID

visibility
enum<string>

Asset visibility (default: inherit)

Available options:
inherit,
private,
restricted
owned_by
string<uuid>

User ID of asset owner (defaults to creating user)

indexable
boolean

Opt this asset into the Ask Lex knowledge graph

Response

Asset with dynamic properties from asset type definition spread at root level

Asset with dynamic properties from asset type definition spread at root level

id
string<uuid>

Asset unique identifier

organization_id
string<uuid>

Organization ID

organization_name
string

Organization name

visibility
enum<string>

Asset visibility setting

Available options:
inherit,
private,
restricted
owned_by
string<uuid>

User ID of asset owner

tags
object[]

Expanded tags (only present when expand=tags is used)

references
object

Asset references (IDs or expanded assets)

created_at
string<date-time>
updated_at
string<date-time>
deleted_at
string<date-time> | null

Deletion timestamp

created_by
string

User ID who created

updated_by
string

User ID who last updated