Upsert user trait

This endpoint expects an object.

keysmap from strings to stringsRequired

Key/value pairs too identify a company or user

traitstringRequired

Name of the trait to update

incrintegerOptional

Amount to increment the trait by (positive or negative)

setstringOptional

Value to set the trait to

update_onlybooleanOptionalDefaults to false

Unless this is set, the company or user will be created if it does not already exist

1 curl -X POST https://api.schematichq.com/user-traits \ 2 -H "X-Schematic-Api-Key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "keys": { 6 "key": "value" 7 }, 8 "trait": "trait" 9 }'

1 { 2 "data": { 3 "company_memberships": [ 4 { 5 "company_id": "company_id", 6 "created_at": "2024-01-15T09:30:00Z", 7 "id": "id", 8 "updated_at": "2024-01-15T09:30:00Z", 9 "user_id": "user_id" 10 } 11 ], 12 "created_at": "2024-01-15T09:30:00Z", 13 "entity_traits": [ 14 { 15 "created_at": "2024-01-15T09:30:00Z", 16 "definition_id": "definition_id", 17 "environment_id": "environment_id", 18 "id": "id", 19 "updated_at": "2024-01-15T09:30:00Z", 20 "value": "value" 21 } 22 ], 23 "environment_id": "environment_id", 24 "id": "id", 25 "keys": [ 26 { 27 "created_at": "2024-01-15T09:30:00Z", 28 "definition_id": "definition_id", 29 "entity_id": "entity_id", 30 "entity_type": "entity_type", 31 "environment_id": "environment_id", 32 "id": "id", 33 "key": "key", 34 "updated_at": "2024-01-15T09:30:00Z", 35 "value": "value" 36 } 37 ], 38 "name": "name", 39 "updated_at": "2024-01-15T09:30:00Z", 40 "last_seen_at": "2024-01-15T09:30:00Z", 41 "traits": { 42 "key": "value" 43 } 44 }, 45 "params": { 46 "key": "value" 47 } 48 }

Request

Response

1	curl -X POST https://api.schematichq.com/user-traits \
2	-H "X-Schematic-Api-Key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"keys": {
6	"key": "value"
7	},
8	"trait": "trait"
9	}'

1	{
2	"data": {
3	"company_memberships": [
4	{
5	"company_id": "company_id",
6	"created_at": "2024-01-15T09:30:00Z",
7	"id": "id",
8	"updated_at": "2024-01-15T09:30:00Z",
9	"user_id": "user_id"
10	}
11	],
12	"created_at": "2024-01-15T09:30:00Z",
13	"entity_traits": [
14	{
15	"created_at": "2024-01-15T09:30:00Z",
16	"definition_id": "definition_id",
17	"environment_id": "environment_id",
18	"id": "id",
19	"updated_at": "2024-01-15T09:30:00Z",
20	"value": "value"
21	}
22	],
23	"environment_id": "environment_id",
24	"id": "id",
25	"keys": [
26	{
27	"created_at": "2024-01-15T09:30:00Z",
28	"definition_id": "definition_id",
29	"entity_id": "entity_id",
30	"entity_type": "entity_type",
31	"environment_id": "environment_id",
32	"id": "id",
33	"key": "key",
34	"updated_at": "2024-01-15T09:30:00Z",
35	"value": "value"
36	}
37	],
38	"name": "name",
39	"updated_at": "2024-01-15T09:30:00Z",
40	"last_seen_at": "2024-01-15T09:30:00Z",
41	"traits": {
42	"key": "value"
43	}
44	},
45	"params": {
46	"key": "value"
47	}
48	}