--- schema_version: "1" id: ef5ea8c39938d8f4c1583430814e29cd3c72a1ea12988d08739918d64c17b5aa title: FlowOrchestrationWorkItem collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_floworchestrationworkitem.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_floworchestrationworkitem.htm source_site: developer.salesforce.com content_type: documentation content_hash: 87e56f2554f4647774a3001523a1223b35f7bd2c96a42936c75120c4cc54e5b1 description: Represents a work item associated with a run-time instance of an interactive step in a run-time instance of an orchestration. This object is available in API version 54.0 and later. --- # FlowOrchestrationWorkItem Represents a work item associated with a run-time instance of an interactive step in a run-time instance of an orchestration. This object is available in API version 54.0 and later. ## Supported Calls create(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), update(), upsert() ## Special Access Rules An assignee can see all work item records assigned to them. If sharing rules are defined for FlowOrchestrationWorkItem, they determine access to specific orchestration work item records for users other than the assignee. Or the user must have the View All Data permission. ## Fields | Field | Details | | --- | --- | | AssigneeId | Type reference Properties Create, Filter, Group, Sort, Update Description The ID of the user, group, or queue assigned to the orchestration work item. This field is a polymorphic relationship field. Relationship Name Assignee Relationship Type Lookup Refers To Group (Type = Regular), Group (Type = Queue), User | | Description | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The description of the orchestration work item. | | ElapsedTimeSinceAsgntInSec | Type long Properties Filter, Group, Nillable, Sort Description When status is Assigned, the number of seconds that have passed since the work item was last assigned. When status is Completed, this value is null. This field is available in API version 63.0 and later. | | ElapsedTimeSinceCreationInSec | Type long Properties Filter, Group, Nillable, Sort Description When status is Assigned, the number of seconds that have passed since the work item was created. When status is Completed, this value is null. This field is available in API version 63.0 and later. | | FlowType | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The flow type of the orchestration that created the orchestration work item. Valid values are: - ApprovalOrchAutolnch—Autolaunched Flow Approval Process - ApprovalOrchRecTrigAftSave—Record-Triggered After Save Flow Approval Process - ExtSysChgFlowAppvl—External System Change-Triggered Flow Approval Process - ExtSysChgOrch—External System Change-Triggered Orchestration - OrchAutolnch—Autolaunched No Trigger Orchestration - OrchRecTrigAftSave—Record-Triggered After Save Orchestration This field is available in API version 62.0 and later. | | Label | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The label of the orchestration work item. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The most recent time a user viewed a record related to the orchestration work item. This field is available in API version 55.0 and later. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The most recent time a user viewed the orchestration work item. This field is available in API version 55.0 and later. | | Name | Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The API name of the orchestration work item. | | OrchestrationName | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The API name of the orchestration associated with the orchestration work item. This field is avavilable in API version 56.0 and later. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description When the assignee is an internal user: the ID of the internal user When the assignee is a credentialed Experience Cloud site visitor: the ID of the credentialed Experience Cloud site visitor When the assignee is a group or queue: the ID of the automated process user This field is available in API version 56.0 and later. Relationship Name Owner Relationship Type Lookup Refers To Group (Type = Regular), Group (Type = Queue), User | | ParentWorkItemId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the parent orchestration work item. When multiple group members receive child work items, this field links each child to its parent. This field is available in API version 67.0 and later. Relationship Name ParentWorkItem Relationship Type Lookup Refers To FlowOrchestrationWorkItem | | RelatedRecordId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the context record, such as an account, case, or expense, that the orchestration work item is related to. An assigned user completes the associated orchestration work item on the page for this record. This field is a polymorphic relationship field. Relationship Name RelatedRecord Relationship Type Lookup Refers To All objects except AccountContactRelation, AccountTeamMember, ActiveScratchOrg, ActivityMetric, ActivityMetricRollup,CampaignMember, CartCheckoutSession, CartDeliveryGroup, CartDeliveryGroupMethod, ChatterActivity,CollaborationGroupMember, ContentDesignKit, ContentDesignKitVersion, ConversationBroadcastEntry,ConversationReason, ConversationReasonExcerpt, ConversationReasonGroup, CustomPersonDataTemplate,ElectronicMediaGroup, EngagementScore, Event, FeedItem, FlowOrchestrationWorkItem, FtestDelPlatform1,FtestDelPlatform2, FtestFormulaFieldRefSql,HighScaleSample, HighScaleSampleItem, LegalEntity, LocationWaitlist, LocationWaitlistedParty,LocWaitlistMsgTemplate, ManagedContentVersion, MessagingEndUser, MessagingSession, MLModel,MLModelFactor, MLModelFactorComponent, NetworkMember, NetworkMemberChunk, OpportunityContactRole,OpportunityLineItem, OpportunityScore, OpportunityTeamMember, OrgSnapshot, PaymentTermItem,RequestsForAccessSIQ, ScoreIntelligence, ScratchOrgInfo, SharingRecordCollection, SharingRecordCollectionItem,SharingRecordCollectionMember, StreamActivityAccess, Survey, SurveyMessagingChannel, SurveyPage,SurveyQuestionChoice, SurveyVersion, Task, TenantSecurityAlertRuleSelectedTenant, TenantSecurityApiAnomaly,TenantSecurityConnectedApp, TenantSecurityCredentialStuffing, TenantSecurityHealthCheckBaselineTrend,TenantSecurityHealthCheckDetail, TenantSecurityHealthCheckTrend, TenantSecurityLogin, TenantSecurityMetricDetail,TenantSecurityMetricDetailLink, TenantSecurityMobilePolicyTrend, TenantSecurityMonitorMetric,TenantSecurityNotification, TenantSecurityNotificationRule, TenantSecurityPackage, TenantSecurityPolicy,TenantSecurityPolicyChangeLog, TenantSecurityPolicyDeployment, TenantSecurityPolicySelectedTenant,TenantSecurityReportAnomaly, TenantSecuritySessionHijacking, TenantSecurityTenantChangeLog,TenantSecurityTenantInfo, TenantSecurityTrustedIpRangeTrend, TenantSecurityUserActivity, TenantSecurityUserPerm,TenantSecurityWebsite, TopicAssignment, UserExternalCredential, VoiceCall | | ScreenFlow | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The screen flow associated with the orchestration work item. Possible values are screen flows in the org. | | ScreenFlowInputs | Type textarea Properties Create, Nillable, Update Description The input parameters required by the screen flow. | | Status | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort, Update Description The status of the work item. Valid values are: - Assigned - Completed | | StepInstanceId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the flow orchestration step associated with the orchestration work item. This field is a relationship field. Relationship Name StepInstance Relationship Type Lookup Refers To FlowOrchestrationStepInstance | ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [FlowOrchestrationWorkItemFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [FlowOrchestrationWorkItemHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [FlowOrchestrationWorkItemOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [FlowOrchestrationWorkItemShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.