Ping Identity DaVinci Admin Variables API
Operations for managing DaVinci variables
Operations for managing DaVinci variables
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/ping-identity-davinci-admin-variables-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.1.1
info:
title: PingOne Platform Configuration Management DaVinci Admin Variables API
version: 2026.01.07-beta
description: PingOne is a cloud-based framework for secure identity access management. The PingOne API gives developers the tools to integrate enterprise and third-party applications with the PingOne platform.
contact:
name: Ping Identity Developer Experiences
url: https://developer.pingidentity.com
email: devex@pingidentity.com
license:
identifier: Apache-2.0
name: Apache 2.0
servers:
- url: https://api.pingone.{tld}/{basePath}
variables:
basePath:
default: v1
tld:
enum:
- eu
- com
- asia
- com.au
- ca
- sg
default: com
security:
- bearerAuth: []
- oauth2: []
tags:
- name: DaVinci Admin Variables
description: Operations for managing DaVinci variables
paths:
/environments/{environmentID}/variables:
get:
operationId: getVariables
parameters:
- $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
- name: limit
in: query
required: false
schema:
type: integer
format: int32
minimum: 1
maximum: 500
default: 10
- name: cursor
in: query
required: false
schema:
type: string
- name: filter
in: query
required: false
schema:
type: string
- $ref: '#/components/parameters/com.pingidentity.header.ExternalSessionID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalTransactionID'
responses:
'200':
description: Successful Operation.
content:
application/json:
schema:
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.response.VariablesResponse'
'400':
$ref: '#/components/responses/http.400.BadRequest'
'401':
$ref: '#/components/responses/http.401.Unauthorized'
'403':
$ref: '#/components/responses/http.403.Forbidden.P14C63085.DOCS8830'
'404':
$ref: '#/components/responses/http.404.NotFound.DOCS8830'
'415':
$ref: '#/components/responses/http.415.UnsupportedMediaType'
'429':
$ref: '#/components/responses/http.429.TooManyRequests'
'500':
$ref: '#/components/responses/http.500.InternalServerError'
'502':
$ref: '#/components/responses/http.502.BadGateway'
'503':
$ref: '#/components/responses/http.503.ServiceUnavailable'
x-permission: davinci:read:constructs
x-pingidentity-paginatedresponse: true
tags:
- DaVinci Admin Variables
post:
operationId: createVariable
parameters:
- $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalSessionID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalTransactionID'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.data.CreateVariable'
required: true
responses:
'201':
description: Successfully created the resource.
content:
application/json:
schema:
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.response.VariableResponse'
'400':
$ref: '#/components/responses/http.400.BadRequest'
'401':
$ref: '#/components/responses/http.401.Unauthorized'
'403':
$ref: '#/components/responses/http.403.Forbidden.P14C63085.DOCS8830'
'404':
$ref: '#/components/responses/http.404.NotFound.DOCS8830'
'415':
$ref: '#/components/responses/http.415.UnsupportedMediaType'
'429':
$ref: '#/components/responses/http.429.TooManyRequests'
'500':
$ref: '#/components/responses/http.500.InternalServerError'
'502':
$ref: '#/components/responses/http.502.BadGateway'
'503':
$ref: '#/components/responses/http.503.ServiceUnavailable'
x-permission: davinci:create:constructs
tags:
- DaVinci Admin Variables
/environments/{environmentID}/variables/{variableID}:
get:
operationId: getVariableById
parameters:
- $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
- $ref: '#/components/parameters/com.pingidentity.path.environments.variables.variableID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalSessionID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalTransactionID'
responses:
'200':
description: Successful Operation.
content:
application/json:
schema:
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.response.VariableResponse'
'400':
$ref: '#/components/responses/http.400.BadRequest'
'401':
$ref: '#/components/responses/http.401.Unauthorized'
'403':
$ref: '#/components/responses/http.403.Forbidden.P14C63085.DOCS8830'
'404':
$ref: '#/components/responses/http.404.NotFound.DOCS8830'
'415':
$ref: '#/components/responses/http.415.UnsupportedMediaType'
'429':
$ref: '#/components/responses/http.429.TooManyRequests'
'500':
$ref: '#/components/responses/http.500.InternalServerError'
'502':
$ref: '#/components/responses/http.502.BadGateway'
'503':
$ref: '#/components/responses/http.503.ServiceUnavailable'
x-permission: davinci:read:constructs
tags:
- DaVinci Admin Variables
put:
operationId: replaceVariableById
parameters:
- $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
- $ref: '#/components/parameters/com.pingidentity.path.environments.variables.variableID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalSessionID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalTransactionID'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.data.UpdateVariable'
required: true
responses:
'200':
description: Successful Operation.
content:
application/json:
schema:
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.response.VariableResponse'
'400':
$ref: '#/components/responses/http.400.BadRequest'
'401':
$ref: '#/components/responses/http.401.Unauthorized'
'403':
$ref: '#/components/responses/http.403.Forbidden.P14C63085.DOCS8830'
'404':
$ref: '#/components/responses/http.404.NotFound.DOCS8830'
'415':
$ref: '#/components/responses/http.415.UnsupportedMediaType'
'429':
$ref: '#/components/responses/http.429.TooManyRequests'
'500':
$ref: '#/components/responses/http.500.InternalServerError'
'502':
$ref: '#/components/responses/http.502.BadGateway'
'503':
$ref: '#/components/responses/http.503.ServiceUnavailable'
x-permission: davinci:update:constructs
tags:
- DaVinci Admin Variables
delete:
operationId: deleteVariableById
parameters:
- $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
- $ref: '#/components/parameters/com.pingidentity.path.environments.variables.variableID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalSessionID'
- $ref: '#/components/parameters/com.pingidentity.header.ExternalTransactionID'
responses:
'204':
description: Successfully removed. No content.
'400':
$ref: '#/components/responses/http.400.BadRequest'
'401':
$ref: '#/components/responses/http.401.Unauthorized'
'403':
$ref: '#/components/responses/http.403.Forbidden.P14C63085.DOCS8830'
'404':
$ref: '#/components/responses/http.404.NotFound.DOCS8830'
'415':
$ref: '#/components/responses/http.415.UnsupportedMediaType'
'429':
$ref: '#/components/responses/http.429.TooManyRequests'
'500':
$ref: '#/components/responses/http.500.InternalServerError'
'502':
$ref: '#/components/responses/http.502.BadGateway'
'503':
$ref: '#/components/responses/http.503.ServiceUnavailable'
x-permission: davinci:delete:constructs
tags:
- DaVinci Admin Variables
components:
parameters:
com.pingidentity.path.environments.variables.variableID:
name: variableID
in: path
required: true
schema:
type: string
format: uuid
com.pingidentity.path.environments.environmentID:
name: environmentID
in: path
required: true
schema:
type: string
format: uuid
com.pingidentity.header.ExternalSessionID:
schema:
type: string
minLength: 1
name: X-Ping-External-Session-ID
in: header
com.pingidentity.header.ExternalTransactionID:
schema:
type: string
minLength: 1
name: X-Ping-External-Transaction-ID
in: header
schemas:
com.pingidentity.ApiErrorResponse:
type: object
properties:
code:
type: string
title: General Error Code
details:
type: array
items:
$ref: '#/components/schemas/com.pingidentity.ErrorDetail'
title: General Error Details
id:
type: string
title: General Error Id
message:
type: string
title: General Error Message
title: General Error
com.pingidentity.ApiErrorResponse.400:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
id:
type: string
format: uuid
minLength: 1
title: Bad Request Error Id
code:
type: string
enum:
- INVALID_DATA
- INVALID_REQUEST
- REQUEST_FAILED
minLength: 1
title: Bad Request Error Code
message:
type: string
minLength: 1
title: Bad Request Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
enum:
- ACCOUNT_NOT_USABLE
- CONSTRAINT_VIOLATION
- EMPTY_VALUE
- INVALID_FILTER
- INVALID_OTP
- INVALID_PARAMETER
- INVALID_VALUE
- MFA_AUTH_METHODS_CONFLICT
- NO_PASSWORD
- OUT_OF_RANGE
- REQUIRED_VALUE
- SIZE_LIMIT_EXCEEDED
- UNIQUENESS_VIOLATION
minLength: 1
title: Bad Request Error Detail Code
message:
type: string
minLength: 1
title: Bad Request Error Detail Message
innerError:
type: object
properties:
allowedPattern:
type: string
title: Bad Request Error Detail Inner Error Allowed Pattern
allowedValues:
type: array
items:
type: string
title: Bad Request Error Detail Inner Error Allowed Value
title: Bad Request Error Detail Inner Error Allowed Values
claim:
type: string
title: Bad Request Error Detail Inner Error Claim
existingId:
type: string
format: uuid
title: Bad Request Error Detail Inner Error Existing Id
maximumValue:
type: number
title: Bad Request Error Detail Inner Error Maximum Value
quotaLimit:
type: number
title: Bad Request Error Detail Inner Error Quota Limit
quotaResetTime:
type: string
format: date-time
title: Bad Request Error Detail Inner Error Quota Reset Time
rangeMaximumValue:
type: number
title: Bad Request Error Detail Inner Error Range Maximum Value
rangeMinimumValue:
type: number
title: Bad Request Error Detail Inner Error Range Minimum Value
supportedAttributes:
type: array
items:
type: string
title: Bad Request Error Detail Inner Error Supported Attribute
title: Bad Request Error Detail Inner Error Supported Attributes
supportedOperators:
type: array
items:
type: string
title: Bad Request Error Detail Inner Error Supported Operator
title: Bad Request Error Detail Inner Error Supported Operators
additionalProperties: true
title: Bad Request Error Detail Inner Error
target:
type: string
title: Bad Request Error Detail Target
required:
- code
- message
title: Bad Request Error Detail
title: Bad Request Error Details
required:
- id
- code
- message
title: Bad Request Error
com.pingidentity.ErrorDetail:
type: object
properties:
code:
type: string
title: General Error Detail Code
innerError:
type: object
additionalProperties:
type: object
title: General Error Detail Inner Error Additional Properties
title: General Error Detail Inner Error
message:
type: string
title: General Error Detail Message
target:
type: string
title: General Error Detail Target
title: General Error Detail
com.pingidentity.ApiErrorResponse.403:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
code:
type: string
enum:
- ACCESS_FAILED
minLength: 1
title: Forbidden Error Code
message:
type: string
minLength: 1
title: Forbidden Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
enum:
- INSUFFICIENT_PERMISSIONS
- LICENSE_EXCEEDED
minLength: 1
title: Forbidden Error Detail Code
message:
type: string
minLength: 1
title: Forbidden Error Detail Message
innerError:
type: object
properties:
quotaLimit:
type: number
title: Forbidden Error Detail Inner Error Quota Limit
additionalProperties: true
title: Forbidden Error Detail Inner Error
target:
type: string
title: Forbidden Error Detail Target
required:
- code
- message
title: Forbidden Error Detail
title: Forbidden Error Details
id:
type: string
format: uuid
title: Forbidden Error Id
required:
- code
- message
title: Forbidden Error
com.pingidentity.ApiErrorResponse.404:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
id:
type: string
format: uuid
minLength: 1
title: Not Found Error Id
code:
type: string
enum:
- NOT_FOUND
minLength: 1
title: Not Found Error Code
message:
type: string
minLength: 1
title: Not Found Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
minLength: 1
title: Not Found Error Detail Code
message:
type: string
minLength: 1
title: Not Found Error Detail Message
innerError:
type: object
additionalProperties: true
title: Not Found Error Detail Inner Error
target:
type: string
title: Not Found Error Detail Target
required:
- code
- message
title: Not Found Error Detail
title: Not Found Error Details
required:
- id
- code
- message
title: Not Found Error
com.pingidentity.api.response.Link:
type: object
properties:
href:
type: string
format: uri
minLength: 1
title: JSON HAL Link Href
name:
type: string
title: JSON HAL Link Name
profile:
type: string
format: uri
title: JSON HAL Link Profile
title:
type: string
format: uri
title: JSON HAL Link Title
type:
type: string
title: JSON HAL Link Type
required:
- href
readOnly: true
title: JSON HAL Link
com.pingidentity.pingone.davinci.variables.data.UpdateVariable:
type: object
additionalProperties: true
properties:
name:
pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
maxLength: 256
type: string
minLength: 1
title: DaVinci Variable Replace Request Name
context:
type: string
enum:
- company
- flow
- flowInstance
- user
minLength: 1
title: DaVinci Variable Replace Request Context
dataType:
type: string
enum:
- boolean
- number
- object
- secret
- string
minLength: 1
title: DaVinci Variable Replace Request Data Type
mutable:
type: boolean
title: DaVinci Variable Replace Request Mutable
displayName:
pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
minLength: 0
maxLength: 256
type: string
title: DaVinci Variable Replace Request Display Name
flow:
$ref: '#/components/schemas/com.pingidentity.api.Relationship.DaVinci'
max:
type: integer
minimum: 0
default: 2000
title: DaVinci Variable Replace Request Max
min:
type: integer
minimum: 0
default: 0
title: DaVinci Variable Replace Request Min
value:
oneOf:
- type: boolean
title: DaVinci Variable Replace Request Value Choice 1
- type: number
title: DaVinci Variable Replace Request Value Choice 2
- type: object
title: DaVinci Variable Replace Request Value Choice 3
- type: string
title: DaVinci Variable Replace Request Value Choice 4
title: DaVinci Variable Replace Request Value
required:
- name
- context
- dataType
- mutable
x-immutable:
- name
- flow
- context
title: DaVinci Variable Replace Request
com.pingidentity.api.Relationship.PingOne.RO:
type: object
properties:
id:
type: string
format: uuid
readOnly: true
minLength: 1
title: Resource Relationship Read-Only Id
required:
- id
title: Resource Relationship Read-Only
com.pingidentity.api.Relationship.DaVinci.RO:
type: object
properties:
id:
type: string
pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
readOnly: true
minLength: 1
title: Resource Relationship DaVinci Read-Only Id
required:
- id
title: Resource Relationship DaVinci Read-Only
com.pingidentity.pingone.davinci.variables.response.VariablesResponse:
type: object
properties:
_embedded:
type: object
properties:
variables:
type: array
items:
type: object
$ref: '#/components/schemas/com.pingidentity.pingone.davinci.variables.response.VariableResponse'
title: DaVinci Variable Collection Response _embedded Variables
required:
- variables
title: DaVinci Variable Collection Response _embedded
_links:
type: object
properties:
environment:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
self:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
next:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
required:
- environment
- self
additionalProperties:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
title: DaVinci Variable Collection Response _links
size:
type: number
title: DaVinci Variable Collection Response Size
count:
type: number
title: DaVinci Variable Collection Response Count
required:
- _embedded
- _links
- size
- count
title: DaVinci Variable Collection Response
com.pingidentity.ApiErrorResponse.415:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
id:
type: string
format: uuid
minLength: 1
title: Unsupported Media Type Error Id
code:
type: string
enum:
- INVALID_REQUEST
minLength: 1
title: Unsupported Media Type Error Code
message:
type: string
minLength: 1
title: Unsupported Media Type Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
minLength: 1
title: Unsupported Media Type Error Detail Code
message:
type: string
minLength: 1
title: Unsupported Media Type Error Detail Message
innerError:
type: object
additionalProperties: true
title: Unsupported Media Type Error Detail Inner Error
target:
type: string
title: Unsupported Media Type Error Detail Target
required:
- code
- message
title: Unsupported Media Type Error Detail
title: Unsupported Media Type Error Details
required:
- id
- code
- message
title: Unsupported Media Type Error
com.pingidentity.api.Relationship.DaVinci:
type: object
properties:
id:
type: string
pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
minLength: 1
title: Resource Relationship DaVinci Id
required:
- id
title: Resource Relationship DaVinci
com.pingidentity.ApiErrorResponse.500:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
id:
type: string
format: uuid
minLength: 1
title: Internal Server Error Id
code:
type: string
enum:
- UNEXPECTED_ERROR
minLength: 1
title: Internal Server Error Code
message:
type: string
minLength: 1
title: Internal Server Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
minLength: 1
title: Internal Server Error Detail Code
message:
type: string
minLength: 1
title: Internal Server Error Detail Message
innerError:
type: object
additionalProperties: true
title: Internal Server Error Detail Inner Error
target:
type: string
title: Internal Server Error Detail Target
required:
- code
- message
title: Internal Server Error Detail
title: Internal Server Error Details
required:
- id
- code
- message
title: Internal Server Error
com.pingidentity.ApiErrorResponse.401:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
id:
type: string
format: uuid
minLength: 1
title: Unauthorized Error Id
code:
type: string
enum:
- ACCESS_FAILED
minLength: 1
title: Unauthorized Error Code
message:
type: string
minLength: 1
title: Unauthorized Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
enum:
- INSUFFICIENT_PERMISSIONS
- INVALID_TOKEN
minLength: 1
title: Unauthorized Error Detail Code
message:
type: string
minLength: 1
title: Unauthorized Error Detail Message
innerError:
type: object
additionalProperties: true
title: Unauthorized Error Detail Inner Error
target:
type: string
title: Unauthorized Error Detail Target
required:
- code
- message
title: Unauthorized Error Detail
title: Unauthorized Error Details
required:
- id
- code
- message
title: Unauthorized Error
com.pingidentity.ApiErrorResponse.429:
$schema: http://json-schema.org/draft/2020-12/schema#
type: object
properties:
code:
type: string
enum:
- REQUEST_LIMITED
minLength: 1
title: Too Many Requests Error Code
message:
type: string
minLength: 1
title: Too Many Requests Error Message
details:
type: array
items:
type: object
properties:
code:
type: string
enum:
- LIMIT_EXCEEDED
- QUOTA_EXCEEDED
minLength: 1
title: Too Many Requests Error Detail Code
message:
type: string
minLength: 1
title: Too Many Requests Error Detail Message
innerError:
type: object
properties:
quotaLimit:
type: number
title: Too Many Requests Error Detail Inner Error Quota Limit
quotaResetTime:
type: string
format: date-time
title: Too Many Requests Error Detail Inner Error Quota Reset Time
retryAfter:
type: string
format: date-time
title: Too Many Requests Error Detail Inner Error Retry After
additionalProperties: true
title: Too Many Requests Error Detail Inner Error
target:
type: string
title: Too Many Requests Error Detail Target
required:
- code
- message
title: Too Many Requests Error Detail
title: Too Many Requests Error Details
id:
type: string
format: uuid
title: Too Many Requests Error Id
required:
- code
- message
title: Too Many Requests Error
com.pingidentity.pingone.davinci.variables.data.CreateVariable:
type: object
additionalProperties: true
properties:
name:
pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
maxLength: 256
type: string
minLength: 1
title: DaVinci Variable Create Request Name
context:
type: string
enum:
- company
- flow
- flowInstance
- user
minLength: 1
title: DaVinci Variable Create Request Context
dataType:
type: string
enum:
- boolean
- number
- object
- secret
- string
minLength: 1
title: DaVinci Variable Create Request Data Type
mutable:
type: boolean
title: DaVinci Variable Create Request Mutable
displayName:
pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
maxLength: 256
type: string
title: DaVinci Variable Create Request Display Name
flow:
$ref: '#/components/schemas/com.pingidentity.api.Relationship.DaVinci'
max:
type: integer
minimum: 0
default: 2000
title: DaVinci Variable Create Request Max
min:
type: integer
minimum: 0
default: 0
title: DaVinci Variable Create Request Min
value:
oneOf:
- type: boolean
title: DaVinci Variable Create Request Value Choice 1
- type: number
title: DaVinci Variable Create Request Value Choice 2
- type: object
title: DaVinci Variable Create Request Value Choice 3
- type: string
title: DaVinci Variable Create Request Value Choice 4
title: DaVinci Variable Create Request Value
required:
- name
- context
- dataType
- mutable
title: DaVinci Variable Create Request
com.pingidentity.pingone.davinci.variables.response.VariableResponse:
type: object
properties:
_links:
type: object
properties:
environment:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
self:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
required:
- environment
- self
additionalProperties:
$ref: '#/components/schemas/com.pingidentity.api.response.Link'
title: DaVinci Variable Response _links
dataType:
enum:
- array
- boolean
- button
- list
- listInt
- mapping
- number
- object
- propertyGroup
- screenConfig
- secret
- skConnectorList
- skEvent
- string
- timestamp
type: string
minLength: 1
title: DaVinci Variable Response Data Type
environment:
$ref: '#/components/schemas/com.pingidentity.api.Relationship.PingOne.RO'
id:
type: s
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ping-identity/refs/heads/main/openapi/ping-identity-davinci-admin-variables-api-openapi.yml