v3

OpenAPI 3.1.02026-07-31350397683.8 KB

Customer Traits

Create Customer Trait

Create a new customer trait definition for an agent.

Args: trait_request: The trait creation request data request: FastAPI request object auth: Authentication credentials

Returns: CustomerTraitResponse with the created trait details

post/v1/create-customer-trait

Headers

X-API-Keystring required

API key required to authenticate requests.

Request body

agent_idinteger required

ID of the agent this trait belongs to

namestring required

Name of the trait

data_type'BOOLEAN' | 'STRING' | 'DATE' | 'NUMBER' required

Enum for trait data types.

{"stackTrail":"components:schemas:CreateCustomerTraitRequest:properties:default_value:anyOf","oasType":"schema","type":"unknown","title":"Default Value","description":"Default value for this trait (will be converted based on data_type)","nullable":true}

Response

Successful Response

idstring required

Unique identifier for the customer trait

agent_idinteger required

ID of the agent this trait belongs to

namestring required

Name of the trait

data_type'BOOLEAN' | 'STRING' | 'DATE' | 'NUMBER' required

Enum for trait data types.

{"stackTrail":"components:schemas:CustomerTraitResponse:properties:default_value:anyOf","oasType":"schema","type":"unknown","title":"Default Value","description":"Default value for this trait (stored as JSONB)","nullable":true}

created_atstring date-time required

When the trait was created