From be7de323bd5b9d3c1cba94754c0e351cf6df43f6 Mon Sep 17 00:00:00 2001 From: Rahul Muthyam Date: Tue, 25 Feb 2025 12:58:10 -0800 Subject: [PATCH] AMP-124739 [taxonomy-api] add ability to set activity and hidden status for events and properties --- content/collections/api/en/taxonomy.md | 104 +++++++++++++++++++++++-- 1 file changed, 96 insertions(+), 8 deletions(-) diff --git a/content/collections/api/en/taxonomy.md b/content/collections/api/en/taxonomy.md index 6c877e490..a56ed7b11 100644 --- a/content/collections/api/en/taxonomy.md +++ b/content/collections/api/en/taxonomy.md @@ -494,11 +494,22 @@ event_type=Onboard%20Start&category=Onboarding&description=My%20new%20onboarding #### Body parameters -|
Name
| Description | -| ---------------------------------- | ----------------------------------------------------------------------------- | -| `event_type` | Required. String. The event name. | -| `category` | Optional. String. The event type's category. | -| `description` | Optional. String. Details about the event type. | +|
Name
| Description | +| ---------------------------------- | ----------------------------------------------------------------------------------------- | +| `event_type` | Required. String. The event name. | +| `category` | Optional. String. The event type's category. | +| `description` | Optional. String. Details about the event type. | +| `is_active` | Optional. Boolean. Activity of the event type. | +| `is_hidden_from_dropdowns` | Optional. Boolean. Event type is hidden from dropdowns. | +| `is_hidden_from_persona_results` | Optional. Boolean. Event type is hidden from persona results. | +| `is_hidden_from_pathfinder` | Optional. Boolean. Event type is hidden from pathfinder. | +| `is_hidden_from_timeline` | Optional. Boolean. Event type is hidden from timeline. | +| `tags` | Optional. String. List of tags, separated by a comma. | +| `owner` | Optional. String. Owner of the event type. | + +{{partial:admonition type="note" heading=""}} +`is_hidden_from_dropdowns`, `is_hidden_from_persona_results`, `is_hidden_from_pathfinder` and `is_hidden_from_timeline` properties can only be set on ingested event types. +{{/partial:admonition}} #### 200 ok response @@ -567,14 +578,28 @@ A successful request returns a `200 OK` status with a JSON body: "category": { "name": "Attribution Events" }, - "description": null + "description": null, + "is_active": false, + "is_hidden_from_dropdowns": false, + "is_hidden_from_persona_results": false, + "is_hidden_from_pathfinder": false, + "is_hidden_from_timeline": false, + "tags": [], + "owner": null }, { "event_type": "Conversation", "category": { "name": "Conversion Events" }, - "description": "This event is fired when a user converts." + "description": "This event is fired when a user converts.", + "is_active": false, + "is_hidden_from_dropdowns": false, + "is_hidden_from_persona_results": false, + "is_hidden_from_pathfinder": false, + "is_hidden_from_timeline": false, + "tags": [], + "owner": null } ] } @@ -642,7 +667,14 @@ A successful request returns a `200 OK` status and a JSON body with the event ty "category": { "name": "Conversion Events" }, - "description": null + "description": null, + "is_active": false, + "is_hidden_from_dropdowns": false, + "is_hidden_from_persona_results": false, + "is_hidden_from_pathfinder": false, + "is_hidden_from_timeline": false, + "tags": [], + "owner": null } } ``` @@ -733,6 +765,17 @@ new_event_type=OnboardStart&category=Onboarding&description=User%20signed%20in%2 | `category` | Optional. Current category name of the event type. | | `description` | Optional. String. Details to add to the event type. | | `display_name` | Optional. String. Display name of an event type. You can update the display name for an event type after it's ingested into Amplitude. | +| `is_active` | Optional. Boolean. Activity of the event type. | +| `is_hidden_from_dropdowns` | Optional. Boolean. Event type is hidden from dropdowns. | +| `is_hidden_from_persona_results` | Optional. Boolean. Event type is hidden from persona results. | +| `is_hidden_from_pathfinder` | Optional. Boolean. Event type is hidden from pathfinder. | +| `is_hidden_from_timeline` | Optional. Boolean. Event type is hidden from timeline. | +| `tags` | Optional. String. List of tags, separated by a comma. | +| `owner` | Optional. String. Owner of the event type. | + +{{partial:admonition type="note" heading=""}} +`is_hidden_from_dropdowns`, `is_hidden_from_persona_results`, `is_hidden_from_pathfinder` and `is_hidden_from_timeline` properties can only be set on ingested event types. +{{/partial:admonition}} #### 200 OK response @@ -1005,8 +1048,13 @@ event_type=Onboard%20Start&event_property=Completed%20Task&type=boolean&is_requi | `enum_values` | Optional. String. List of allowed values, separated by comma. For example: `red, yellow, blue`. Only applicable to the `enum` type. | | `is_array_type` | Optional. Boolean. Use the `type` parameter to set the type of array elements. | | `is_required` | Optional. Boolean. Marks the property as required. When `true`, Amplitude flags events that are missing this property on the Taxonomy page in the web app. | +| `is_hidden` | Optional. Boolean. Hide the property from chart dropdowns. | | `classifications` | Optional. String. List of classifications applicable to this event property. Valid classifications are `PII`, `SENSITIVE` and `REVENUE`. You can only apply classifications on shared properties. Trying to set classifications on an overridden property results in an error. | +{{partial:admonition type="note" heading=""}} +`is_hidden` property can only be set on ingested properties. +{{/partial:admonition}} + #### 200 OK response A successful request returns a `200 OK` status and a JSON body. @@ -1112,6 +1160,7 @@ A successful request returns a `200 OK` status and a JSON body with a list of ev "enum_values": null, "is_array_type": false, "is_required": false, + "is_hidden": false, "classifications": ["PII"] }, { @@ -1123,6 +1172,7 @@ A successful request returns a `200 OK` status and a JSON body with a list of ev "enum_values": null, "is_array_type": false, "is_required": false, + "is_hidden": false, "classifications": [] } ] @@ -1211,6 +1261,7 @@ A successful request returns a `200 OK` status and a JSON body containing infor "enum_values": null, "is_array_type": false, "is_required": false, + "is_hidden": false, "classifications": ["PII"] } } @@ -1308,8 +1359,13 @@ event_type=Onboard%20Start&description=User%20completed%20an%20onboarding%20task | `enum_values` | Optional. String. List of allowed values. | | `is_array_type` | Optional. Boolean. Specifies whether the property value is an array. | | `is_required` | Optional. Boolean. Marks the property as required. | +| `is_hidden` | Optional. Boolean. Hide the property from chart dropdowns. | | `classifications` | Optional. String. Only available if Data Access Controls is enabled at the account level. List of classifications applicable to this event property. Valid classifications are `PII`, `SENSITIVE` and `REVENUE`. You can only apply classifications on shared properties, and trying to set classifications on an overridden property results in an error. With `overrideScope: "override"`, Amplitude returns an error for the same reason mentioned in the previous point. | +{{partial:admonition type="note" heading=""}} +`is_hidden` property can only be set on ingested properties. +{{/partial:admonition}} + #### 200 OK response A successful request returns a `200 OK` status and a JSON body. @@ -1567,8 +1623,13 @@ user_property=User%20Type&description=Describes%20whether%20the%20user%20is%20a% | `regex` | Optional. String. Regular expression or custom regex used for pattern matching and more complex values. For example, 'zip code' property must have pattern `[0-9]{5}`. | | `enum_values` | Optional. String. List of allowed values, separated by comma. For example: `red, yellow, blue`. | | `is_array_type` | Optional. Boolean. Specifies whether the property value is an array. | +| `is_hidden` | Optional. Boolean. Hide the property from chart dropdowns. | | `classifications` | Optional. String. Only available if Data Access Controls is enabled at the account level. List of classifications applicable to this user property. Valid classifications are `PII`, `SENSITIVE` and `REVENUE`. | +{{partial:admonition type="note" heading=""}} +`is_hidden` property can only be set on ingested properties. +{{/partial:admonition}} + #### Response This request returns either a true or false response. @@ -1622,6 +1683,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": ["PII"] }, //[tl! collapse:start] { @@ -1631,6 +1693,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] }, { @@ -1640,6 +1703,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] }, { @@ -1649,6 +1713,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] }, { @@ -1658,6 +1723,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] }, { @@ -1667,6 +1733,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] }, { @@ -1676,6 +1743,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden":false, "classifications": [] }, { @@ -1685,6 +1753,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] } //[tl! collapse:end] ] @@ -1756,6 +1825,7 @@ A successful request returns a `200 OK` response and a JSON body with user prope "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": ["PII"] } } @@ -1851,8 +1921,13 @@ new_user_property_value=subscription_type&description=The%20user's%20subscriptio | `regex` | Optional. String. Regular expression or custom regex used for pattern matching and more complex values. For example, 'zip code' property must have pattern `[0-9]{5}`. Only applicable to the `string` type. | | `enum_values` | Optional. String. List of allowed values, separated by comma. For example: `red, yellow, blue`. Only applicable to the `enum` type. | | `is_array_type` | Optional. Boolean. Specifies whether the property value is an array. Use the `type` parameter to set the type of array elements. | +| `is_hidden` | Optional. Boolean. Hide the property from chart dropdowns. | | `classifications` | Optional. String. Only available if Data Access Controls is enabled at the account level. List of classifications applicable to this user property. Valid classifications are `PII`, `SENSITIVE` and `REVENUE`. | +{{partial:admonition type="note" heading=""}} +`is_hidden` property can only be set on ingested properties. +{{/partial:admonition}} + #### Response This request returns either a true or false response. @@ -2081,8 +2156,13 @@ group_type=Group%201&group_property=Group%20Property%201&type=boolean&descriptio | `regex` | Optional. String. Regular expression, custom regex used for pattern matching or more complex values. For example, property zip code must have pattern `[0-9]{5}` Applies only to the `string` type. | | `enum_values` | Optional. String. List of allowed values, separated by comma. For example: `red, yellow, blue`. Only applicable to the `enum` type. | | `is_array_type` | Optional. Boolean. Property is an array type. Use the `type` parameter to set the type of array elements. | +| `is_hidden` | Optional. Boolean. Hide the property from chart dropdowns. | | `classifications` | Optional. String. Only available if Data Access Controls is enabled at the account level. List of classifications applicable to this group property. Valid classifications are `PII`, `SENSITIVE` and `REVENUE`. You can only apply classifications on shared properties, and trying to set classifications on an overridden property results in an error. | +{{partial:admonition type="note" heading=""}} +`is_hidden` property can only be set on ingested properties. +{{/partial:admonition}} + #### 200 OK response A successful request returns a `200 OK` status and a JSON body. @@ -2187,6 +2267,7 @@ A successful request returns a `200 OK` status and a JSON body with a list of gr "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": ["PII"] }, { @@ -2197,6 +2278,7 @@ A successful request returns a `200 OK` status and a JSON body with a list of gr "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": [] }, ] @@ -2284,6 +2366,7 @@ A successful request returns a `200 OK` status and a JSON body containing infor "enum_values": null, "regex": null, "is_array_type": false, + "is_hidden": false, "classifications": ["PII"] }, } @@ -2380,8 +2463,13 @@ group_type=Group%201&description=First%20Group%20Property%20Updated&new_group_pr | `regex` | Optional. String. Regular expression, custom regex used for pattern matching or more complex values. For example, property zip code must have pattern `[0-9]{5}` Applies only to the `string` type. | | `enum_values` | Optional. String. List of allowed values, separated by comma. For example: `red, yellow, blue`. Only applicable to the `enum` type. | | `is_array_type` | Optional. Boolean. Property is an array type. Use the `type` parameter to set the type of array elements. | +| `is_hidden` | Optional. Boolean. Hide the property from chart dropdowns. | | `classifications` | Optional. String. Only available if Data Access Controls is enabled at the account level. List of classifications applicable to this group property. Valid classifications are `PII`, `SENSITIVE` and `REVENUE`. You can only apply classifications on shared properties. Trying to set classifications on an overridden property results in an error. | +{{partial:admonition type="note" heading=""}} +`is_hidden` property can only be set on ingested properties. +{{/partial:admonition}} + #### 200 OK response A successful request returns a `200 OK` status and a JSON body.