Ping Identity DaVinci Admin Connector Instances API

Operations for managing DaVinci connectors and connector instances

OpenAPI Specification

ping-identity-davinci-admin-connector-instances-api-openapi.yml Raw ↑
openapi: 3.1.1
info:
  title: PingOne Platform Configuration Management DaVinci Admin Connector Instances 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 Connector Instances
  description: Operations for managing DaVinci connectors and connector instances
paths:
  /environments/{environmentID}/connectorInstances:
    get:
      operationId: getConnectorInstances
      parameters:
      - $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
      - $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.connectorinstances.response.ConnectorInstancesResponse'
        '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:connections
      tags:
      - DaVinci Admin Connector Instances
    post:
      operationId: createConnectorInstance
      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.connectorinstances.data.CreateConnectorInstance'
        required: true
      responses:
        '201':
          description: Successfully created the resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/com.pingidentity.pingone.davinci.connectorinstances.response.ConnectorInstanceResponse'
        '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:connections
      tags:
      - DaVinci Admin Connector Instances
  /environments/{environmentID}/connectorInstances/{connectorInstanceID}:
    get:
      operationId: getConnectorInstanceById
      parameters:
      - $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
      - $ref: '#/components/parameters/com.pingidentity.path.environments.connectorInstances.connectorInstanceID'
      - $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.connectorinstances.response.ConnectorInstanceResponse'
        '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:connections
      tags:
      - DaVinci Admin Connector Instances
    post:
      operationId: createConnectorInstanceById
      parameters:
      - $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
      - $ref: '#/components/parameters/com.pingidentity.path.environments.connectorInstances.connectorInstanceID'
      - $ref: '#/components/parameters/com.pingidentity.header.ExternalSessionID'
      - $ref: '#/components/parameters/com.pingidentity.header.ExternalTransactionID'
      requestBody:
        content:
          application/vnd.pingidentity.connectorInstance.clone+json:
            schema:
              $ref: '#/components/schemas/com.pingidentity.pingone.davinci.connectorinstances.data.CloneConnectorInstance'
        required: true
      responses:
        '201':
          description: Successfully created the resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/com.pingidentity.pingone.davinci.connectorinstances.response.ConnectorInstanceResponse'
        '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:connections
      tags:
      - DaVinci Admin Connector Instances
    put:
      operationId: replaceConnectorInstanceById
      parameters:
      - $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
      - $ref: '#/components/parameters/com.pingidentity.path.environments.connectorInstances.connectorInstanceID'
      - $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.connectorinstances.data.UpdateConnectorInstance'
        required: true
      responses:
        '200':
          description: Successful Operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/com.pingidentity.pingone.davinci.connectorinstances.response.ConnectorInstanceResponse'
        '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:connections
      tags:
      - DaVinci Admin Connector Instances
    delete:
      operationId: deleteConnectorInstanceById
      parameters:
      - $ref: '#/components/parameters/com.pingidentity.path.environments.environmentID'
      - $ref: '#/components/parameters/com.pingidentity.path.environments.connectorInstances.connectorInstanceID'
      - $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:connections
      tags:
      - DaVinci Admin Connector Instances
components:
  schemas:
    com.pingidentity.pingone.davinci.connectorinstances.response.ConnectorInstanceResponse:
      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'
            connectorInstance.clone:
              $ref: '#/components/schemas/com.pingidentity.api.response.Link'
            applications:
              $ref: '#/components/schemas/com.pingidentity.api.response.Link'
            deviceAuthenticationPolicies:
              $ref: '#/components/schemas/com.pingidentity.api.response.Link'
            gateways:
              $ref: '#/components/schemas/com.pingidentity.api.response.Link'
            notificationsPolicies:
              $ref: '#/components/schemas/com.pingidentity.api.response.Link'
          required:
          - environment
          - self
          - connectorInstance.clone
          additionalProperties:
            $ref: '#/components/schemas/com.pingidentity.api.response.Link'
          title: DaVinci Connector Instance Response _links
        connector:
          $ref: '#/components/schemas/com.pingidentity.api.Relationship.DaVinci.RO'
        environment:
          $ref: '#/components/schemas/com.pingidentity.api.Relationship.PingOne.RO'
        id:
          type: string
          minLength: 1
          title: DaVinci Connector Instance Response Id
        name:
          type: string
          minLength: 1
          title: DaVinci Connector Instance Response Name
        createdAt:
          type: string
          format: date-time
          title: DaVinci Connector Instance Response Created At
        properties:
          type: object
          properties: {}
          additionalProperties: true
          title: DaVinci Connector Instance Response Properties
        updatedAt:
          type: string
          format: date-time
          title: DaVinci Connector Instance Response Updated At
      required:
      - _links
      - connector
      - environment
      - id
      - name
      title: DaVinci Connector Instance Response
    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.pingone.davinci.connectorinstances.data.CreateConnectorInstance:
      type: object
      additionalProperties: true
      properties:
        name:
          pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
          maxLength: 256
          type: string
          minLength: 1
          title: DaVinci Connector Instance Create Request Name
        connector:
          $ref: '#/components/schemas/com.pingidentity.api.Relationship.DaVinci'
        properties:
          type: object
          title: DaVinci Connector Instance Create Request Properties
      required:
      - name
      - connector
      title: DaVinci Connector Instance Create Request
    com.pingidentity.pingone.davinci.connectorinstances.data.UpdateConnectorInstance:
      type: object
      additionalProperties: true
      properties:
        name:
          pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
          maxLength: 256
          type: string
          minLength: 1
          title: DaVinci Connector Instance Replace Request Name
        connector:
          $ref: '#/components/schemas/com.pingidentity.api.Relationship.DaVinci'
        properties:
          type: object
          title: DaVinci Connector Instance Replace Request Properties
      required:
      - name
      - connector
      x-immutable:
      - connector
      title: DaVinci Connector Instance Replace Request
    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.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.connectorinstances.response.ConnectorInstancesResponse:
      type: object
      properties:
        _embedded:
          type: object
          properties:
            connectorInstances:
              type: array
              items:
                type: object
                $ref: '#/components/schemas/com.pingidentity.pingone.davinci.connectorinstances.response.ConnectorInstanceResponse'
              title: DaVinci Connector Instance Collection Response _embedded Connector Instances
          required:
          - connectorInstances
          title: DaVinci Connector Instance 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'
          required:
          - environment
          - self
          additionalProperties:
            $ref: '#/components/schemas/com.pingidentity.api.response.Link'
          title: DaVinci Connector Instance Collection Response _links
      required:
      - _embedded
      - _links
      title: DaVinci Connector Instance Collection Response
    com.pingidentity.pingone.davinci.connectorinstances.data.CloneConnectorInstance:
      type: object
      additionalProperties: true
      properties: {}
      title: DaVinci Connector Instance Clone Request
    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
  parameters:
    com.pingidentity.path.environments.connectorInstances.connectorInstanceID:
      name: connectorInstanceID
      in: path
      required: true
      schema:
        type: string
        pattern: ^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))
    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.ExternalTr

# --- truncated at 32 KB (36 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ping-identity/refs/heads/main/openapi/ping-identity-davinci-admin-connector-instances-api-openapi.yml