|
1 | 1 | --- |
2 | | -title: Add customer property |
3 | | -description: Creates a new customer property definition |
4 | | -api: POST /api/v1/workspaces/{workspace-slug}/customer-properties/ |
| 2 | +title: Create a customer property |
| 3 | +description: Creates a new customer property definition in a workspace. |
| 4 | +api: POST /api/v1/workspaces/{workspace_slug}/customer-properties/ |
5 | 5 | --- |
6 | 6 |
|
7 | | -### Path parameters |
| 7 | +## Path parameters |
8 | 8 |
|
9 | | -<ParamField path="workspace-slug" type="string" required></ParamField> |
| 9 | +<ParamField path="workspace_slug" type="string" required> |
| 10 | +The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL `https://app.plane.so/my-team/projects/`, the workspace slug is `my-team`. |
| 11 | +</ParamField> |
10 | 12 |
|
11 | | -### Body |
| 13 | +## Body parameters |
12 | 14 |
|
13 | 15 | <ParamField body="name" type="string"> |
14 | | -Name of the property |
| 16 | +Name of the property. |
15 | 17 | </ParamField> |
16 | 18 |
|
17 | 19 | <ParamField body="display_name" type="string"> |
18 | | -Display name of the property |
| 20 | +Display name of the property. |
19 | 21 | </ParamField> |
20 | 22 |
|
21 | 23 | <ParamField body="description" type="string"> |
22 | | -Description of the property |
| 24 | +Description of the property. |
23 | 25 | </ParamField> |
24 | 26 |
|
25 | 27 | <ParamField body="property_type" type="string"> |
26 | | -Type of the property |
| 28 | +Type of the property. |
27 | 29 | </ParamField> |
28 | 30 |
|
29 | 31 | <ParamField body="relation_type" type="string"> |
30 | | -Relation type of the property |
| 32 | +Relation type of the property. |
31 | 33 | </ParamField> |
32 | 34 |
|
33 | 35 | <ParamField body="is_required" type="boolean"> |
34 | | -Whether the property is required |
| 36 | +Whether the property is required. |
35 | 37 | </ParamField> |
36 | 38 |
|
37 | 39 | <ParamField body="is_multi" type="boolean"> |
38 | | -Whether the property supports multiple values |
| 40 | +Whether the property supports multiple values. |
39 | 41 | </ParamField> |
40 | 42 |
|
41 | 43 | <ParamField body="is_active" type="boolean"> |
42 | | -Whether the property is active |
| 44 | +Whether the property is active. |
43 | 45 | </ParamField> |
44 | 46 |
|
45 | 47 | <ParamField body="sort_order" type="number"> |
46 | | -Sort order for the property |
| 48 | +Sort order for the property. |
47 | 49 | </ParamField> |
48 | 50 |
|
49 | 51 | <ParamField body="default_value" type="string[]"> |
50 | | -Default values for the property |
| 52 | +Default values for the property. |
51 | 53 | </ParamField> |
52 | 54 |
|
53 | 55 | <ParamField body="settings" type="object"> |
54 | | -Settings for the property |
| 56 | +Settings for the property. |
55 | 57 | </ParamField> |
56 | 58 |
|
57 | 59 | <ParamField body="validation_rules" type="object"> |
58 | | -Validation rules for the property |
| 60 | +Validation rules for the property. |
59 | 61 | </ParamField> |
60 | 62 |
|
61 | 63 | <ParamField body="logo_props" type="object"> |
62 | | -Logo properties for the property |
| 64 | +Logo properties for the property. |
63 | 65 | </ParamField> |
64 | 66 |
|
65 | 67 | <ParamField body="external_source" type="string"> |
66 | | -External source identifier |
| 68 | +External source identifier. |
67 | 69 | </ParamField> |
68 | 70 |
|
69 | 71 | <ParamField body="external_id" type="string"> |
70 | | -External ID from the external source |
| 72 | +External ID from the external source. |
71 | 73 | </ParamField> |
72 | 74 |
|
0 commit comments