---
title: "PUT /environments/{environmentID}/davinciApplications/{davinciApplicationID}/flowPolicies/{flowPolicyID}"
method: PUT
path: "/environments/{environmentID}/davinciApplications/{davinciApplicationID}/flowPolicies/{flowPolicyID}"
tags: ["DaVinci Admin Application Flow Policies", "DaVinci Admin APIs", "PingOne DaVinci"]
---

# PUT /environments/{environmentID}/davinciApplications/{davinciApplicationID}/flowPolicies/{flowPolicyID}

`PUT /environments/{environmentID}/davinciApplications/{davinciApplicationID}/flowPolicies/{flowPolicyID}`

## Request

- Base URL: `https://api.pingone.com/v1`
- URL: `https://api.pingone.com/v1/environments/{environmentID}/davinciApplications/{davinciApplicationID}/flowPolicies/{flowPolicyID}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/docs/environments/:environmentID/davinciApplications/:davinciApplicationID/flowPolicies/:flowPolicyID/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `environmentID` string, uuid, required
- `davinciApplicationID` string, required
- `flowPolicyID` string, required

## Headers

- `X-Ping-External-Session-ID` string
- `X-Ping-External-Transaction-ID` string

## Request body

- ComPingidentityPingoneDavinciFlowpoliciesDataUpdateFlowPolicy
  - `name` string, required
  - `flowDistributions` object[]
    - `id` string, required
    - `version` number, required
    - `ip` string[]
    - `successNodes` object[]
      - `id` string, required
    - `weight` number
  - `status` 'disabled' | 'enabled'
  - `trigger` object
    - `configuration` object
      - `mfa` object
        - `enabled` boolean
        - `time` number
        - `timeFormat` string
      - `pwd` object
        - `enabled` boolean
        - `time` number
        - `timeFormat` string
    - `type` 'AUTHENTICATION'

## Response `200`

Successful Operation.

- ComPingidentityPingoneDavinciFlowpoliciesResponseFlowPolicyResponse
  - `_links` object, required
    - `self` ComPingidentityApiResponseLink, required
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
    - `environment` ComPingidentityApiResponseLink, required
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
    - `davinciApplication` ComPingidentityApiResponseLink, required
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
    - `flow.<index>` ComPingidentityApiResponseLink
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
    - `version.<flowId>.<index>` ComPingidentityApiResponseLink
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
  - `environment` ComPingidentityApiRelationshipPingOneRO, required
    - `id` string, uuid, required
  - `flowDistributions` object[], required
    - `id` string, required
    - `version` number, required
    - `ip` string[]
    - `successNodes` object[]
      - `id` string, required
    - `weight` number
  - `id` string, required
  - `name` string, required
  - `status` 'disabled' | 'enabled', required
  - `application` ComPingidentityApiRelationshipDaVinciRO
    - `id` string, required
  - `createdAt` string, date-time
  - `trigger` object
    - `configuration` object
      - `mfa` object, required
        - `enabled` boolean, required
        - `time` number, required
        - `timeFormat` string, required
      - `pwd` object, required
        - `enabled` boolean, required
        - `time` number, required
        - `timeFormat` string, required
    - `type` string
  - `updatedAt` string, date-time

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden - Note: This may occur if the environment doesn't exist. Check for environment existence with GET /environments/{environmentID} first.
- `404`: Not Found
- `415`: Unsupported Media Type
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

## Changes

- **2025-12-01** (3.1) `6581e0a8e178`: 2 info
  - added the optional property `details/items/innerError/supportedAttributes` to the response with the `400` status
  - added the optional property `details/items/innerError/supportedOperators` to the response with the `400` status
- **2025-11-18** (3.1) `386d2d092d61`: 2 breaking
  - the response property `id` became optional for the status `429`
  - the `id` response property's minLength was decreased from `1` to `0` for the response status `429`
- **2025-08-18** (3.1) `16b3c51ddcde`: 2 breaking
  - the response property `id` became optional for the status `403`
  - the `id` response property's minLength was decreased from `1` to `0` for the response status `403`
- **2025-08-13** (3.1) `20141c1b08b5`: 2 info
  - added the optional property `application` to the response with the `200` status
  - added the required property `_links/davinciApplication` to the response with the `200` status

[Operation history](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/changes/environments/:environmentID/davinciApplications/:davinciApplicationID/flowPolicies/:flowPolicyID/put.md)

---

[API](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2.md) - [All operations](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/revisions/6ad8bc078fb8?raw)