--- schema_version: "1" id: dcae1df9cd1144378c388039225e77cdad5ae36a1bab15711805cc7cced34bb9 title: AiGenActionItem collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_aigenactionitem.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_aigenactionitem.htm source_site: developer.salesforce.com content_type: documentation content_hash: 72d99f8ed5814eedff02d6206039c470943d2977d76e3e90e052319c34967bcc description: Represents business actions suggested by generative AI. AI-generated action items are sent to either agents for automatic execution or human users for review, depending on org preference and if there are any errors in the process. This object is available in API version 64.0 and later. --- # AiGenActionItem Represents business actions suggested by generative AI. AI-generated action items are sent to either agents for automatic execution or human users for review, depending on org preference and if there are any errors in the process. This object is available in API version 64.0 and later. ## Supported Calls create( ), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert ( ) ## Special Access Rules Agentforce Pipeline Management must be enabled. Only the agent user can create AiGenActionItem records. ## Fields | Field | Details | | --- | --- | | ActionItemOwnerId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Required. The ID associated with the owner of the AI-generated action item. The owner can be an agent or human user, and can change during the review and execution process. By default, the owner is an agent or queue. This field is a polymorphic relationship field. Relationship Name ActionItemOwner Refers To Group, User | | ActionResult | Type textarea Properties Create, Nillable, Update Description The result generated when the agent action is executed. | | AgentType | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description Required. The specific agent that processes the AI-generated action item. | | AiGenActionItemInfoId | Type reference Properties Filter, Group, Nillable, Sort, Update Description Required. The ID of the AI-generated action item information record associated with this action item. Available in API version 67.0 and later. This field is a relationship field. Relationship Name AiGenActionItemInfo Refers To AiGenActionItemInfo | | BotDefinitionId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The bot record with a template name that matches the value in the Sales Management agent template. This field is a relationship field. Relationship Name BotDefinition Refers To BotDefinition | | BotVersionId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The bot version from the bot record with an ID that matches the ID of the Sales Management agent bot record. This field is a relationship field. Relationship Name BotVersion Refers To BotVersion | | Description | Type string Properties Create, Filter, Nillable, Sort, Update Description The explanation of why the action item has been suggested. The description provides additional context to guide human users and agents in their decision-making. | | ExpirationDate | Type dateTime Properties Create, Filter, Sort, Update Description Required. The date that the action item expires and is deleted. AI-generated action items are no longer visible to users after 14 days and removed from records after 30 days. | | GeneratedResponseIdRef | Type string Properties Filter, Group, Nillable, Sort Description The ID of generated result in the GenAIGeneration DMO. This field can be used by human users to provide feedback on the AI-generated action item. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The ID of the owner of this object. This field is a polymorphic relationship field. Relationship Name Owner Refers To Group, User | | ParentId | Type reference Properties Filter, Group, Sort, Update Description Required. The ID of the record that the AI-generated action item is associated with. Available in API version 67.0 and later. This field is a polymorphic relationship field. Relationship Name Parent Refers To Account, Opportunity | | Status | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description Required. The status of the AI-generated action item. | | Subject | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Required. The subject line that displays to users indicating what the action item is. | | SuggestedNewValue | Type textarea Properties Nillable, Update Description The new field value suggested by generative AI for the action item. Available in API version 67.0 and later. | | Type | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description Required. The category that the action item falls under. This field can be used to search for specific action items, such as field updates or follow-up sales emails. | | UnmodActionItemOutput | Type textarea Properties Nillable Description Required. The unmodified output for the action item produced by AI, whether from a prompt template or other generation method. | | Utterance | Type textarea Properties Nillable, Update Description The user utterance or prompt that generated this action item. Available in API version 67.0 and later. |