Sample - Asana API
POST/rule_triggers/{rule_trigger_gid}/run

Trigger a rule

Triggers a rule that uses an incoming web request trigger. Provide resource and action_data in the data object; during the beta, resource must identify an existing task in the project where the rule was created.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 body field

A dictionary of variables accessible from within the rule.

dataobjectoptional
The rule trigger data containing the resource identifier and dynamic action values.

7 status codes
200Returns a response containing a message confirming that the rule was triggered.
dataobjectoptional
400Returned when the request is missing required trigger data or contains malformed input.
errorsarray<object>optional
401Returned when the request does not include a valid authentication token.
errorsarray<object>optional
402Returned when triggering the rule exceeds the current premium level.
errorsarray<object>optional
403Returned when the authenticated user does not have permission to trigger the rule.
errorsarray<object>optional
404Returned when the rule or referenced resource does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the rule from being triggered.
errorsarray<object>optional

Error handling

The request must include resource and action_data in data; resource must identify an existing task in the rule's project. A 400 is returned for missing or malformed data, a 401 when no valid authentication token is provided, and a 403 when the authenticated user cannot trigger the rule. A 404 indicates that the rule or referenced task does not exist; 402 indicates that the operation exceeds the current premium level, and 500 indicates a server-side failure.