Deletes a form definition.

DELETE 
/form-definitions/:formDefinitionID

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.

Parameter {formDefinitionID} should match a form definition ID.

Request

Path Parameters

formDefinitionID stringrequired
Form definition ID
Example: 00000000-0000-0000-0000-000000000000

Header Parameters

X-SailPoint-Experimental stringrequired
Default value: true
Use this header to enable this experimental API.
Example: true

Responses

204

Returns an empty body

application/json

Schema

Schema

object

Example (from schema)

{}

400

An error with the request occurred

application/json

Schema

Schema

detailCode string

messages

object[]

Array [

locale string

Locale is the current Locale

localeOrigin string

LocaleOrigin holds possible values of how the locale was selected

text string

Text is the actual text of the error message

]

statusCode int64
trackingId string

Example (from schema)

{
  "detailCode": "string",
  "messages": [
    {
      "locale": "en-US",
      "localeOrigin": "DEFAULT",
      "text": "This is an error"
    }
  ],
  "statusCode": 0,
  "trackingId": "string"
}

401

An error with the authorization occurred

application/json

Schema

Schema

detailCode string

messages

object[]

Array [

locale string

Locale is the current Locale

localeOrigin string

LocaleOrigin holds possible values of how the locale was selected

text string

Text is the actual text of the error message

]

statusCode int64
trackingId string

Example (from schema)

{
  "detailCode": "string",
  "messages": [
    {
      "locale": "en-US",
      "localeOrigin": "DEFAULT",
      "text": "This is an error"
    }
  ],
  "statusCode": 0,
  "trackingId": "string"
}

403

An error with the user permissions occurred

application/json

Schema

Schema

detailCode string

messages

object[]

Array [

locale string

Locale is the current Locale

localeOrigin string

LocaleOrigin holds possible values of how the locale was selected

text string

Text is the actual text of the error message

]

statusCode int64
trackingId string

Example (from schema)

{
  "detailCode": "string",
  "messages": [
    {
      "locale": "en-US",
      "localeOrigin": "DEFAULT",
      "text": "This is an error"
    }
  ],
  "statusCode": 0,
  "trackingId": "string"
}

404

An error with the item not found

application/json

Schema

Schema

detailCode string

messages

object[]

Array [

locale string

Locale is the current Locale

localeOrigin string

LocaleOrigin holds possible values of how the locale was selected

text string

Text is the actual text of the error message

]

statusCode int64
trackingId string

Example (from schema)

{
  "detailCode": "string",
  "messages": [
    {
      "locale": "en-US",
      "localeOrigin": "DEFAULT",
      "text": "This is an error"
    }
  ],
  "statusCode": 0,
  "trackingId": "string"
}

429

Too many requests

application/json

Schema

Schema

detailCode string

DetailCode is the text of the status code returned

messages

object[]

Array [

locale string

Locale is the current Locale

localeOrigin string

LocaleOrigin holds possible values of how the locale was selected

text string

Text is the actual text of the error message

]

trackingId string

TrackingID is the request tracking unique identifier

Example (from schema)

{
  "detailCode": "Internal Server Error",
  "messages": [
    {
      "locale": "en-US",
      "localeOrigin": "DEFAULT",
      "text": "This is an error"
    }
  ],
  "trackingId": "9cd03ef80e6a425eb6b11bdbb057cdb4"
}

500

An internal server error occurred

application/json

Schema

Schema

detailCode string

messages

object[]

Array [

locale string

Locale is the current Locale

localeOrigin string

LocaleOrigin holds possible values of how the locale was selected

text string

Text is the actual text of the error message

]

statusCode int64
trackingId string

Example (from schema)

{
  "detailCode": "string",
  "messages": [
    {
      "locale": "en-US",
      "localeOrigin": "DEFAULT",
      "text": "This is an error"
    }
  ],
  "statusCode": 0,
  "trackingId": "string"
}

Loading...