PingOne Platform APIs

DaVinci Flow Activities

The /metrics/davinci endpoint returns count information for DaVinci flow executions, connector executions, and flow nodes. You can configure targeted queries to aggregate flow and connector data, consumable by their analytics and observability applications. The API uses pre-defined filters and aggregations, including date-time filters, count summations, and other valuable DaVinci metrics.

For example, you can build queries that answer these questions:

  • What is the total number of flow executions during a period of time?

  • How many flow transactions were executed in a period of time for a particular flow?

  • How many flow transactions in a period of time, excluding subflows?

  • Which flow had the highest execution rate in the last week?

  • Which flow had the highest execution rate when run as a main flow and not a subflow?

  • Which flows were not executed in the last 7 days?

  • How many times was a specific connector executed in the last 7 days?

The endpoint’s response shows data based on one of the following entityType values set in the request body:

  • DAVINCI_FLOW_EXECUTION_COUNTS

    DaVinci flow execution metrics, including total flow execution counts, average and maximum counts, and whether the flow is a subflow.

  • DAVINCI_CONNECTOR_EXECUTION_COUNTS

    DaVinci connector execution metrics, including the connector name and total connector execution, average, and maximum counts.

  • DAVINCI_FLOW_NODE_METRICS

    DaVinci flow node metrics, including the node ID, execution time, wait time, as well as invocation, completion, and abandonment counts.

DaVinci flow activities data model

Property Type Required Mutable Description

aggregations[]

Object

Optional

Mutable

An array of strings that identifies the field and aggregator type for each aggregation.

aggregations.aggregatorType

String

Optional

Mutable

The aggregation type. Options are SUM, AVG, MAX, HOUR`, DAY, WEEK, MONTH.

companyId

String

Read-only

N/A

The company ID (equivalent to the PingOne environment ID.

connectorType

String

Read-only

N/A

The DaVinci connector name (for example, pingOneSSOConnector).

createdAt

Date

Read-only

N/A

The date and time of the data collection (ISO 8601 format).

entityType

String

Required

Mutable

A string that specifies the type of DaVinci data returned by the request. Options are DAVINCI_FLOW_EXECUTION_COUNTS, DAVINCI_CONNECTION_EXECUTION_COUNTS, and DAVINCI_FLOW_NODE_METRICS.

field

String

Optional

Mutable

The database field used for aggregation or by the query filter.

flowId

String

Read-only

N/A

The DaVinci flow ID.

flowVersion

Integer

Read-only

N/A

The flow version number for the DaVinci flow.

groupBy[]

Object

Optional

Mutable

An array of strings that specifies how response data is grouped. This property is required when using aggregations that specifies a field.

operator

String

Optional

Mutable

The operator in the query filter expression.

orderBy

Object

Optional

Mutable

An object that specifies the field and sort direction of the response data.

platformType

String

Optional

Mutable

The platform that ran the flow. Options include standard (default), mobile, sdk.

queryFilters[]

Object

Optional

Mutable

The filtering expressions that specify the data returned in the response.

selectFields

Object

Required

Mutable

The list of data fields returned in the response.

sortDirection

String

Optional

Mutable

The sort order direction identifier. Options are DESC, ASC.

spanType

String

Optional

Mutable

The time duration of time for the count. Options are HOURS, DAYS, MONTHS.

values[]

String

Optional

Mutable

The value or values used in a filtering expression.

DaVinci flow activities results data model

The response for DaVinci flow activities endpoints includes a results object that presents the count data for the flow, connector, or node.

Property Type Required Mutable Description

avg

Integer

Read-only

N/A

The average number of flow or connector executions.

count

Integer

Read-only

N/A

The number of flow or connector executions.

max

Integer

Read-only

N/A

The maximum number of flow or connector executions.

sum

Integer

Read-only

N/A

The sum total of flow or connector executions.

completionCount

Integer

Read-only

N/A

The number of completed nodes.

invocationCount

Integer

Read-only

N/A

The number of node invocations.

errorCount

Integer

Read-only

N/A

The number of node errors.

timeoutCount

Integer

Read-only

N/A

The number of node timeouts.

executionTime

Integer

Read-only

N/A

The node execution time in seconds.

companyId

String

Read-only

N/A

The company ID associated with the flow, connector, or node.

flowId

String

Read-only

N/A

The flow ID.

connectorId

String

Read-only

N/A

The connector ID.

flowVersion

Integer

Read-only

N/A

The flow version number.

isSubflow

Boolean

Read-only

N/A

Boolean that specifies whether the entity is a subflow.

platformType

String

Read-only

N/A

The platform type, if known.

bucketTimestamp

Date

Read-only

N/A

The timestamp specifying when the data was collected.

Filtering data

These requests accept filtering expressions in the request JSON to fine-tune the response data. The minimum filter must include a field, an operator, and a value. For example, the following query filter limits the results to counts for the specified DaVinci flow ID with a timestamp before the specified date:

"queryFilters": [
   {
     "field": "flowId",
     "operator": "EQUALS",
     "values": ["{{davinciFlowID}}"]
   },
   {
     "field": "bucketTimestamp",
     "operator": "LESS_THAN",
     "values": ["2026-08-19T00:00:00Z"]
   }
 ],

Operators

You can apply these operators to the following fields:

  • EQUALS (equals)

    Supported attributes: companyId, flowId, nodeId

  • NOT_EQUALS (not equals)

    Supported attributes: companyId, flowId, nodeId

  • GREATER_THAN (greater than)

    Supported attributes: bucketTimestamp, invocationCount, completionCount, errorCount, timeoutCount, executionTime

  • LESS_THAN (less than)

    Supported attributes: bucketTimestamp, invocationCount, completionCount, errorCount, timeoutCount, executionTime

  • GREATER_THAN_OR_EQUAL_TO (greater than or equal to)

    Supported attributes: bucketTimestamp, invocationCount, completionCount, errorCount, timeoutCount, executionTime

  • LESS_THAN_OR_EQUAL_TO (less than or equal to)

    Supported attributes: bucketTimestamp, invocationCount, completionCount, errorCount, timeoutCount, executionTime

  • IN (in)

    Supported attributes: isSubflow

  • NOT_IN (not in)

    Supported attributes: isSubflow

Supported fields

Each entity type supports these fields in a query filter:

  • DAVINCI_FLOW_NODE_METRICS

    • companyId, flowId, bucketTimestamp, nodeId, invocationCount, completionCount, errorCount, timeoutCount, executionTime

  • DAVINCI_CONNECTOR_EXECUTION_COUNTS

    • companyId, flowId, flowVersion, connectorType, bucketTimestamp, count

  • DAVINCI_FLOW_EXECUTION_COUNTS

    • companyId, flowId, flowVersion, bucketTimestamp, count, isSubflow, platformType

Assigning admin roles and permissions to this service

Admin role assignments determine access to PingOne APIs. When assigning admin roles to this service, refer to PingOne Permissions by Service for the service-specific permissions.

You can also choose to assign admin roles based on particular service resources. Refer to PingOne Permissions by Resource when assigning admin roles per service resources.

Admin assignments to roles are set by:

Refer to Roles Management for more information.

Response codes

Code Message

200

Successful operation.

400

The request could not be completed.

401

You do not have access to this resource.

403

You do not have permissions or are not licensed to make this request.

404

The requested resource was not found.