From 19306110557243a8c5153c79036cb950fb2fa615 Mon Sep 17 00:00:00 2001
From: Rachael Thomas <rnthomas001@gmail.com>
Date: Thu, 2 Jan 2025 13:37:10 -0700
Subject: [PATCH 1/4] First pass through for initial clean up

---
 content/reference.mdx | 214 +++++++++++++++++++++---------------------
 1 file changed, 106 insertions(+), 108 deletions(-)

diff --git a/content/reference.mdx b/content/reference.mdx
index 96db7da8..1eb72fd4 100644
--- a/content/reference.mdx
+++ b/content/reference.mdx
@@ -310,7 +310,7 @@ Resources that return multiple entities support the same cursor-based pagination
   />
   <Attribute
     name="page_size"
-    type="number (optional)"
+    type="number"
     description="A number between 1 and 50 that represents the number of items to return in the response. Defaults to 50."
   />
 </Attributes>
@@ -585,29 +585,30 @@ The workflow trigger endpoint enforces the following payload size limits:
 <Attributes>
   <Attribute
     name="recipients"
-    type="RecipientIdentifier[] (required)"
+    type="RecipientIdentifier[]"
     description="A list of user identifiers, object references, or inline recipient definitions to run this workflow for"
     typeSlug="/concepts/recipients#recipientidentifier-definition"
+    isRequired
   />
   <Attribute
     name="actor"
-    type="RecipientIdentifier (optional)"
+    type="RecipientIdentifier"
     description="An identifier of who or what performed this action"
     typeSlug="/concepts/recipients#recipientidentifier-definition"
   />
   <Attribute
     name="cancellation_key"
-    type="string (optional)"
+    type="string"
     description="The key to use for canceling the workflow"
   />
   <Attribute
     name="tenant"
-    type="string (optional)"
+    type="string"
     description="The id of the tenant that this workflow run should be associated with"
   />
   <Attribute
     name="data"
-    type="object (optional)"
+    type="object"
     description="A set of key-value pairs to pass to the workflow trigger"
   />
 </Attributes>
@@ -675,27 +676,28 @@ The workflow trigger endpoint enforces the following payload size limits:
 <Attributes>
   <Attribute
     name="recipients"
-    type="Recipient[] (required)"
+    type="Recipient[]"
     description="A list of maps of properties describing a user or an object to identify in Knock and trigger this workflow for"
+    isRequired
   />
   <Attribute
     name="actor"
-    type="Recipient (optional)"
+    type="Recipient"
     description="A map of properties describing a user or an object to identify in Knock and mark as who or what performed the action"
   />
   <Attribute
     name="cancellation_key"
-    type="string (optional)"
+    type="string"
     description="The key to use for canceling the workflow"
   />
   <Attribute
     name="tenant"
-    type="string (optional)"
+    type="string"
     description="The id of the tenant that this workflow run should be associated with"
   />
   <Attribute
     name="data"
-    type="object (optional)"
+    type="object"
     description="A set of key-value pairs to pass to the trigger call"
   />
 </Attributes>
@@ -834,27 +836,27 @@ A message is a notification delivered on a particular channel to a user.
   />
   <Attribute
     name="seen_at"
-    type="string (optional)"
+    type="string"
     description="When the message was last seen"
   />
   <Attribute
     name="read_at"
-    type="string (optional)"
+    type="string"
     description="When the message was last read"
   />
   <Attribute
     name="interacted_at"
-    type="string (optional)"
+    type="string"
     description="When the message was last interacted with"
   />
   <Attribute
     name="link_clicked_at"
-    type="string (optional)"
+    type="string"
     description="When a message link was last clicked"
   />
   <Attribute
     name="archived_at"
-    type="string (optional)"
+    type="string"
     description="When the message was archived"
   />
   <Attribute
@@ -1014,63 +1016,63 @@ Messages outside the account's retention window will not be included in the resu
   />
   <Attribute
     name="source"
-    type="string (optional)"
+    type="string"
     description="Limits the results to only items of the source workflow"
   />
   <Attribute
     name="tenant"
-    type="string (optional)"
+    type="string"
     description="Limits the results to items with the corresponding tenant, or where the tenant is empty"
   />
   <Attribute
     name="status"
-    type="string[] (optional)"
+    type="string[]"
     description="One or more of `queued`, `sent`, `delivered`, `delivery_attempted`, `undelivered`, `bounced`, `not_sent`. Limits results to messages with the given delivery status(es)."
   />
   <Attribute
     name="engagement_status"
-    type="string[] (optional)"
+    type="string[]"
     description="One or more of `read`, `unread`, `seen`, `unseen`, `archived`, `unarchived`, `interacted`, `link_clicked`. Limits results to messages with the given engagement status(es)."
   />
   <Attribute
     name="channel_id"
-    type="string (optional)"
+    type="string"
     description="Limits the results to only items that belong to the channel"
   />
   <Attribute
-    name="message_ids[]"
-    type="string[] (optional)"
+    name="message_ids"
+    type="string[]"
     description="Limits the results to only the message ids given (max 50). Note: when using this option, the results will be subject to any other filters applied to the query."
   />
   <Attribute
     name="workflow_categories"
-    type="string[] (optional)"
+    type="string[]"
     description="Limits the results to only items related to any of the provided categories"
   />
   <Attribute
     name="trigger_data"
-    type="JSON string (optional)"
+    type="JSON string"
     description="Limits the results to only items that were generated with the given data"
     nameSlug="#trigger-data-filtering"
   />
   <Attribute
     name="inserted_at.gt"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted after the given date"
   />
   <Attribute
     name="inserted_at.gte"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted after or equal to the given date"
   />
   <Attribute
     name="inserted_at.lt"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted before the given date"
   />
   <Attribute
     name="inserted_at.lte"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted before or equal to the given date"
   />
 </Attributes>
@@ -1290,7 +1292,7 @@ Returns a `404 Not Found` error for a message outside the account's retention wi
   />
   <Attribute
     name="trigger_data"
-    type="JSON string (optional)"
+    type="JSON string"
     description="Limits the results to only items that were generated with the given data"
     nameSlug="#trigger-data-filtering"
   />
@@ -1432,7 +1434,7 @@ Returns a `404 Not Found` error for a message outside the account's retention wi
 
 <Attributes>
   <Attribute
-    name="message_ids[]"
+    name="message_ids"
     type="string[]"
     description="The IDs of the messages (max 25)"
   />
@@ -1761,42 +1763,42 @@ For in-app channels, messages can be updated indefinitely via this operation. Fo
 <Attributes>
   <Attribute
     name="user_ids"
-    type="string[] (optional)"
+    type="string[]"
     description="Scope the bulk update to one or more users"
   />
   <Attribute
     name="tenants"
-    type="string[] (optional)"
+    type="string[]"
     description="A list of one or more tenants to match"
   />
   <Attribute
     name="has_tenant"
-    type="boolean (optional)"
+    type="boolean"
     description="When set to false, will only return messages that do not have a tenant associated"
   />
   <Attribute
     name="workflows"
-    type="string[] (optional)"
+    type="string[]"
     description="A list of one or more workflow keys to match"
   />
   <Attribute
     name="older_than"
-    type="string (optional)"
+    type="string"
     description="An ISO-8601 timestamp to find messages created before"
   />
   <Attribute
     name="newer_than"
-    type="string (optional)"
+    type="string"
     description="An ISO-8601 timestamp to find messages created after"
   />
   <Attribute
     name="delivery_status"
-    type="enum (optional)"
+    type="enum"
     description="Limit messages to one of `queued`, `sent`, `delivered`, `delivery_attempted`, `undelivered`, `bounced`, `not_sent`"
   />
   <Attribute
     name="engagement_status"
-    type="enum (optional)"
+    type="enum"
     description="Limit messages to one of `seen`, `unseen`, `read`, `unread`, `archived`, `unarchived`, `interacted`, `link_clicked`"
   />
 </Attributes>
@@ -2048,37 +2050,37 @@ along with a user token to make this request**
   />
   <Attribute
     name="source"
-    type="string (optional)"
+    type="string"
     description="Limits the feed to only items of the source workflow"
   />
   <Attribute
     name="tenant"
-    type="string (optional)"
+    type="string"
     description="Limits the feed to only display items with the corresponding tenant, or where the tenant is empty"
   />
   <Attribute
     name="has_tenant"
-    type="boolean (optional)"
+    type="boolean"
     description="Scope the feed to display items with or without any tenancy"
   />
   <Attribute
     name="status"
-    type="string (optional)"
+    type="string"
     description="One of `unread`,`read`, `unseen`,`seen`, `all`"
   />
   <Attribute
     name="workflow_categories"
-    type="string[] (optional)"
+    type="string[]"
     description="Limits the feed to only display items related to any of the provided categories"
   />
   <Attribute
     name="archived"
-    type="string (optional)"
+    type="string"
     description="One of `include`, `exclude`, `only` (defaults to `exclude`)"
   />
   <Attribute
     name="trigger_data"
-    type="JSON string (optional)"
+    type="JSON string"
     description="Limits the results to only items that were generated with the given data"
     nameSlug="#trigger-data-filtering"
   />
@@ -2103,14 +2105,15 @@ A user represents an individual who may need to receive a notification from Knoc
     name="id"
     type="string"
     description="Unique identifier for the user"
+    isRequired
   />
-  <Attribute name="name" type="string (optional)" description="The full name of the user" />
-  <Attribute name="email" type="string (optional)" description="The email of the user" />
-  <Attribute name="avatar" type="string (optional)" description="A URL for the avatar of the user" />
-  <Attribute name="phone_number" type="string (optional)" description="The phone number of the user to use with SMS channels" />
+  <Attribute name="name" type="string" description="The full name of the user" />
+  <Attribute name="email" type="string" description="The email of the user" />
+  <Attribute name="avatar" type="string" description="A URL for the avatar of the user" />
+  <Attribute name="phone_number" type="string" description="The phone number of the user to use with SMS channels" />
   <Attribute
     name="locale"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>The locale of the user. Used for </span>
@@ -2121,7 +2124,7 @@ A user represents an individual who may need to receive a notification from Knoc
   />
   <Attribute
     name="timezone"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>
@@ -2226,29 +2229,21 @@ Identifying a user will create or update a user in Knock, merging the properties
 ### Body parameters
 
 <Attributes>
-  <Attribute
-    name="name"
-    type="string (optional)"
-    description="The name of the user"
-  />
-  <Attribute
-    name="email"
-    type="string (optional)"
-    description="The email of the user"
-  />
+  <Attribute name="name" type="string" description="The name of the user" />
+  <Attribute name="email" type="string" description="The email of the user" />
   <Attribute
     name="avatar"
-    type="string (optional)"
+    type="string"
     description="A URL for the avatar of the user"
   />
   <Attribute
     name="phone_number"
-    type="string (optional)"
+    type="string"
     description="The phone number of the user to use with SMS channels"
   />
   <Attribute
     name="locale"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>The locale of the user. Used for </span>
@@ -2259,7 +2254,7 @@ Identifying a user will create or update a user in Knock, merging the properties
   />
   <Attribute
     name="timezone"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>
@@ -2276,13 +2271,13 @@ Identifying a user will create or update a user in Knock, merging the properties
   />
   <Attribute
     name="preferences"
-    type="object<string, PreferenceSet> (optional)"
+    type="object<string, PreferenceSet>"
     typeSlug="/reference#preferences"
     description="A set of preferences that determines whether a recipient should receive a particular type of notification."
   />
   <Attribute
     name="channel_data"
-    type="object<string, ChannelData> (optional)"
+    type="object<string, ChannelData>"
     typeSlug="/reference#channel-data"
     description="Channel-specific information that's needed to deliver a notification to an end provider."
   />
@@ -2482,63 +2477,63 @@ Messages outside the account's retention window will not be included in the resu
   />
   <Attribute
     name="source"
-    type="string (optional)"
+    type="string"
     description="Limits the results to only items of the source workflow"
   />
   <Attribute
     name="tenant"
-    type="string (optional)"
+    type="string"
     description="Limits the results to items with the corresponding tenant, or where the tenant is empty"
   />
   <Attribute
     name="status"
-    type="string[] (optional)"
+    type="string[]"
     description="One or more of `queued`, `sent`, `delivered`, `delivery_attempted`, `undelivered`, `bounced`, `not_sent`. Limits results to messages with the given delivery status(es)."
   />
   <Attribute
     name="engagement_status"
-    type="string[] (optional)"
+    type="string[]"
     description="One or more of `read`, `unread`, `seen`, `unseen`, `archived`, `unarchived`, `interacted`, `link_clicked`. Limits results to messages with the given engagement status(es)."
   />
   <Attribute
     name="channel_id"
-    type="string (optional)"
+    type="string"
     description="Limits the results to only items that belong to the channel"
   />
   <Attribute
-    name="message_ids[]"
-    type="string[] (optional)"
+    name="message_ids"
+    type="string[]"
     description="Limits the results to only the message ids given (max 50). Note: when using this option, the results will be subject to any other filters applied to the query."
   />
   <Attribute
     name="workflow_categories"
-    type="string[] (optional)"
+    type="string[]"
     description="Limits the results to only items related to any of the provided categories"
   />
   <Attribute
     name="trigger_data"
-    type="JSON string (optional)"
+    type="JSON string"
     description="Limits the results to only items that were generated with the given data"
     nameSlug="#trigger-data-filtering"
   />
   <Attribute
     name="inserted_at.gt"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted after the given date"
   />
   <Attribute
     name="inserted_at.gte"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted after or equal to the given date"
   />
   <Attribute
     name="inserted_at.lt"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted before the given date"
   />
   <Attribute
     name="inserted_at.lte"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted before or equal to the given date"
   />
 </Attributes>
@@ -2832,7 +2827,7 @@ when sending [Slack notifications](/integrations/slack).
   />
   <Attribute
     name="locale"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>The locale of the object. Used for </span>
@@ -2843,7 +2838,7 @@ when sending [Slack notifications](/integrations/slack).
   />
   <Attribute
     name="timezone"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>
@@ -3118,63 +3113,63 @@ Messages outside the account's retention window will not be included in the resu
   />
   <Attribute
     name="source"
-    type="string (optional)"
+    type="string"
     description="Limits the results to only items of the source workflow"
   />
   <Attribute
     name="tenant"
-    type="string (optional)"
+    type="string"
     description="Limits the results to items with the corresponding tenant, or where the tenant is empty"
   />
   <Attribute
     name="status"
-    type="string[] (optional)"
+    type="string[]"
     description="One or more of `queued`, `sent`, `delivered`, `delivery_attempted`, `undelivered`, `bounced`, `not_sent`. Limits results to messages with the given delivery status(es)."
   />
   <Attribute
     name="engagement_status"
-    type="string[] (optional)"
+    type="string[]"
     description="One or more of `read`, `unread`, `seen`, `unseen`, `archived`, `unarchived`, `interacted`, `link_clicked`. Limits results to messages with the given engagement status(es)."
   />
   <Attribute
     name="channel_id"
-    type="string (optional)"
+    type="string"
     description="Limits the results to only items that belong to the channel"
   />
   <Attribute
-    name="message_ids[]"
-    type="string[] (optional)"
+    name="message_ids"
+    type="string[]"
     description="Limits the results to only the message ids given (max 50). Note: when using this option, the results will be subject to any other filters applied to the query."
   />
   <Attribute
     name="workflow_categories"
-    type="string[] (optional)"
+    type="string[]"
     description="Limits the results to only items related to any of the provided categories"
   />
   <Attribute
     name="trigger_data"
-    type="JSON string (optional)"
+    type="JSON string"
     description="Limits the results to only items that were generated with the given data"
     nameSlug="#trigger-data-filtering"
   />
   <Attribute
     name="inserted_at.gt"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted after the given date"
   />
   <Attribute
     name="inserted_at.gte"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted after or equal to the given date"
   />
   <Attribute
     name="inserted_at.lt"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted before the given date"
   />
   <Attribute
     name="inserted_at.lte"
-    type="datetime (optional)"
+    type="datetime"
     description="Retrieves messages inserted before or equal to the given date"
   />
 </Attributes>
@@ -3271,7 +3266,7 @@ Sets an object within a collection, performing an upsert operation. Any existing
 <Attributes>
   <Attribute
     name="locale"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>The locale of the object. Used for </span>
@@ -3282,7 +3277,7 @@ Sets an object within a collection, performing an upsert operation. Any existing
   />
   <Attribute
     name="timezone"
-    type="string (optional)"
+    type="string"
     description={
       <>
         <span>
@@ -3300,13 +3295,13 @@ Sets an object within a collection, performing an upsert operation. Any existing
   />
   <Attribute
     name="preferences"
-    type="object<string, PreferenceSet>  (optional)"
+    type="object<string, PreferenceSet>"
     typeSlug="/reference#preferences"
     description="A set of preferences that determines whether a recipient should receive a particular type of notification."
   />
   <Attribute
     name="channel_data"
-    type="object<string, ChannelData> (optional)"
+    type="object<string, ChannelData>"
     typeSlug="/reference#channel-data"
     description="Channel-specific information that's needed to deliver a notification to an end provider."
   />
@@ -3868,7 +3863,7 @@ Adds one or more recipients as subscribers to the object by creating subscriptio
   />
   <Attribute
     name="properties"
-    type="map (optional)"
+    type="object"
     description="An optional set of key-value pairs to associate with the subscriptions"
   />
 </Attributes>
@@ -5138,13 +5133,13 @@ A schedule allows you to automatically trigger a workflow at a given time for on
     description="A list of one or more repeat definitions that determine when this schedule should run."
   />
   <Attribute
-    name="last_occurrence_at | null"
-    type="datetime (optional)"
+    name="last_occurrence_at"
+    type="datetime | null"
     description="A datetime string in UTC that indicates when the last run for the schedule happened."
   />
   <Attribute
-    name="next_occurrence_at | null"
-    type="datetime (optional)"
+    name="next_occurrence_at"
+    type="datetime | null"
     description="A datetime string in the recipient's timezone that indicates when the schedule will next run, generated from the repeat rules."
   />
 </Attributes>
@@ -5246,8 +5241,9 @@ Returns a paginated list of schedules in descending order.
   />
   <Attribute
     name="workflow"
-    type="string (required)"
+    type="string"
     description="The workflow key to filter schedules for."
+    isRequired
   />
   <Attribute
     name="recipients"
@@ -5353,8 +5349,9 @@ Returns a paginated list of schedules for a single user, in descending order.
   />
   <Attribute
     name="workflow"
-    type="string (required)"
+    type="string"
     description="The workflow key to filter schedules for."
+    isRequired
   />
   <Attribute
     name="tenant"
@@ -5455,8 +5452,9 @@ Returns a paginated list of schedules for a single object, in descending order.
   />
   <Attribute
     name="workflow"
-    type="string (required)"
+    type="string"
     description="The workflow key to filter schedules for."
+    isRequired
   />
   <Attribute
     name="tenant"

From cd9a80feac739f706567506d5c535c6cf5e6356d Mon Sep 17 00:00:00 2001
From: Rachael Thomas <rnthomas001@gmail.com>
Date: Thu, 2 Jan 2025 13:51:15 -0700
Subject: [PATCH 2/4] Add required tag for cancellation_key

---
 content/reference.mdx                              |  1 +
 content/send-notifications/canceling-workflows.mdx | 10 +++++-----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/content/reference.mdx b/content/reference.mdx
index 1eb72fd4..1a4defe3 100644
--- a/content/reference.mdx
+++ b/content/reference.mdx
@@ -763,6 +763,7 @@ The workflow cancellation endpoint enforces the following payload size limits:
     name="cancellation_key"
     type="string"
     description="The cancellation key unique to the trigger call"
+    isRequired
   />
   <Attribute
     name="recipients"
diff --git a/content/send-notifications/canceling-workflows.mdx b/content/send-notifications/canceling-workflows.mdx
index 2a8bd354..0fb7bf0a 100644
--- a/content/send-notifications/canceling-workflows.mdx
+++ b/content/send-notifications/canceling-workflows.mdx
@@ -26,11 +26,11 @@ You can read about generating workflow cancellation keys and some best practices
 
 ### Schema
 
-| Property         | Type                  | Description                                                                    |
-| ---------------- | --------------------- | ------------------------------------------------------------------------------ |
-| key\*            | string                | The human readable key of the workflow from the Knock dashboard                |
-| cancellation_key | string                | A unique identifier for the workflow run                                       |
-| recipients       | RecipientIdentifier[] | A list of specific recipient identifiers to cancel the workflow for (optional) |
+| Property           | Type                  | Description                                                                    |
+| ------------------ | --------------------- | ------------------------------------------------------------------------------ |
+| key\*              | string                | The human readable key of the workflow from the Knock dashboard                |
+| cancellation_key\* | string                | A unique identifier for the workflow run                                       |
+| recipients         | RecipientIdentifier[] | A list of specific recipient identifiers to cancel the workflow for (optional) |
 
 ## Canceling for subsets of recipients
 

From 2c77e7da0582c24fdc210b8d1caf0fe9f98d2f5c Mon Sep 17 00:00:00 2001
From: Rachael Thomas <rnthomas001@gmail.com>
Date: Fri, 3 Jan 2025 15:09:10 -0700
Subject: [PATCH 3/4] Add missing required tags

---
 content/reference.mdx | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/content/reference.mdx b/content/reference.mdx
index 1a4defe3..4892ff4f 100644
--- a/content/reference.mdx
+++ b/content/reference.mdx
@@ -2663,6 +2663,7 @@ Merges the two users together, merging the user specified in the `from_user_id`
     name="from_user_id"
     type="string"
     description="Unique identifier of the user to merge from"
+    isRequired
   />
 </Attributes>
 
@@ -2712,6 +2713,7 @@ Identifies up to 1000 users at a time. Returns a `BulkOperation` that executes t
     type="User[]"
     description="A list of users to upsert"
     typeSlug="#users"
+    isRequired
   />
 </Attributes>
 
@@ -2770,6 +2772,7 @@ Deletes up to 1000 users at a time. Returns a `BulkOperation` that executes the
     name="user_ids"
     type="string[]"
     description="Unique identifiers of the users to delete"
+    isRequired
   />
 </Attributes>
 
@@ -3420,6 +3423,7 @@ Bulk sets up to 1000 objects at a time within a collection. Returns a `BulkOpera
     name="objects[].id"
     type="string"
     description="The id of the object to set."
+    isRequired
   />
   <Attribute
     name="objects[].*"
@@ -3497,6 +3501,7 @@ Bulk deletes up to 1000 objects at a time within a collection. Returns a `BulkOp
     name="object_ids"
     type="string[]"
     description="The ids of the objects to delete within the collection"
+    isRequired
   />
 </Attributes>
 
@@ -3861,6 +3866,7 @@ Adds one or more recipients as subscribers to the object by creating subscriptio
     type="RecipientIdentifier[]"
     description="A list of recipient identifiers. You can subscribe up to 100 recipients to an object at a time."
     typeSlug="/concepts/recipients#recipientidentifier-definition"
+    isRequired
   />
   <Attribute
     name="properties"
@@ -3943,6 +3949,7 @@ Returns a `BulkOperation` that executes the job asynchronously. Progress can be
     name="subscriptions"
     type="AddSubscriptionsOp[]"
     description="A list of subscriptions to create. Each entry represents a set of Recipients to subscribe to an Object."
+    isRequired
   />
 </Attributes>
 
@@ -4036,6 +4043,7 @@ Removes one or more recipients as subscribers to the object.
     type="RecipientIdentifier[]"
     description="A list of recipient identifiers"
     typeSlug="/concepts/recipients#recipientidentifier-definition"
+    isRequired
   />
 </Attributes>
 
@@ -4738,6 +4746,7 @@ Please note: This is a destructive operation and will replace any existing users
     name="user_ids"
     type="string[]"
     description="A list of user ids to set preferences for"
+    isRequired
   />
   <Attribute
     name="preferences.id"
@@ -5009,9 +5018,15 @@ Sets a tenant within an environment, performing an upsert operation. Any existin
   />
   <Attribute
     name="settings"
-    type="object"
+    type="object<string, TenantSettings>"
+    typeSlug="/concepts/tenants#tenantsettings"
     description="An object of key-value pairs for configurable settings on a tenant. Currently contains a preference_set key for tenant-specific default preferences, as well as a branding key which points to the following configurable values: primary_color, primary_color_contrast, icon_url, and logo_url. The icon_url and logo_url settings must be a valid image URL with an image MIME type."
 />
+  <Attribute
+    name="*"
+    type="any"
+    description="A collection of key value pairs to set as properties for this tenant."
+  />
 
 </Attributes>
 

From be74b33b7911509548987993bd8135399da5a6c4 Mon Sep 17 00:00:00 2001
From: Rachael Thomas <rnthomas001@gmail.com>
Date: Thu, 9 Jan 2025 17:29:49 -0700
Subject: [PATCH 4/4] Update

---
 content/reference.mdx | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/content/reference.mdx b/content/reference.mdx
index 4892ff4f..3afff426 100644
--- a/content/reference.mdx
+++ b/content/reference.mdx
@@ -5555,6 +5555,7 @@ Creates new schedules for the recipients provided. Up to 100 recipients may be s
     type="RecipientIdentifier[]"
     description="A list of recipient identifiers"
     typeSlug="/concepts/recipients#recipientidentifier-definition"
+    isRequired
   />
   <Attribute
     name="actor"
@@ -5570,6 +5571,7 @@ Creates new schedules for the recipients provided. Up to 100 recipients may be s
     name="workflow"
     type="string"
     description="The key of the workflow that will be triggered in this schedule."
+    isRequired
   />
   <Attribute
     name="tenant"
@@ -5579,6 +5581,7 @@ Creates new schedules for the recipients provided. Up to 100 recipients may be s
   <Attribute
     name="repeats"
     type="ScheduleRepeat[] | null"
+    typeSlug="/concepts/schedules#schedulerepeat-properties"
     description="A list of one or more repeat definitions that determine when this schedule should run."
   />
   <Attribute
@@ -5674,6 +5677,7 @@ Updates the schedules for the `schedule_ids` given. Can update up to 100 schedul
     name="schedule_ids"
     type="string[]"
     description="A list of schedule ids of the schedules to mutate."
+    isRequired
   />
   <Attribute
     name="actor"
@@ -5788,6 +5792,7 @@ Deletes the schedules for the `schedule_ids` given. Can delete up to 100 schedul
     name="schedule_ids"
     type="string[]"
     description="A list of schedule ids of the schedules to mutate."
+    isRequired
   />
 </Attributes>
 
@@ -6019,6 +6024,7 @@ If no user exists in the current environment for the given :user_id, Knock will
         .
       </p>
     }
+    isRequired
   />
 </Attributes>
 
@@ -6193,6 +6199,7 @@ If no object exists in the current environment for the given :collection and :ob
         .
       </p>
     }
+    isRequired
   />
 </Attributes>
 
@@ -6444,6 +6451,7 @@ A `BulkOperation`
     name="access_token_object"
     type="AccessTokenObject"
     description="An object containing the `object_id` and `collection` of the Object or Tenant that contains the access token for Slack."
+    isRequired
   />
 </Attributes>
 
@@ -6542,6 +6550,7 @@ Get a list of the Slack channels for the access token stored in the given access
     name="access_token_object"
     type="AccessTokenObject"
     description="An object containing the `object_id` and `collection` of the Object or Tenant that contains the access token for Slack."
+    isRequired
   />
   <Attribute
     name="query_options"
@@ -6638,6 +6647,7 @@ Revoke an access token from Slack and remove it from the access token object.
     name="access_token_object"
     type="AccessTokenObject"
     description="An object containing the `object_id` and `collection` of the Object or Tenant that contains the access token for Slack."
+    isRequired
   />
 </Attributes>
 
@@ -6855,6 +6865,7 @@ Adds members to an audience. The same user can be added to the audience multiple
     name="members"
     type="object[]"
     description="Members to add to the audience. The `tenant` field is optional. Max length is 1000."
+    isRequired
   />
 </Attributes>
 
@@ -6933,6 +6944,7 @@ Removes members from an audience. If a member was added with a tenant ID, that t
     name="members"
     type="object[]"
     description="Members to remove from the audience. The `tenant` field is optional. Max length is 1000."
+    isRequired
   />
 </Attributes>