id | string | read-only | Unique identifier of this configuration, assigned by the server. |
connector_id | string | ✅ | 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_type | enum | ✅ | The approval record type these settings apply to, such as REQUEST_ITEM, CHANGE_REQUEST, or TIME_OFF_REQUEST. Cannot be changed after creation. One of: REQUEST_ITEM, SERVICE_REQUEST, INCIDENT, CHANGE_REQUEST, TIME_OFF_REQUEST, ACCESS_REVIEW, POLICY_EXCEPTION, LEAVE_OF_ABSENCE, … (16 values). |
buttons | array<ButtonSettings> | | Buttons shown to the approver, defining the actions they can take or links to external systems. |
link_strategy | LinkStrategySettings | | How the approval record links to the external system. |
mapper_bender | object | | 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_bender | object | | 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_retrievers | array<DataRetrieverSettings> | | Data retrievers that fetch additional details for approval records. Their output is available to augmenter_bender. |
record_prefilter_dsl | string | | 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_dsl | string | | DSL rule filtering approval records by their fields. Excluded records send no notifications and do not appear in the approver’s queue. |
notification_filter_dsl | string | | 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_keys | array<string> | | External system resource keys that map to this resource type, for systems that have multiple resource types. |
updated_time | string | read-only | When the configuration was last updated. |
updated_by | string | read-only | Who last updated the configuration. |
version | Version | ✅ | Document version. On update, send back the num from your last read. |