Menu

Triggers

2 endpoints in the Mattering Agents API. Service tier only.

GETPOST agents/{public_id}/triggers/ Service tier

Read or change one of the triggers by id. derived from route

This read is not paginated. It returns at most 120 rows and does not report a total, so a result of exactly 120 may be truncated.

URL

  • Service tierhttps://agents.mattering.io/api/internal/v1/agents/{public_id}/triggers/

Path parameters

NameType
public_idstr

Body keys (JSON)

KeyRequiredDefault
actionoptional or conditionalnone
filter_configoptional or conditionalnone
idoptional or conditionalnone
knowledge_source_idsoptional or conditionalnone
nameoptional or conditionalnone
presetoptional or conditionalnone
promptoptional or conditionalnone
space_idoptional or conditionalnone
tool_namesoptional or conditionalnone
trigger_typeoptional or conditionalnone

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

StatusCode
400invalid_preset
400invalid_trigger_type
400name_required
400unknown_action
403manage_required
404agent_not_found
404trigger_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)

GET trigger-types/ Service tier

List triggers. derived from route

URL

  • Service tierhttps://agents.mattering.io/api/internal/v1/trigger-types/

Responses

200 data and meta envelope

{
  "data": "..."
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Example

curl -X GET "https://agents.mattering.io/api/internal/v1/trigger-types/" \
  -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \
  -H "X-Internal-Org-Id: $ORG_ID" \
  -H "X-Internal-User-Email: you@example.com"

Source: MatterCore/agents_api.py (agents_api.trigger_types)

All Agents resources
Start Free Explore our Products