# task_relation_save

Set Task Relation

## Beschreibung

Add or remove a task relation within the same account. source_task watches target_task resumes the agent's source task when the target changes. Task delegation creates this relation automatically.

## Zugriff

Zugriffsprofil: `gated`. Module: `projects_tasks`, `simple_projects_tasks`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja |  |
| `source_task_id` | string | Ja |  |
| `target_task_id` | string | Ja |  |
| `kind` | string | Ja |  |
| `active` | boolean | Nein |  |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "source_task_id": {
      "type": "string"
    },
    "target_task_id": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "blocks",
        "related_to",
        "duplicate_of",
        "watches"
      ]
    },
    "active": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "account_id",
    "source_task_id",
    "target_task_id",
    "kind"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "relation": {
      "type": "object",
      "properties": {
        "id": {
          "type": [
            "string",
            "null"
          ]
        },
        "source_task_id": {
          "type": "string"
        },
        "target_task_id": {
          "type": "string"
        },
        "kind": {
          "type": "string"
        },
        "active": {
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "source_task_id",
        "target_task_id",
        "kind",
        "active"
      ]
    }
  },
  "required": [
    "relation"
  ],
  "type": "object"
}
```