Read or change one of the triggers by id. derived from route
URL
- Service tierhttps://agents.mattering.io/api/internal/v1/agents/{public_id}/triggers/
Path parameters
| Name | Type |
|---|---|
public_id | str |
Body keys (JSON)
| Key | Required | Default |
|---|---|---|
action | optional or conditional | none |
filter_config | optional or conditional | none |
id | optional or conditional | none |
knowledge_source_ids | optional or conditional | none |
name | optional or conditional | none |
preset | optional or conditional | none |
prompt | optional or conditional | none |
space_id | optional or conditional | none |
tool_names | optional or conditional | none |
trigger_type | optional or conditional | none |
Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.
Responses
200 data and meta envelope
{
"data": [
{
"id": "...",
"name": "...",
"trigger_type": "...",
"filter_config": "...",
"prompt": "...",
"tool_names": [
"..."
],
"knowledge_source_ids": [
"..."
],
"space_id": "...",
"status": "...",
"last_fired_at": "2026-01-01T00:00:00Z",
"total_invocations": 0,
"consecutive_errors": "...",
"conversation_id": "...",
"created_by_email": "...",
"fire_path": "...",
"secret": "..."
}
]
}
200 data and meta envelope
{
"data": {
"id": "...",
"name": "...",
"trigger_type": "...",
"filter_config": "...",
"prompt": "...",
"tool_names": [
"..."
],
"knowledge_source_ids": [
"..."
],
"space_id": "...",
"status": "...",
"last_fired_at": "2026-01-01T00:00:00Z",
"total_invocations": 0,
"consecutive_errors": "...",
"conversation_id": "...",
"created_by_email": "...",
"fire_path": "...",
"secret": "..."
}
}
200 data and meta envelope
{
"data": {
"deleted": true
}
}
201 data and meta envelope
{
"data": {
"id": "...",
"name": "...",
"trigger_type": "...",
"filter_config": "...",
"prompt": "...",
"tool_names": [
"..."
],
"knowledge_source_ids": [
"..."
],
"space_id": "...",
"status": "...",
"last_fired_at": "2026-01-01T00:00:00Z",
"total_invocations": 0,
"consecutive_errors": "...",
"conversation_id": "...",
"created_by_email": "...",
"fire_path": "...",
"secret": "..."
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 400 | invalid_preset |
| 400 | invalid_trigger_type |
| 400 | name_required |
| 400 | unknown_action |
| 403 | manage_required |
| 404 | agent_not_found |
| 404 | trigger_not_found |
Example
curl -X POST "https://agents.mattering.io/api/internal/v1/agents/PUBLIC_ID/triggers/" \
-H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
-H "X-Internal-Org-Id: $ORG_ID" \
-H "X-Internal-User-Email: you@example.com" \
-H "Content-Type: application/json" \
-d '{
"action": "...",
"filter_config": "...",
"id": "...",
"knowledge_source_ids": "...",
"name": "...",
"preset": "...",
"prompt": "...",
"space_id": "..."
}'
Source: MatterCore/agents_api.py (agents_api.agent_triggers)