Create callback rules¶

Create rules that route provider callback events to workspace resources.

POST https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/callback-rules

Before you call¶

The example below uses $AI_STUDIO_API_KEY and $WORKSPACE_ID.

Request example¶

curl -X POST "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/callback-rules" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "provider": "github",
    "credential_ref": "credential_01",
    "name": "Issue 回调",
    "target_type": "agent"
  }'

Request body¶

Parameters	Type	Is it required	Description
`provider`	string	Yes	The callback provider ID.
`credential_ref`	string	Yes	Provider credentials reference.
`name`	string	Yes	The name of the callback rule.
`target_type`	string	Yes	The callback target type.
`description`	string	No	Callback rule description.
`enabled`	boolean	No	Whether to enable the rule.
`priority`	integer	No	Match priority.
`match`	object	No	Matching criteria, which can include `resource_kinds`, `event_types`, `event_actions`, and `field_equals`.
`target_config`	object	No	Callback target configuration.
`stop_after_match`	boolean	No	Whether to stop matching after hitting this rule.

Successful response¶

Returns 201 and a new rule on success.

{"code":0,"data":{"id":"rule_01"}}

The response fields are as follows.

Field	Type	Description
`data.id`	string	New callback rule ID.

Error response¶

{"code":2,"message":"invalid callback rule"}

Last updated on Sep 3, 2026