Case Triggers

Configure case triggers that automatically dispatch agent runs (Jobs in the Duvo UI) for cases added to a queue

get

List the case triggers configured for an agent. Each trigger automatically dispatches the agent to run cases added to a queue.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

agent_idstring · uuidRequired

The agent's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/agents/{agent_id}/case-triggers

HTTPcURLJavaScriptPython

GET /v1/agents/{agent_id}/case-triggers HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "case_triggers": [
    {
      "id": "text",
      "agent_id": "text",
      "case_queue_id": "text",
      "case_queue_name": "text",
      "user_id": "text",
      "enabled": true,
      "concurrency": 1,
      "created_at": "text",
      "updated_at": "text",
      "creator_display_name": "text",
      "can_disable": true,
      "has_conflict": true,
      "conflicting_agents": [
        {
          "id": "text",
          "name": "text"
        }
      ]
    }
  ]
}

post

Create a case trigger for an agent. An agent may have at most one case trigger; this returns 409 if one already exists.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

agent_idstring · uuidRequired

The agent's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Body

application/json

case_queue_idstring · uuidRequired

Queue whose new cases should trigger this agent

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

enabledbooleanRequired

Whether the trigger is active. Disabled triggers do not dispatch runs.

concurrencyinteger · max: 9007199254740991 · nullableOptional

Maximum number of concurrent runs for this trigger. Null/omitted means unlimited.

Responses

201

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

409

Default Response

application/json

500

Default Response

application/json

post

/v1/agents/{agent_id}/case-triggers

HTTPcURLJavaScriptPython

POST /v1/agents/{agent_id}/case-triggers HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "case_queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "enabled": true,
  "concurrency": 1
}

{
  "case_trigger": {
    "id": "text",
    "agent_id": "text",
    "case_queue_id": "text",
    "case_queue_name": "text",
    "user_id": "text",
    "enabled": true,
    "concurrency": 1,
    "created_at": "text",
    "updated_at": "text",
    "creator_display_name": "text",
    "can_disable": true,
    "has_conflict": true,
    "conflicting_agents": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
}

get

Preview which other agents would conflict with this agent's case trigger if it pointed at the given case queue. Does not modify the trigger.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

agent_idstring · uuidRequired

The agent's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Query parameters

case_queue_idstring · uuidRequired

The case queue to check for conflicts against

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

has_conflictbooleanRequired

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/agents/{agent_id}/case-triggers/conflict-preview

HTTPcURLJavaScriptPython

GET /v1/agents/{agent_id}/case-triggers/conflict-preview?case_queue_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "has_conflict": true,
  "conflicting_agents": [
    {
      "id": "text",
      "name": "text"
    }
  ]
}

get

Retrieve a single case trigger by id.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

agent_idstring · uuidRequired

The agent's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

trigger_idstring · uuidRequired

The case trigger's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/agents/{agent_id}/case-triggers/{trigger_id}

HTTPcURLJavaScriptPython

GET /v1/agents/{agent_id}/case-triggers/{trigger_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "case_trigger": {
    "id": "text",
    "agent_id": "text",
    "case_queue_id": "text",
    "case_queue_name": "text",
    "user_id": "text",
    "enabled": true,
    "concurrency": 1,
    "created_at": "text",
    "updated_at": "text",
    "creator_display_name": "text",
    "can_disable": true,
    "has_conflict": true,
    "conflicting_agents": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
}

delete

Delete a case trigger. Only the trigger creator or a builder/admin can delete it.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

agent_idstring · uuidRequired

The agent's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

trigger_idstring · uuidRequired

The case trigger's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

successboolean · enumRequiredPossible values:

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/agents/{agent_id}/case-triggers/{trigger_id}

HTTPcURLJavaScriptPython

DELETE /v1/agents/{agent_id}/case-triggers/{trigger_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

patch

Update fields on a case trigger. Only the trigger creator or a builder/admin can disable an enabled trigger or change its queue.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

agent_idstring · uuidRequired

The agent's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

trigger_idstring · uuidRequired

The case trigger's unique identifier

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Body

application/json

case_queue_idstring · uuidOptional

Queue whose new cases should trigger this agent

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

enabledbooleanOptional

Whether the trigger is active. Disabled triggers do not dispatch runs.

concurrencyinteger · max: 9007199254740991 · nullableOptional

Maximum number of concurrent runs for this trigger. Null clears the limit.

Responses

200

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

patch

/v1/agents/{agent_id}/case-triggers/{trigger_id}

HTTPcURLJavaScriptPython

PATCH /v1/agents/{agent_id}/case-triggers/{trigger_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "case_queue_id": "123e4567-e89b-12d3-a456-426614174000",
  "enabled": true,
  "concurrency": 1
}

{
  "case_trigger": {
    "id": "text",
    "agent_id": "text",
    "case_queue_id": "text",
    "case_queue_name": "text",
    "user_id": "text",
    "enabled": true,
    "concurrency": 1,
    "created_at": "text",
    "updated_at": "text",
    "creator_display_name": "text",
    "can_disable": true,
    "has_conflict": true,
    "conflicting_agents": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
}