LukeParke/developer.sailpoint.com
1
0
Fork 0
mirror of https://github.com/LukeHagar/developer.sailpoint.com.git synced 2025-12-08 12:27:47 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
c18583ede42a304c32efd868e2da9a4113314b1f
developer.sailpoint.com/docs/tools/sdk/python/Reference/V2024/Methods/CustomFormsApi.md
darrell-thobe-sp c18583ede4 starting point for adding python sdk docs
2025-02-20 12:59:19 -05:00

80 KiB
Raw Blame History

id, title, pagination_label, sidebar_label, sidebar_class_name, keywords, slug, tags
id title pagination_label sidebar_label sidebar_class_name keywords slug tags
v2024-custom-forms Custom_Forms Custom_Forms Custom_Forms pythonsdk
python
Python
sdk
Custom_Forms
V2024Custom_Forms
/tools/sdk/python/v2024/methods/custom-forms
SDK
Software Development Kit
Custom_Forms
V2024Custom_Forms

sailpoint.v2024.CustomFormsApi

Use this API to build and manage custom forms. With this functionality in place, administrators can create and view form definitions and form instances.

Forms are composed of sections and fields. Sections split the form into logical groups of fields and fields are the data collection points within the form. Configure conditions to modify elements of the form as the responder provides input. Create form inputs to pass information from a calling feature, like a workflow, to your form.

Forms can be used within workflows as an action or as a trigger. The Form Action allows you to assign a form as a step in a running workflow, suspending the workflow until the form is submitted or times out, and the workflow resumes. The Form Submitted Trigger initiates a workflow when a form is submitted. The trigger can be configured to initiate on submission of a full form, a form element with any value, or a form element with a particular value.

Refer to Forms for more information about using forms in Identity Security Cloud.

All URIs are relative to https://sailpoint.api.identitynow.com/v2024

Method HTTP request Description
create_form_definition POST /form-definitions Creates a form definition.
create_form_definition_dynamic_schema POST /form-definitions/forms-action-dynamic-schema Generate JSON Schema dynamically.
create_form_definition_file_request POST /form-definitions/{formDefinitionID}/upload Upload new form definition file.
create_form_instance POST /form-instances Creates a form instance.
delete_form_definition DELETE /form-definitions/{formDefinitionID} Deletes a form definition.
export_form_definitions_by_tenant GET /form-definitions/export List form definitions by tenant.
get_file_from_s3 GET /form-definitions/{formDefinitionID}/file/{fileID} Download definition file by fileId.
get_form_definition_by_key GET /form-definitions/{formDefinitionID} Return a form definition.
get_form_instance_by_key GET /form-instances/{formInstanceID} Returns a form instance.
get_form_instance_file GET /form-instances/{formInstanceID}/file/{fileID} Download instance file by fileId.
import_form_definitions POST /form-definitions/import Import form definitions from export.
patch_form_definition PATCH /form-definitions/{formDefinitionID} Patch a form definition.
patch_form_instance PATCH /form-instances/{formInstanceID} Patch a form instance.
search_form_definitions_by_tenant GET /form-definitions Export form definitions by tenant.
search_form_element_data_by_element_id GET /form-instances/{formInstanceID}/data-source/{formElementID} Retrieves dynamic data by element.
search_form_instances_by_tenant GET /form-instances List form instances by tenant.
search_pre_defined_select_options GET /form-definitions/predefined-select-options List predefined select options.
show_preview_data_source POST /form-definitions/{formDefinitionID}/data-source Preview form definition data source.

create-form-definition

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Creates a form definition.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Body body CreateFormDefinitionRequest (optional) Body is the request payload to create form definition request

Return type

FormDefinitionResponse

Responses

Code Description Data Type Response headers
201 Returns a new form definition FormDefinitionResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.create_form_definition_request import CreateFormDefinitionRequest
from sailpoint.v2024.models.form_definition_response import FormDefinitionResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    body = {
          "owner" : {
            "name" : "Grant Smith",
            "id" : "2c9180867624cbd7017642d8c8c81f67",
            "type" : "IDENTITY"
          },
          "formConditions" : [ {
            "ruleOperator" : "AND",
            "effects" : [ {
              "config" : {
                "defaultValueLabel" : "Access to Remove",
                "element" : "8110662963316867"
              },
              "effectType" : "HIDE"
            }, {
              "config" : {
                "defaultValueLabel" : "Access to Remove",
                "element" : "8110662963316867"
              },
              "effectType" : "HIDE"
            } ],
            "rules" : [ {
              "sourceType" : "ELEMENT",
              "valueType" : "STRING",
              "source" : "department",
              "value" : "Engineering",
              "operator" : "EQ"
            }, {
              "sourceType" : "ELEMENT",
              "valueType" : "STRING",
              "source" : "department",
              "value" : "Engineering",
              "operator" : "EQ"
            } ]
          }, {
            "ruleOperator" : "AND",
            "effects" : [ {
              "config" : {
                "defaultValueLabel" : "Access to Remove",
                "element" : "8110662963316867"
              },
              "effectType" : "HIDE"
            }, {
              "config" : {
                "defaultValueLabel" : "Access to Remove",
                "element" : "8110662963316867"
              },
              "effectType" : "HIDE"
            } ],
            "rules" : [ {
              "sourceType" : "ELEMENT",
              "valueType" : "STRING",
              "source" : "department",
              "value" : "Engineering",
              "operator" : "EQ"
            }, {
              "sourceType" : "ELEMENT",
              "valueType" : "STRING",
              "source" : "department",
              "value" : "Engineering",
              "operator" : "EQ"
            } ]
          } ],
          "formInput" : [ {
            "description" : "A single dynamic scalar value (i.e. number, string, date, etc.) that can be passed into the form for use in conditional logic",
            "id" : "00000000-0000-0000-0000-000000000000",
            "label" : "input1",
            "type" : "STRING"
          }, {
            "description" : "A single dynamic scalar value (i.e. number, string, date, etc.) that can be passed into the form for use in conditional logic",
            "id" : "00000000-0000-0000-0000-000000000000",
            "label" : "input1",
            "type" : "STRING"
          } ],
          "name" : "My form",
          "description" : "My form description",
          "usedBy" : [ {
            "name" : "Access Request Form",
            "id" : "61940a92-5484-42bc-bc10-b9982b218cdf",
            "type" : "WORKFLOW"
          }, {
            "name" : "Access Request Form",
            "id" : "61940a92-5484-42bc-bc10-b9982b218cdf",
            "type" : "WORKFLOW"
          } ],
          "formElements" : [ {
            "id" : "00000000-0000-0000-0000-000000000000",
            "validations" : [ {
              "validationType" : "REQUIRED"
            }, {
              "validationType" : "REQUIRED"
            } ],
            "elementType" : "TEXT",
            "config" : {
              "label" : "Department"
            },
            "key" : "department"
          }, {
            "id" : "00000000-0000-0000-0000-000000000000",
            "validations" : [ {
              "validationType" : "REQUIRED"
            }, {
              "validationType" : "REQUIRED"
            } ],
            "elementType" : "TEXT",
            "config" : {
              "label" : "Department"
            },
            "key" : "department"
          } ]
        } # CreateFormDefinitionRequest | Body is the request payload to create form definition request (optional)

    try:
        # Creates a form definition.
        
        api_response = api_instance.create_form_definition(x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.create_form_definition(x_sail_point_experimental, Result)
        print("The response of CustomFormsApi->create_form_definition:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->create_form_definition: %s\n" % e)

[Back to top]

create-form-definition-dynamic-schema

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Generate JSON Schema dynamically.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Body body FormDefinitionDynamicSchemaRequest (optional) Body is the request payload to create a form definition dynamic schema

Return type

FormDefinitionDynamicSchemaResponse

Responses

Code Description Data Type Response headers
200 Returns a form elements dynamic schema FormDefinitionDynamicSchemaResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_definition_dynamic_schema_request import FormDefinitionDynamicSchemaRequest
from sailpoint.v2024.models.form_definition_dynamic_schema_response import FormDefinitionDynamicSchemaResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    body = {
          "description" : "A description",
          "attributes" : {
            "formDefinitionId" : "00000000-0000-0000-0000-000000000000"
          },
          "id" : "00000000-0000-0000-0000-000000000000",
          "type" : "action",
          "versionNumber" : 1
        } # FormDefinitionDynamicSchemaRequest | Body is the request payload to create a form definition dynamic schema (optional)

    try:
        # Generate JSON Schema dynamically.
        
        api_response = api_instance.create_form_definition_dynamic_schema(x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.create_form_definition_dynamic_schema(x_sail_point_experimental, Result)
        print("The response of CustomFormsApi->create_form_definition_dynamic_schema:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->create_form_definition_dynamic_schema: %s\n" % e)

[Back to top]

create-form-definition-file-request

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Upload new form definition file. Parameter {formDefinitionID} should match a form definition ID.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_definition_id str True FormDefinitionID String specifying FormDefinitionID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
file bytearray True File specifying the multipart

Return type

FormDefinitionFileUploadResponse

Responses

Code Description Data Type Response headers
201 Returns a new form definition file FormDefinitionFileUploadResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
413 An error with payload size too large SearchFormDefinitionsByTenant400Response -
415 An error with unsupported media type SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -
503 An external service is not available SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_definition_file_upload_response import FormDefinitionFileUploadResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_definition_id = '00000000-0000-0000-0000-000000000000' # str | FormDefinitionID  String specifying FormDefinitionID # str | FormDefinitionID  String specifying FormDefinitionID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    file = None # bytearray | File specifying the multipart # bytearray | File specifying the multipart

    try:
        # Upload new form definition file.
        
        api_response = api_instance.create_form_definition_file_request(form_definition_id, x_sail_point_experimental, file)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.create_form_definition_file_request(form_definition_id, x_sail_point_experimental, file)
        print("The response of CustomFormsApi->create_form_definition_file_request:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->create_form_definition_file_request: %s\n" % e)

[Back to top]

create-form-instance

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Creates a form instance.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Body body CreateFormInstanceRequest (optional) Body is the request payload to create a form instance

Return type

FormInstanceResponse

Responses

Code Description Data Type Response headers
201 Returns a new form instance FormInstanceResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.create_form_instance_request import CreateFormInstanceRequest
from sailpoint.v2024.models.form_instance_response import FormInstanceResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    body = {
          "formInput" : {
            "input1" : "Sales"
          },
          "standAloneForm" : false,
          "createdBy" : {
            "id" : "00000000-0000-0000-0000-000000000000",
            "type" : "WORKFLOW_EXECUTION"
          },
          "recipients" : [ {
            "id" : "00000000-0000-0000-0000-000000000000",
            "type" : "IDENTITY"
          }, {
            "id" : "00000000-0000-0000-0000-000000000000",
            "type" : "IDENTITY"
          } ],
          "expire" : "2023-08-12T20:14:57.74486Z",
          "formDefinitionId" : "00000000-0000-0000-0000-000000000000",
          "state" : "ASSIGNED",
          "ttl" : 1571827560
        } # CreateFormInstanceRequest | Body is the request payload to create a form instance (optional)

    try:
        # Creates a form instance.
        
        api_response = api_instance.create_form_instance(x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.create_form_instance(x_sail_point_experimental, Result)
        print("The response of CustomFormsApi->create_form_instance:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->create_form_instance: %s\n" % e)

[Back to top]

delete-form-definition

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Deletes a form definition. Parameter {formDefinitionID} should match a form definition ID.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_definition_id str True Form definition ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

object

Responses

Code Description Data Type Response headers
204 Returns an empty body object -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_definition_id = '00000000-0000-0000-0000-000000000000' # str | Form definition ID # str | Form definition ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # Deletes a form definition.
        
        api_response = api_instance.delete_form_definition(form_definition_id, x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.delete_form_definition(form_definition_id, x_sail_point_experimental)
        print("The response of CustomFormsApi->delete_form_definition:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->delete_form_definition: %s\n" % e)

[Back to top]

export-form-definitions-by-tenant

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: List form definitions by tenant. No parameters required.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Query offset int (optional) (default to 0) Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in V3 API Standard Collection Parameters. The offset value is record-based, not page-based, and the index starts at 0.
Query limit int (optional) (default to 250) 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. If it is not specified, a default limit is used.
Query filters str (optional) Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: name: eq, gt, sw, in description: eq, gt, sw, in created: eq, gt, sw, in modified: eq, gt, sw, in
Query sorters str (optional) (default to 'name') Sort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: name, description, created, modified

Return type

List[ExportFormDefinitionsByTenant200ResponseInner]

Responses

Code Description Data Type Response headers
200 Returns a list of form definition objects by tenant used by SP-Config List[ExportFormDefinitionsByTenant200ResponseInner] -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.export_form_definitions_by_tenant200_response_inner import ExportFormDefinitionsByTenant200ResponseInner
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    offset = 0 # int | Offset  Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0) # int | Offset  Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0)
    limit = 250 # int | 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. (optional) (default to 250) # int | 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. (optional) (default to 250)
    filters = 'name sw \"my form\"' # str | 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:  **name**: *eq, gt, sw, in*  **description**: *eq, gt, sw, in*  **created**: *eq, gt, sw, in*  **modified**: *eq, gt, sw, in* (optional) # str | 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:  **name**: *eq, gt, sw, in*  **description**: *eq, gt, sw, in*  **created**: *eq, gt, sw, in*  **modified**: *eq, gt, sw, in* (optional)
    sorters = 'name' # str | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)  Sorting is supported for the following fields: **name, description, created, modified** (optional) (default to 'name') # str | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)  Sorting is supported for the following fields: **name, description, created, modified** (optional) (default to 'name')

    try:
        # List form definitions by tenant.
        
        api_response = api_instance.export_form_definitions_by_tenant(x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.export_form_definitions_by_tenant(x_sail_point_experimental, offset, limit, filters, sorters)
        print("The response of CustomFormsApi->export_form_definitions_by_tenant:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->export_form_definitions_by_tenant: %s\n" % e)

[Back to top]

get-file-from-s3

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Download definition file by fileId.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_definition_id str True FormDefinitionID Form definition ID
Path file_id str True FileID String specifying the hashed name of the uploaded file we are retrieving.
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

bytearray

Responses

Code Description Data Type Response headers
200 Returns a file that is referred to by fileID and associated with the formDefinitionID bytearray -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -
503 An external service is not available SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, image/jpeg, image/png, application/octet-stream

Example

import sailpoint.v2024
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_definition_id = '00000000-0000-0000-0000-000000000000' # str | FormDefinitionID  Form definition ID # str | FormDefinitionID  Form definition ID
    file_id = '00000031N0J7R2B57M8YG73J7M.png' # str | FileID  String specifying the hashed name of the uploaded file we are retrieving. # str | FileID  String specifying the hashed name of the uploaded file we are retrieving.
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # Download definition file by fileId.
        
        api_response = api_instance.get_file_from_s3(form_definition_id, file_id, x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.get_file_from_s3(form_definition_id, file_id, x_sail_point_experimental)
        print("The response of CustomFormsApi->get_file_from_s3:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->get_file_from_s3: %s\n" % e)

[Back to top]

get-form-definition-by-key

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Return a form definition. Parameter {formDefinitionID} should match a form definition ID.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_definition_id str True Form definition ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

FormDefinitionResponse

Responses

Code Description Data Type Response headers
200 Returns a form definition FormDefinitionResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_definition_response import FormDefinitionResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_definition_id = '00000000-0000-0000-0000-000000000000' # str | Form definition ID # str | Form definition ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # Return a form definition.
        
        api_response = api_instance.get_form_definition_by_key(form_definition_id, x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.get_form_definition_by_key(form_definition_id, x_sail_point_experimental)
        print("The response of CustomFormsApi->get_form_definition_by_key:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->get_form_definition_by_key: %s\n" % e)

[Back to top]

get-form-instance-by-key

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Returns a form instance. Parameter {formInstanceID} should match a form instance ID.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_instance_id str True Form instance ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

FormInstanceResponse

Responses

Code Description Data Type Response headers
200 Returns a form instance by its key FormInstanceResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_instance_response import FormInstanceResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_instance_id = '00000000-0000-0000-0000-000000000000' # str | Form instance ID # str | Form instance ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # Returns a form instance.
        
        api_response = api_instance.get_form_instance_by_key(form_instance_id, x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.get_form_instance_by_key(form_instance_id, x_sail_point_experimental)
        print("The response of CustomFormsApi->get_form_instance_by_key:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->get_form_instance_by_key: %s\n" % e)

[Back to top]

get-form-instance-file

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Download instance file by fileId.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_instance_id str True FormInstanceID Form instance ID
Path file_id str True FileID String specifying the hashed name of the uploaded file we are retrieving.
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

bytearray

Responses

Code Description Data Type Response headers
200 Returns a file that is referred to by fileID and associated with the formInstanceID bytearray -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -
503 An external service is not available SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, image/jpeg, image/png, application/octet-stream

Example

import sailpoint.v2024
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_instance_id = '00000000-0000-0000-0000-000000000000' # str | FormInstanceID  Form instance ID # str | FormInstanceID  Form instance ID
    file_id = '00000031N0J7R2B57M8YG73J7M.png' # str | FileID  String specifying the hashed name of the uploaded file we are retrieving. # str | FileID  String specifying the hashed name of the uploaded file we are retrieving.
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # Download instance file by fileId.
        
        api_response = api_instance.get_form_instance_file(form_instance_id, file_id, x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.get_form_instance_file(form_instance_id, file_id, x_sail_point_experimental)
        print("The response of CustomFormsApi->get_form_instance_file:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->get_form_instance_file: %s\n" % e)

[Back to top]

import-form-definitions

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Import form definitions from export.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Body body []ExportFormDefinitionsByTenant200ResponseInner (optional) Body is the request payload to import form definitions

Return type

ImportFormDefinitions202Response

Responses

Code Description Data Type Response headers
202 Returns statuses of those form definition objects imported ImportFormDefinitions202Response -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.export_form_definitions_by_tenant200_response_inner import ExportFormDefinitionsByTenant200ResponseInner
from sailpoint.v2024.models.import_form_definitions202_response import ImportFormDefinitions202Response
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    [{version=1, self={name=All fields not required, id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, type=FORM_DEFINITION}, object={id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, name=All fields not required, description=description, owner={type=IDENTITY, id=3447d8ec2602455ab6f1e8408a0f0150}, usedBy=[{type=WORKFLOW, id=5008594c-dacc-4295-8fee-41df60477304}, {type=WORKFLOW, id=97e75a75-c179-4fbc-a2da-b5fa4aaa8743}], formInput=[{type=STRING, label=input1, description=A single dynamic scalar value (i.e. number, string, date, etc) that can be passed into the form for use in conditional logic}], formElements=[{id=3069272797630701, elementType=SECTION, config={label=First Section, formElements=[{id=3069272797630700, elementType=TEXT, key=firstName, config={label=First Name}}, {id=3498415402897539, elementType=TEXT, key=lastName, config={label=Last Name}}]}}], formConditions=[{ruleOperator=AND, rules=[{sourceType=INPUT, source=Department, operator=EQ, valueType=STRING, value=Sales}], effects=[{effectType=HIDE, config={element=2614088730489570}}]}], created=2022-10-04T19:27:04.456Z, modified=2022-11-16T20:45:02.172Z}}] # List[ExportFormDefinitionsByTenant200ResponseInner] | Body is the request payload to import form definitions (optional)
     body = [{version=1, self={name=All fields not required, id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, type=FORM_DEFINITION}, object={id=05ed4edb-d0a9-41d9-ad0c-2f6e486ec4aa, name=All fields not required, description=description, owner={type=IDENTITY, id=3447d8ec2602455ab6f1e8408a0f0150}, usedBy=[{type=WORKFLOW, id=5008594c-dacc-4295-8fee-41df60477304}, {type=WORKFLOW, id=97e75a75-c179-4fbc-a2da-b5fa4aaa8743}], formInput=[{type=STRING, label=input1, description=A single dynamic scalar value (i.e. number, string, date, etc) that can be passed into the form for use in conditional logic}], formElements=[{id=3069272797630701, elementType=SECTION, config={label=First Section, formElements=[{id=3069272797630700, elementType=TEXT, key=firstName, config={label=First Name}}, {id=3498415402897539, elementType=TEXT, key=lastName, config={label=Last Name}}]}}], formConditions=[{ruleOperator=AND, rules=[{sourceType=INPUT, source=Department, operator=EQ, valueType=STRING, value=Sales}], effects=[{effectType=HIDE, config={element=2614088730489570}}]}], created=2022-10-04T19:27:04.456Z, modified=2022-11-16T20:45:02.172Z}}] # List[ExportFormDefinitionsByTenant200ResponseInner] | Body is the request payload to import form definitions (optional)
    

    try:
        # Import form definitions from export.
        
        api_response = api_instance.import_form_definitions(x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.import_form_definitions(x_sail_point_experimental, Result)
        print("The response of CustomFormsApi->import_form_definitions:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->import_form_definitions: %s\n" % e)

[Back to top]

patch-form-definition

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Patch a form definition. Parameter {formDefinitionID} should match a form definition ID.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_definition_id str True Form definition ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Body body []Dict[str, object] (optional) Body is the request payload to patch a form definition, check: https://jsonpatch.com

Return type

FormDefinitionResponse

Responses

Code Description Data Type Response headers
200 Returns the form definition updated FormDefinitionResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_definition_response import FormDefinitionResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_definition_id = '00000000-0000-0000-0000-000000000000' # str | Form definition ID # str | Form definition ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    body = [{op=replace, path=/description, value=test-description}] # List[Dict[str, object]] | Body is the request payload to patch a form definition, check: https://jsonpatch.com (optional)
     body = [{op=replace, path=/description, value=test-description}] # List[Dict[str, object]] | Body is the request payload to patch a form definition, check: https://jsonpatch.com (optional)
    

    try:
        # Patch a form definition.
        
        api_response = api_instance.patch_form_definition(form_definition_id, x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.patch_form_definition(form_definition_id, x_sail_point_experimental, Result)
        print("The response of CustomFormsApi->patch_form_definition:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->patch_form_definition: %s\n" % e)

[Back to top]

patch-form-instance

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Patch a form instance. Parameter {formInstanceID} should match a form instance ID.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_instance_id str True Form instance ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Body body []Dict[str, object] (optional) Body is the request payload to patch a form instance, check: https://jsonpatch.com

Return type

FormInstanceResponse

Responses

Code Description Data Type Response headers
200 Returns the form instance updated FormInstanceResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
409 An error with the request property conflicts with stored SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_instance_response import FormInstanceResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_instance_id = '00000000-0000-0000-0000-000000000000' # str | Form instance ID # str | Form instance ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    body = [{op=replace, path=/state, value=SUBMITTED}, {op=replace, path=/formData, value={a-key-1=a-value-1, a-key-2=true, a-key-3=1}}] # List[Dict[str, object]] | Body is the request payload to patch a form instance, check: https://jsonpatch.com (optional)
     body = [{op=replace, path=/state, value=SUBMITTED}, {op=replace, path=/formData, value={a-key-1=a-value-1, a-key-2=true, a-key-3=1}}] # List[Dict[str, object]] | Body is the request payload to patch a form instance, check: https://jsonpatch.com (optional)
    

    try:
        # Patch a form instance.
        
        api_response = api_instance.patch_form_instance(form_instance_id, x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.patch_form_instance(form_instance_id, x_sail_point_experimental, Result)
        print("The response of CustomFormsApi->patch_form_instance:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->patch_form_instance: %s\n" % e)

[Back to top]

search-form-definitions-by-tenant

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Export form definitions by tenant. No parameters required.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Query offset int (optional) (default to 0) Offset Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in V3 API Standard Collection Parameters. The offset value is record-based, not page-based, and the index starts at 0.
Query limit int (optional) (default to 250) 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. If it is not specified, a default limit is used.
Query filters str (optional) Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: name: eq, gt, sw, in description: eq, gt, sw, in created: eq, gt, sw, in modified: eq, gt, sw, in
Query sorters str (optional) (default to 'name') Sort results using the standard syntax described in V3 API Standard Collection Parameters Sorting is supported for the following fields: name, description, created, modified

Return type

ListFormDefinitionsByTenantResponse

Responses

Code Description Data Type Response headers
200 Returns a list of form definitions by tenant ListFormDefinitionsByTenantResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.list_form_definitions_by_tenant_response import ListFormDefinitionsByTenantResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    offset = 0 # int | Offset  Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0) # int | Offset  Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-results). The offset value is record-based, not page-based, and the index starts at 0. (optional) (default to 0)
    limit = 250 # int | 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. (optional) (default to 250) # int | 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. (optional) (default to 250)
    filters = 'name sw \"my form\"' # str | 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:  **name**: *eq, gt, sw, in*  **description**: *eq, gt, sw, in*  **created**: *eq, gt, sw, in*  **modified**: *eq, gt, sw, in* (optional) # str | 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:  **name**: *eq, gt, sw, in*  **description**: *eq, gt, sw, in*  **created**: *eq, gt, sw, in*  **modified**: *eq, gt, sw, in* (optional)
    sorters = 'name' # str | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)  Sorting is supported for the following fields: **name, description, created, modified** (optional) (default to 'name') # str | Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)  Sorting is supported for the following fields: **name, description, created, modified** (optional) (default to 'name')

    try:
        # Export form definitions by tenant.
        
        api_response = api_instance.search_form_definitions_by_tenant(x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.search_form_definitions_by_tenant(x_sail_point_experimental, offset, limit, filters, sorters)
        print("The response of CustomFormsApi->search_form_definitions_by_tenant:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->search_form_definitions_by_tenant: %s\n" % e)

[Back to top]

search-form-element-data-by-element-id

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Retrieves dynamic data by element. Parameter {formInstanceID} should match a form instance ID. Parameter {formElementID} should match a form element ID at the data source configuration.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_instance_id str True Form instance ID
Path form_element_id str True Form element ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Query limit int (optional) (default to 250) 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. If it is not specified, a default limit is used.
Query filters str (optional) Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: value: eq, ne, in Supported composite operators: not Only a single not may be used, and it can only be used with the in operator. The not composite operator must be used in front of the field. For example, the following is valid: not value in (\"ID01\")
Query query str (optional) String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a "starts with" filter against several fields.

Return type

ListFormElementDataByElementIDResponse

Responses

Code Description Data Type Response headers
200 Retrieves dynamic data to aid in correctly completing a valid form by form element ID from data source configuration ListFormElementDataByElementIDResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.list_form_element_data_by_element_id_response import ListFormElementDataByElementIDResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_instance_id = '00000000-0000-0000-0000-000000000000' # str | Form instance ID # str | Form instance ID
    form_element_id = '1' # str | Form element ID # str | Form element ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    limit = 250 # int | 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. (optional) (default to 250) # int | 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. (optional) (default to 250)
    filters = 'value eq \"ID01\"' # str | 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*  Supported composite operators: *not*  Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (\"ID01\")` (optional) # str | 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*  Supported composite operators: *not*  Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (\"ID01\")` (optional)
    query = 'support' # str | String that is passed to the underlying API to filter other (non-ID) fields.  For example, for access  profile data sources, this string will be passed to the access profile api and used with a \"starts with\" filter against  several fields. (optional) # str | String that is passed to the underlying API to filter other (non-ID) fields.  For example, for access  profile data sources, this string will be passed to the access profile api and used with a \"starts with\" filter against  several fields. (optional)

    try:
        # Retrieves dynamic data by element.
        
        api_response = api_instance.search_form_element_data_by_element_id(form_instance_id, form_element_id, x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.search_form_element_data_by_element_id(form_instance_id, form_element_id, x_sail_point_experimental, limit, filters, query)
        print("The response of CustomFormsApi->search_form_element_data_by_element_id:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->search_form_element_data_by_element_id: %s\n" % e)

[Back to top]

search-form-instances-by-tenant

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: List form instances by tenant. No parameters required.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

ListFormInstancesByTenantResponse

Responses

Code Description Data Type Response headers
200 Returns a list of form instances by tenant ListFormInstancesByTenantResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.list_form_instances_by_tenant_response import ListFormInstancesByTenantResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # List form instances by tenant.
        
        api_response = api_instance.search_form_instances_by_tenant(x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.search_form_instances_by_tenant(x_sail_point_experimental)
        print("The response of CustomFormsApi->search_form_instances_by_tenant:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->search_form_instances_by_tenant: %s\n" % e)

[Back to top]

search-pre-defined-select-options

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: List predefined select options. No parameters required.

API Spec

Parameters

Param Type Name Data Type Required Description
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.

Return type

ListPredefinedSelectOptionsResponse

Responses

Code Description Data Type Response headers
200 Returns a list of available predefined select options ListPredefinedSelectOptionsResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.list_predefined_select_options_response import ListPredefinedSelectOptionsResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')

    try:
        # List predefined select options.
        
        api_response = api_instance.search_pre_defined_select_options(x_sail_point_experimental)
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.search_pre_defined_select_options(x_sail_point_experimental)
        print("The response of CustomFormsApi->search_pre_defined_select_options:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->search_pre_defined_select_options: %s\n" % e)

[Back to top]

show-preview-data-source

:::warning experimental This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint. ::: Preview form definition data source.

API Spec

Parameters

Param Type Name Data Type Required Description
Path form_definition_id str True Form definition ID
x_sail_point_experimental str True (default to 'true') Use this header to enable this experimental API.
Query limit int (optional) (default to 10) 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. If it is not specified, a default limit is used.
Query filters str (optional) Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: value: eq, ne, in Supported composite operators: not Only a single not may be used, and it can only be used with the in operator. The not composite operator must be used in front of the field. For example, the following is valid: not value in (\"ID01\")
Query query str (optional) String that is passed to the underlying API to filter other (non-ID) fields. For example, for access profile data sources, this string will be passed to the access profile api and used with a "starts with" filter against several fields.
Body form_element_preview_request FormElementPreviewRequest (optional) Body is the request payload to create a form definition dynamic schema

Return type

PreviewDataSourceResponse

Responses

Code Description Data Type Response headers
200 Returns a preview of a form definition data source PreviewDataSourceResponse -
400 An error with the request occurred SearchFormDefinitionsByTenant400Response -
401 An error with the authorization occurred SearchFormDefinitionsByTenant400Response -
403 An error with the user permissions occurred SearchFormDefinitionsByTenant400Response -
404 An error with the item not found SearchFormDefinitionsByTenant400Response -
429 Too many requests Error -
500 An internal server error occurred SearchFormDefinitionsByTenant400Response -

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import sailpoint.v2024
from sailpoint.v2024.models.form_element_preview_request import FormElementPreviewRequest
from sailpoint.v2024.models.preview_data_source_response import PreviewDataSourceResponse
from sailpoint.v2024.rest import ApiException
from pprint import pprint

    form_definition_id = '00000000-0000-0000-0000-000000000000' # str | Form definition ID # str | Form definition ID
    x_sail_point_experimental = 'true' # str | Use this header to enable this experimental API. (default to 'true') # str | Use this header to enable this experimental API. (default to 'true')
    limit = 10 # int | 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. (optional) (default to 10) # int | 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. (optional) (default to 10)
    filters = 'value eq \"ID01\"' # str | 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*  Supported composite operators: *not*  Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (\"ID01\")` (optional) # str | 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*  Supported composite operators: *not*  Only a single *not* may be used, and it can only be used with the `in` operator. The `not` composite operator must be used in front of the field. For example, the following is valid: `not value in (\"ID01\")` (optional)
    query = 'ac' # str | String that is passed to the underlying API to filter other (non-ID) fields.  For example, for access  profile data sources, this string will be passed to the access profile api and used with a \"starts with\" filter against  several fields. (optional) # str | String that is passed to the underlying API to filter other (non-ID) fields.  For example, for access  profile data sources, this string will be passed to the access profile api and used with a \"starts with\" filter against  several fields. (optional)
    form_element_preview_request = {
          "dataSource" : {
            "config" : {
              "indices" : [ "identities" ],
              "query" : "*",
              "aggregationBucketField" : "attributes.cloudStatus.exact",
              "objectType" : "IDENTITY"
            },
            "dataSourceType" : "STATIC"
          }
        } # FormElementPreviewRequest | Body is the request payload to create a form definition dynamic schema (optional)

    try:
        # Preview form definition data source.
        
        api_response = api_instance.show_preview_data_source(form_definition_id, x_sail_point_experimental, )
        
        # Below is a request that includes all optional parameters
        # api_response = api_instance.show_preview_data_source(form_definition_id, x_sail_point_experimental, limit, filters, query, Result)
        print("The response of CustomFormsApi->show_preview_data_source:\n")
        pprint(api_response)
    except Exception as e:
        print("Exception when calling CustomFormsApi->show_preview_data_source: %s\n" % e)

[Back to top]