ActionOverwrites

Introduction

ActionOverwrites allow context-specific adjustments of an Action without modifying the base Action itself.

Typical use case: an Action is defined on a Trigger, but for a specific relatable entity (for example a task assignment), parts of the action config or targetables should differ.

Rich-text values that override type-specific config.text, config.body, or config.description keys use the shared Rich Text HTML format.

Overwritten System Variable-enabled text fields must contain valid rendered templates. An overwritten computed_targetables_system_variable uses key-only syntax.

Model Definition

Relations

Key	Relation	Type	Relation Field(s)
action	Action	Belongs To	action_id
relatable	(Polymorphic)	Morph To	relatable_type, relatable_id
users	User	Belongs To Many	Pivot user_action_overwrite
departments	Department	Belongs To Many	Pivot department_action_overwrite

Relatable Types

• taskAssignment - Applies the overwrite to a TaskAssignment context.

Capabilities

• Targetables - When apply_targetables is true, overwrite targeting replaces the base action's recipients for the related context.

Create

Create a new ActionOverwrite.

Definition

POST /api/action-overwrites

Request Keys

Key	Type	Default	Description
action_id*	integer	-	ID of the base Action that is overridden.
relatable_type*	string	-	Selects one of the supported Relatable Types.
relatable_id*	integer	-	ID of the context entity for this overwrite.
config*	object	-	Partial override config for the selected Action type.
apply_targetables	boolean	false	Whether overwrite targetables should be applied.
assign_mode	string	none	Targeting strategy selected from the shared Assignment Modes.
computed_targetable_type	string | null	null	Optional Computed Targetable Type; the supported subset depends on the base Action type.
user_ids	integer[]	[] (for assign mode none/all/...)	Explicit target users for the overwrite.
department_ids	integer[]	[] (for assign mode none/all/...)	Explicit target departments for the overwrite.

Keys with * are required.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/action-overwrites', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'action_id' => 77,
        'relatable_type' => 'taskAssignment',
        'relatable_id' => 123,
        'config' => [
            'computed_targetables_system_variable' => 'system.user'
        ],
        'apply_targetables' => true,
        'assign_mode' => 'any_of',
        'computed_targetable_type' => 'for_system_variable_users',
        'user_ids' => [5]
    ]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 1,
    "action_id": 77,
    "relatable_type": "taskAssignment",
    "relatable_id": 123,
    "config": {
      "computed_targetables_system_variable": "system.user"
    },
    "apply_targetables": true,
    "assign_mode": "any_of",
    "computed_targetable_type": "for_system_variable_users",
    "created_at": "2024-01-01 10:00:00",
    "updated_at": "2024-01-01 10:00:00",
    "deleted_at": null
  }
}

Update

Update an existing ActionOverwrite.

Definition

PUT /api/action-overwrites/{actionOverwrite}

Route Parameters

Parameter	Type	Description
actionOverwrite	integer	ActionOverwrite ID.

Request Keys

Key	Type	Default	Description
action_id	integer	-	New base Action ID.
relatable_type	string	-	Selects one of the supported Relatable Types.
relatable_id	integer	-	New context entity ID.
config	object	-	Updated partial override config.
apply_targetables	boolean	-	Updated flag to apply overwrite targetables.
assign_mode	string	current assign mode	Updated targeting strategy selected from the shared Assignment Modes.
computed_targetable_type	string | null	-	Updated Computed Targetable Type; the supported subset depends on the base Action type.
user_ids	integer[]	[] (for assign mode none/all/...)	Updated target users for the overwrite.
department_ids	integer[]	[] (for assign mode none/all/...)	Updated target departments for the overwrite.

Behavior

Only submitted keys are updated.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('PUT', '/api/action-overwrites/1', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'config' => [
            'computed_targetables_entity_select_field_ids' => [123, 456, 78]
        ],
        'apply_targetables' => true,
        'assign_mode' => 'any_of',
        'computed_targetable_type' => 'from_entity_select_fields_users',
        'user_ids' => [8]
    ]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 1,
    "action_id": 77,
    "relatable_type": "taskAssignment",
    "relatable_id": 123,
    "config": {
      "computed_targetables_entity_select_field_ids": [123, 456, 78]
    },
    "apply_targetables": true,
    "assign_mode": "any_of",
    "computed_targetable_type": "from_entity_select_fields_users",
    "created_at": "2024-01-01 10:00:00",
    "updated_at": "2024-01-02 11:00:00",
    "deleted_at": null
  }
}

Delete

Delete an ActionOverwrite.

Definition

DELETE /api/action-overwrites/{actionOverwrite}

Route Parameters

Parameter	Type	Description
actionOverwrite	integer	ActionOverwrite ID.

Example Request

PHP

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('DELETE', '/api/action-overwrites/1', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "status": "success",
  "data": null
}