Skip to navigation

Update approval resource

View as Markdown

Changes the fields you send and returns the full updated document.

Send only the fields you want to change, plus version with the num from your last read and a change_description. This is a JSON merge-patch: a field you leave out keeps its stored value, and every list or map you send replaces the stored one whole. The id goes in the URL; if you also send id in the body it must match.

Authentication

AuthorizationBearer

JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.

Path parameters

idstringRequired

The id of the approval resource, as returned when it was created or listed.

Request

This endpoint expects an object.
versionobjectRequired
Document version. On update, send back the num from your last read.
buttonslist of objectsOptional
Buttons shown to the approver, defining the actions they can take or links to external systems.
mapper_benderobjectOptional
Data mapping that builds the approval record from external system attributes, controlling how it looks to the approver. If empty, the system defaults are used.
augmenter_benderobjectOptional

Data mapping that adds extra details to the approval record. Its input includes the output of mapper_bender and data from augmenting_data_retrievers. If empty, the system defaults are used.

augmenting_data_retrieverslist of objectsOptional

Data retrievers that fetch additional details for approval records. Their output is available to augmenter_bender.

record_prefilter_dslstringOptional
DSL rule selecting which approval records are processed and stored. Excluded records send no notifications and do not appear in the approver's queue. Leave empty to include all. Must be a valid MWDSL expression.
database_filter_dslstringOptional
DSL rule filtering approval records by their fields. Excluded records send no notifications and do not appear in the approver's queue. Must be a valid MWDSL expression.
notification_filter_dslstringOptional
DSL rule selecting which approval records send a notification to the approver. Records without a notification still appear in the approver's queue. Must be a valid MWDSL expression.
external_resource_keyslist of stringsOptional
External system resource keys that map to this resource type, for systems that have multiple resource types.

Response

The updated approval resource, at its new version
idstringOptionalRead-only
Unique identifier of this configuration, assigned by the server.
connector_idstringOptionalformat: "uuid">=1 character

The connector these approval settings apply to. Each connector and resource type pair can have only one configuration; cannot be changed after creation. ID of an existing connector (GET /configurations/v1alpha1/platform/connectors).

resource_typeenumOptional

The approval record type these settings apply to, such as REQUEST_ITEM, CHANGE_REQUEST, or TIME_OFF_REQUEST. Cannot be changed after creation.

buttonslist of objectsOptional
Buttons shown to the approver, defining the actions they can take or links to external systems.
mapper_benderobjectOptional
Data mapping that builds the approval record from external system attributes, controlling how it looks to the approver. If empty, the system defaults are used.
augmenter_benderobjectOptional

Data mapping that adds extra details to the approval record. Its input includes the output of mapper_bender and data from augmenting_data_retrievers. If empty, the system defaults are used.

augmenting_data_retrieverslist of objectsOptional

Data retrievers that fetch additional details for approval records. Their output is available to augmenter_bender.

record_prefilter_dslstringOptional
DSL rule selecting which approval records are processed and stored. Excluded records send no notifications and do not appear in the approver's queue. Leave empty to include all.
database_filter_dslstringOptional
DSL rule filtering approval records by their fields. Excluded records send no notifications and do not appear in the approver's queue.
notification_filter_dslstringOptional
DSL rule selecting which approval records send a notification to the approver. Records without a notification still appear in the approver's queue.
external_resource_keyslist of stringsOptional
External system resource keys that map to this resource type, for systems that have multiple resource types.
updated_timedatetimeOptionalRead-only
When the configuration was last updated.
updated_bystringOptionalRead-only
Who last updated the configuration.
versionobjectOptional
Document version. On update, send back the num from your last read.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error