[comment]: # ({be70f0cc-be70f0cc})
# triggerprototype.update

[comment]: # ({/be70f0cc-be70f0cc})

[comment]: # ({0af53e19-842b5955})
### Descrição

`object triggerprototype.update(object/array triggerPrototypes)`

Este método permite atualizar protótipos de trigger existentes.

::: noteclassic
Este método está disponível apenas para os tipos de usuário *Admin* e *Super admin*. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações.
:::

[comment]: # ({/0af53e19-842b5955})

[comment]: # ({db615d69-827e4920})
### Parâmetros

`(object/array)` Propriedades do trigger prototype a serem atualizadas.

A propriedade `triggerid` deve ser definida para cada trigger prototype, todas
as outras propriedades são opcionais. Somente as propriedades passadas serão
atualizadas, todas as outras permanecerão inalteradas.

Além das [propriedades padrão do trigger prototype](object#trigger-prototype), o método aceita os seguintes
parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|dependencies|array|[Triggers](/manual/api/reference/trigger/object#trigger) e [trigger prototypes](/manual/api/reference/triggerprototype/object#trigger-prototype) dos quais o trigger prototype depende.<br><br>Os triggers devem ter apenas a propriedade `triggerid` definida.|
|tags|array|[Tags do trigger prototype](/manual/api/reference/triggerprototype/object#trigger-prototype-tag).|

[comment]: # ({/db615d69-827e4920})

[comment]: # ({200d7b9d-200d7b9d})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs dos protótipos de trigger atualizados na propriedade `triggerids`.

[comment]: # ({/200d7b9d-200d7b9d})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({7b2a44a5-bcca41dc})
#### Habilitando um protótipo de trigger

Habilite um protótipo de trigger, ou seja, defina seu status como "0".

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "triggerprototype.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "13938"
        ]
    },
    "id": 1
}
```

[comment]: # ({/7b2a44a5-bcca41dc})

[comment]: # ({708ac736-724af3ce})
#### Substituindo tags de protótipos de trigger

Substitua as tags para um protótipo de trigger.

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "triggerprototype.update",
    "params": {
        "triggerid": "17373",
        "tags": [
            {
                "tag": "volume",
                "value": "{#FSNAME}"
            },
            {
                "tag": "type",
                "value": "{#FSTYPE}"
            }
        ]
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "triggerids": [
            "17373"
        ]
    },
    "id": 1
}
```

[comment]: # ({/708ac736-724af3ce})

[comment]: # ({585ae96a-585ae96a})
### Origem

CTriggerPrototype::update() em
*ui/include/classes/api/services/CTriggerPrototype.php*.

[comment]: # ({/585ae96a-585ae96a})