FlowDefinition | Tooling API | Salesforce Developers

When using the Tooling API to work with flow definitions, consider that:

You can activate and deactivate flows with the Metadata field.
You can update masterlabel and description of a FlowDefinition.
FlowDefinition are implicitly created when the Flow object is created. This means FlowDefinition objects can only be updated.

Legacy flows created with the Desktop Flow Designer can’t be modified with the API. Update your flow by recreating it with the Cloud Flow Designer.

Note

This object is available in API version 34.0 and later.

Supported SOAP API Calls

query(), retrieve(), update()

Supported REST API HTTP Methods

GET, HEAD, PATCH, POST

Fields

Field Name	Details
ActiveVersion	Type Flow Properties Filter, Group, Nillable, Sort Description The active flow version object.
ActiveVersionId	Type ID Properties Filter, Group, Nillable, Sort Description The ID of the active flow version.
Description	Type string Properties Nillable Description Flow definition information, specified by the organization’s administrator.
DeveloperName	Type string Properties Filter, Group, Sort Description Developer name of this flow definition.
FullName	Type string Properties Create, Group, Nillable Description The full name of the flow definition in the Metadata API. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
LatestVersion	Type Flow Properties Filter, Group, Nillable, Sort Description The latest flow version object, regardless of the flow’s state.
LatestVersionId	Type ID Properties Filter, Group, Nillable, Sort Description ID of the latest flow version, regardless of the flow’s state.
ManageableState	Type ManageableState enumerated list Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates the manageable state of the specified component that is contained in a package: `beta` `deleted` `deprecated` `installed` `released` `unmanaged` For more information about states of manageability for components in Salesforce AppExchange packages, see “Planning the Release of Managed Packages” in the Salesforce online help. This field is available in API version 38.0 and later.
MasterLabel	Type string Properties Filter, Group, Nillable, Sort Description Label for the flow definition.
Metadata	Type `mns:`FlowDefinition Properties Create, Nillable, Update Description The flow definition’s metadata object, containing information about which flow version is active and the flow definition’s description. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
NamespacePrefix	Type string Properties Filter, Group, Nillable, Sort Description The namespace associated with this flow definition.