Skip to main content
POST
/
api
/
agents
/
{agentId}
/
trigger
/
save
cURL
curl -X POST "https://app.cotool.ai/api/agents/:agentId/trigger/save" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"triggerId":"string","name":"string","description":"string","secret":"string","webhookUrl":"string","source":"jira","createAlert":true}'
{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "enabled": true,
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "config": {},
    "description": "<string>",
    "secret": "<string>",
    "cronSchedule": "<string>",
    "emailAddress": "<string>",
    "lastRunAttemptedAt": "<string>",
    "lastRunSucceededAt": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication for programmatic access. Include your API key in the Authorization header as: Bearer your_api_key_here

Path Parameters

​
agentId
string<uuid>
required

Unique identifier of the agent

Body

application/json

Request body for creating a new trigger, with different fields required based on the source type

​
triggerId
string<uuid>
required

Unique identifier for the trigger

​
name
string
required

Display name for the trigger

​
secret
string
required

Secret for webhook authentication

​
webhookUrl
string
required

Webhook URL for Jira to call

​
source
string
required
Allowed value: "jira"
​
description
string

Optional description of what this trigger does

​
createAlert
boolean

Whether each trigger invocation should create an alert

Response

Successful response

​
success
boolean
required
​
data
object
required