@devrev-computer/skills 1.0.0

package/skills/create-workflow-template/operations/schemas/update_meeting.md

@@ -0,0 +1,114 @@
+# `update_meeting` — Schema Reference
+
+## Input Port: `input`
+
+- **`artifacts`** (`composite`)
+  - Composite: `_gen:artifacts`
+  - **`set`** (`[]id`) — Sets the IDs to the provided artifact IDs.
+    - ID type: `artifact`
+- **`channel`** (`enum`) — The channel of meeting.
+  - Allowed: `amazon_connect`, `google_meet`, `offline`, `other`, `teams`, `zoom`
+- **`description`** (`text`) — The description of the meeting.
+- **`ended_date`** (`timestamp`) — Updates the date and time when the meeting ended.
+- **`external_ref`** (`text`) — External Reference for the meeting.
+- **`external_url`** (`text`) — External platform URL of the meeting
+- **`id`** (`id`) **REQUIRED** — The meetings ID.
+  - ID type: `meeting`
+- **`members`** (`composite`)
+  - Composite: `_gen:members`
+  - **`set`** (`[]id`) — Sets the members to the provided user IDs. This must not be empty.
+    - ID type: `devu`, `revu`, `svcacc`, `sysu`
+- **`organizer`** (`id`) — The ID of the user who organized the meeting.
+  - ID type: `devu`, `revu`, `svcacc`, `sysu`
+- **`scheduled_date`** (`timestamp`) — Updates the date and time when the meeting was scheduled.
+- **`state`** (`enum`) — The state of meeting.
+  - Allowed: `canceled`, `completed`, `no_show`, `ongoing`, `rejected`, `rescheduled`, `scheduled`, `waiting`
+- **`title`** (`text`) — The title of the meeting.
+
+## Output Port: `output`
+
+- **`artifacts`** (`[]composite`)
+  - Composite: `_gen:artifact-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`file`** (`composite`) — Defines a file object.
+    - Composite: `_gen:file`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `artifact`
+- **`channel`** (`enum`) — The channel of meeting.
+  - Allowed: `amazon_connect`, `google_meet`, `offline`, `other`, `teams`, `zoom`
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`description`** (`text`) — Description of the meeting.
+- **`direction`** (`enum`) — Direction of meeting - meetings within an organization are internal. Meetings with external customers can be incoming or outgoing depending on who initiates them.
+  - Allowed: `incoming`, `internal`, `outgoing`
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`ended_date`** (`timestamp`) — Time at which meeting ended.
+- **`external_ref`** (`text`) — External reference of the meeting. This is the identifier from the meeting channel/provider.
+- **`external_url`** (`text`) — External platform URL of the meeting
+- **`members`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`, `revu`
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`organizer`** (`composite`)
+  - Composite: `_gen:organizer`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`, `revu`
+- **`scheduled_date`** (`timestamp`) — Time at which meeting was scheduled to start.
+- **`state`** (`enum`) — The state of meeting.
+  - Allowed: `canceled`, `completed`, `no_show`, `ongoing`, `rejected`, `rescheduled`, `scheduled`, `waiting`
+- **`tags`** (`[]composite`) — Tags associated with the meeting.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`title`** (`text`) — Title of the meeting object.
+- **`visibility`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:visibility`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `meeting`

package/skills/create-workflow-template/operations/schemas/update_opportunity.md

@@ -0,0 +1,137 @@
+# `update_opportunity` — Schema Reference
+
+## Input Port: `input`
+
+- **`account`** (`id`) — Updates the account that the opportunity is associated with
+  - ID type: `account`
+- **`body`** (`text`) — Updated body of the opportunity object, or unchanged if not provided.
+  - Validation: max_len=65536
+- **`contacts`** (`composite`)
+  - Composite: `_gen:contacts`
+  - **`set`** (`[]id`) **REQUIRED** — Sets the contact IDs to the provided contact IDs.
+    - ID type: `revu`
+- **`customer_budget`** (`double`) — Updates the customer budget.
+- **`forecast_category_v2`** (`uenum`) — Forecast category enum ID of an opportunity. The allowed ids can be extended by the user. Stock allowed values: ```   {     "id": 1,     "label": "Omitted",     "ordinal": 1,     "overridable": true   },   {     "id": 2,     "label": "Pipeline",     "ordinal": 2,     "overridable": true   },   {     "id": 3,     "label": "Upside",     "ordinal": 3,     "overridable": true   },   {     "id": 4,     "label": "Strong Upside",     "ordinal": 4,     "overridable": true   },   {     "id": 5,     "label": "Commit",     "ordinal": 5,     "overridable": true   },   {     "id": 6,     "label": "Won",     "ordinal": 6,     "overridable": true   } ```
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — Sets the owner IDs to the provided user IDs. This must not be empty.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`probability`** (`double`) — Updates the probability of winning the deal, lies between 0 to 100.
+- **`reported_by`** (`composite`)
+  - Composite: `_gen:reported_by`
+  - **`set`** (`[]id`) — Sets the users that reported the work to the provided user IDs.
+    - ID type: `devu`, `revu`, `svcacc`, `sysu`
+- **`tags`** (`composite`)
+  - Composite: `_gen:tags`
+  - **`add`** (`[]composite`) — Adds the provided tags on the opportunity. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:add`
+  - **`remove`** (`[]composite`) — Removes the provided tags on the opportunity. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:remove`
+- **`target_close_date`** (`timestamp`) — Updates the timestamp for when the opportunity is expected to be complete.
+- **`title`** (`text`) — Updated title of the opportunity object, or unchanged if not provided.
+  - Validation: min_len=1, max_len=256
+- **`value`** (`composite`) — The value of the opportunity in USD.
+  - Composite: `_gen:value`
+  - **`amount`** (`text`) **REQUIRED** — The amount.
+  - **`currency`** (`text`) **REQUIRED** — The currency code conforming ISO 4217 standard.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `opportunity`
+- **`stage`** (`id`) — The stage of the opportunity.
+  - ID type: `custom_stage`
+- **`annual_contract_value`** (`composite`) — Annual contract value of an opportunity in USD
+  - Composite: `_gen:annual_contract_value`
+  - **`amount`** (`text`) — The amount of money associated with the contract.
+  - **`currency`** (`text`) — The currency code conforming ISO 4217 standard.
+
+## Output Port: `output`
+
+- **`account`** (`composite`)
+  - Composite: `_gen:account`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`id`** (`id`) **REQUIRED** — ID of an account.
+    - ID type: `account`
+- **`actual_close_date`** (`timestamp`) — Timestamp when the opportunity was actually closed.
+- **`annual_contract_value`** (`composite`) — Annual contract value of an opportunity in USD
+  - Composite: `_gen:annual_contract_value`
+  - **`amount`** (`text`) — Amount of the money.
+  - **`currency`** (`text`) — Currency of the money.
+- **`body`** (`text`) — The description of the opportunity.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the opportunity was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+- **`forecast_category_v2`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:forecast_category_v2`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the opportunity was last modified.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`reported_by`** (`[]composite`)
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`stage`** (`composite`) — Describes the current stage of a opportunity
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) **REQUIRED** — Describes the current stage of a opportunity
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Timestamp when the opportunity is expected to be closed.
+- **`title`** (`text`) **REQUIRED** — Title of the opportunity.
+- **`value`** (`composite`) — The value of the opportunity in USD.
+  - Composite: `_gen:value`
+  - **`amount`** (`text`) — Amount of the money.
+  - **`currency`** (`text`) — Currency of the money.
+- **`id`** (`id`) **REQUIRED** — The opportunity which was updated.
+  - ID type: `opportunity`

package/skills/create-workflow-template/operations/schemas/update_question_answer.md

@@ -0,0 +1,60 @@
+# `update_question_answer` — Schema Reference
+
+## Input Port: `input`
+
+- **`access_level`** (`enum`)
+  - Allowed: `external`, `internal`, `private`, `public`, `restricted`
+- **`answer`** (`text`) — Updates answer of the question-answer object, or unchanged if not provided.
+- **`applies_to_parts`** (`composite`)
+  - Composite: `_gen:applies_to_parts`
+  - **`set`** (`[]id`) — Updates the parts that the question-answer applies to.
+    - ID type: `capability`, `component`, `custom_part`, `enhancement`, `feature`, `linkable`, `microservice`, `product`, `runnable`
+- **`id`** (`id`) **REQUIRED** — The question-answer's ID.
+  - ID type: `question_answer`
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — Sets the owner IDs to the provided user IDs. This must not be empty.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`question`** (`text`) — Updates question of the question-answer object, or unchanged if not provided.
+- **`sources`** (`composite`)
+  - Composite: `_gen:sources`
+  - **`set`** (`[]id`) — Sets the sources that generated the question-answer.
+    - ID type: `conversation`
+- **`status`** (`enum`) — Status of the question answer.
+  - Allowed: `archived`, `discarded`, `draft`, `published`, `review_needed`
+
+## Output Port: `output`
+
+- **`answer`** (`text`) — The Answer.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_date`** (`timestamp`) — Timestamp when the QA was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`modified_date`** (`timestamp`) — Timestamp when the QA was modified.
+- **`question`** (`text`) — The Question.
+- **`status`** (`enum`) — Status of the question answer.
+  - Allowed: `archived`, `discarded`, `draft`, `published`, `review_needed`
+- **`id`** (`id`) **REQUIRED** — The ID of the created QA.
+  - ID type: `question_answer`

package/skills/create-workflow-template/operations/schemas/update_ticket.md

@@ -0,0 +1,188 @@
+# `update_ticket` — Schema Reference
+
+## Input Port: `input`
+
+- **`id`** (`id`) **REQUIRED** — The id of the ticket.
+  - ID type: `ticket`
+- **`title`** (`text`) — Updated title of the ticket, or unchanged if not provided.
+  - Validation: min_len=1, max_len=256
+- **`body`** (`text`) — Updated body of the ticket, or unchanged if not provided.
+  - Validation: max_len=65536
+- **`group`** (`id`) — Updates the group that the ticket is associated with.
+  - ID type: `group`
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — Sets the owner IDs to the provided user IDs. This must not be empty.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`applies_to_part`** (`id`) — Updates the part that the ticket applies to.
+  - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`severity`** (`enum`) — Severity of the ticket.
+  - Allowed: `blocker`, `high`, `low`, `medium`
+- **`is_spam`** (`bool`) — Updates whether the ticket is spam.
+- **`needs_response`** (`bool`) — Updates whether the ticket needs a response.
+- **`reported_by`** (`composite`)
+  - Composite: `_gen:reported_by`
+  - **`set`** (`[]id`) — Sets the users that reported the work to the provided user IDs.
+    - ID type: `devu`, `sysu`, `svcacc`, `revu`
+- **`rev_org`** (`id`) — Updates the workspace that the ticket is associated with.
+  - ID type: `revo`
+- **`tags`** (`composite`)
+  - Composite: `_gen:tags`
+  - **`add`** (`[]composite`) — Adds the provided tags on the ticket. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:add`
+  - **`remove`** (`[]composite`) — Removes the provided tags on the ticket. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:remove`
+- **`target_close_date`** (`timestamp`) — Updates the timestamp for when the ticket is expected to be complete.
+- **`account`** (`id`) — Updates the account that the ticket is associated with.
+  - ID type: `account`
+- **`channels`** (`composite`)
+  - Composite: `_gen:channels`
+  - **`set`** (`[]enum`) — Sets the channels to the provided channels.
+    - Allowed: `email`, `plug`, `slack`, `twilio`, `twilio_sms`
+- **`is_frozen`** (`bool`) — Whether the ticket is frozen.
+- **`sentiment`** (`uenum`) — The sentiment of the ticket.
+- **`sentiment_modified_date`** (`timestamp`) — Timestamp at which sentiment was last modified.
+- **`sentiment_summary`** (`text`) — Summary justifying the current sentiment.
+- **`stage`** (`id`) — The stage of the ticket.
+  - ID type: `custom_stage`
+- **`visibility`** (`uenum`) — Visibility enum ID of the ticket. Choose 'internal' for tickets only visible to your team members, or 'external' for tickets that can be shared with customers and external stakeholders.
+
+## Output Port: `output`
+
+- **`account`** (`composite`)
+  - Composite: `_gen:account`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`id`** (`id`) **REQUIRED** — The id of the account.
+    - ID type: `account`
+- **`actual_close_date`** (`timestamp`) — Timestamp when the work was actually completed.
+- **`applies_to_part`** (`composite`)
+  - Composite: `_gen:applies_to_part`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+  - **`id`** (`id`) **REQUIRED** — The id of the part.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`body`** (`text`) — The body of the ticket.
+- **`channels`** (`[]enum`) — Channels of the ticket.
+  - Allowed: `email`, `plug`, `slack`, `twilio`, `twilio_sms`
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user
+    - ID type: `devu`, `sysu`, `svcacc`, `revu`
+- **`created_date`** (`timestamp`) — Timestamp when the ticket was created.
+- **`display_id`** (`text`) — Display ID of the ticket.
+- **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+- **`group`** (`composite`)
+  - Composite: `_gen:group`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`id`) **REQUIRED** — The id of the group
+    - ID type: `group`
+- **`is_frozen`** (`bool`) — Whether the object is frozen or not.
+- **`is_spam`** (`bool`) — Whether the ticket is spam.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the ticket was modified.
+- **`needs_response`** (`bool`) — Whether the ticket needs a response.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`reported_by`** (`[]composite`)
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`rev_org`** (`composite`)
+  - Composite: `_gen:rev_org`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `account`, `rev_org`
+  - **`id`** (`id`) **REQUIRED** — The id of the workspace.
+    - ID type: `revo`
+- **`sentiment`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:sentiment`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`label`** (`enum`) **REQUIRED** — The display label of the enum value.
+    - Allowed: `Delighted`, `Happy`, `Neutral`, `Unhappy`, `Frustrated`
+- **`sentiment_modified_date`** (`timestamp`) — Timestamp when the sentiment was last modified.
+- **`sentiment_summary`** (`text`) — Summary justifying the sentiment.
+- **`severity`** (`enum`) — Severity of the ticket.
+  - Allowed: `blocker`, `high`, `low`, `medium`
+- **`source_channel`** (`text`) — Source channel of the ticket.
+- **`stage`** (`composite`) — Current stage of the ticket.
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) **REQUIRED** — Current stage name of the work item.
+  - **`stage`** (`composite`) — The stage of the ticket.
+    - Composite: `stage.stage`
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`tags`** (`[]composite`) — Tags associated with the ticket.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Timestamp when the ticket is expected to be complete.
+- **`title`** (`text`) **REQUIRED** — Title of the ticket.
+- **`visibility`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:visibility`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`id`** (`id`) **REQUIRED** — The id of the ticket.
+  - ID type: `ticket`