api-specs/idn/beta/paths/form-instance-data-source.yaml

get:
  tags:
    - Custom Forms
  summary: Retrieves dynamic data by element.
  description: |-
    Parameter `{formInstanceID}` should match a form instance ID.
    Parameter `{formElementID}` should match a form element ID at the data source configuration.
  operationId: searchFormElementDataByElementID
  parameters:
    - name: formInstanceID
      in: path
      description: Form instance ID
      required: true
      schema:
        type: string
        x-go-name: FormInstanceID
      example: 00000000-0000-0000-0000-000000000000
      x-go-name: FormInstanceID
    - name: formElementID
      in: path
      description: Form element ID
      required: true
      schema:
        type: string
        x-go-name: FormElementID
      example: 1
      x-go-name: FormElementID
    - name: limit
      in: query
      description: |-
        Limit

        Integer specifying the maximum number of records to return in a single API call. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results).
        If it is not specified, a default limit is used.
      schema:
        type: integer
        format: int64
        maxLength: 250
        minLength: 0
        default: 250
        x-go-name: Limit
      example: 250
      required: false
      x-go-name: Limit
    - name: filters
      in: query
      description: >-
        Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results)


        Filtering is supported for the following fields and operators:


        **value**: *eq, ne, in*


        **label**: *eq, ne, in*

        
        **subLabel**: *eq, ne, in*
      schema:
        type: string
        x-go-name: Filters
      example: label sw "my label"
      required: false
      x-go-name: Filters
  responses:
    "200":
      description: Retrieves dynamic data to aid in correctly completing a valid
        form by form element ID from data source configuration
      content:
        application/json:
          schema:
            $ref: '../schemas/forms/ListFormElementDataByElementIDResponse.yaml'
    "400":
      description: An error with the request occurred
      content:
        application/json:
          schema:
            type: object
            properties:
              detailCode:
                type: string
                x-go-name: DetailCode
              messages:
                type: array
                items:
                  $ref: '../schemas/forms/ErrorMessage.yaml'
                x-go-name: Messages
              statusCode:
                type: integer
                format: int64
                x-go-name: StatusCode
              trackingId:
                type: string
                x-go-name: TrackingID
    "401":
      description: An error with the authorization occurred
      content:
        application/json:
          schema:
            type: object
            properties:
              detailCode:
                type: string
                x-go-name: DetailCode
              messages:
                type: array
                items:
                  $ref: '../schemas/forms/ErrorMessage.yaml'
                x-go-name: Messages
              statusCode:
                type: integer
                format: int64
                x-go-name: StatusCode
              trackingId:
                type: string
                x-go-name: TrackingID
    "403":
      description: An error with the user permissions occurred
      content:
        application/json:
          schema:
            type: object
            properties:
              detailCode:
                type: string
                x-go-name: DetailCode
              messages:
                type: array
                items:
                  $ref: '../schemas/forms/ErrorMessage.yaml'
                x-go-name: Messages
              statusCode:
                type: integer
                format: int64
                x-go-name: StatusCode
              trackingId:
                type: string
                x-go-name: TrackingID
    "404":
      description: An error with the item not found
      content:
        application/json:
          schema:
            type: object
            properties:
              detailCode:
                type: string
                x-go-name: DetailCode
              messages:
                type: array
                items:
                  $ref: '../schemas/forms/ErrorMessage.yaml'
                x-go-name: Messages
              statusCode:
                type: integer
                format: int64
                x-go-name: StatusCode
              trackingId:
                type: string
                x-go-name: TrackingID
    "429":
      description: Too many requests
      content:
        application/json:
          schema:
            $ref: '../schemas/forms/Error.yaml'
    "500":
      description: An internal server error occurred
      content:
        application/json:
          schema:
            type: object
            properties:
              detailCode:
                type: string
                x-go-name: DetailCode
              messages:
                type: array
                items:
                  $ref: '../schemas/forms/ErrorMessage.yaml'
                x-go-name: Messages
              statusCode:
                type: integer
                format: int64
                x-go-name: StatusCode
              trackingId:
                type: string
                x-go-name: TrackingID
  security:
    - UserContextAuth: [ ]