Raw schema
{
"type": "object",
"properties": {
"agent_id": {
"type": "string",
"description": "Linked agent sending the message"
},
"session_token": {
"description": "Session token from agent_authenticate — required whenever agent_id is passed",
"type": "string"
},
"to": {
"anyOf": [
{
"type": "string",
"const": "all",
"description": "Every current member of the linked org"
},
{
"type": "object",
"properties": {
"user_id": {
"type": "string",
"description": "One org member user_id from agent_organization"
}
},
"required": [
"user_id"
]
},
{
"type": "object",
"properties": {
"user_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Org member user_ids from agent_organization"
}
},
"required": [
"user_ids"
]
},
{
"type": "object",
"properties": {
"role": {
"type": "string",
"description": "Org role: OWNER, OPS, FINANCE, DEVELOPER, or VIEWER"
}
},
"required": [
"role"
]
},
{
"type": "object",
"properties": {
"roles": {
"type": "array",
"items": {
"type": "string"
},
"description": "One or more org roles"
}
},
"required": [
"roles"
]
},
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Exact member email from agent_organization — not an arbitrary address"
}
},
"required": [
"email"
]
}
],
"description": "Who to notify: \"all\", { user_id }, { user_ids }, { role }, { roles }, or { email } matching an org member. Never an address outside the org."
},
"title": {
"type": "string",
"description": "Subject line, max 120 characters"
},
"body": {
"type": "string",
"description": "Plain-text body, max 4000 characters. Conduit wraps HTML; do not send markup."
},
"channel": {
"description": "Delivery channel. Email only — omit or pass email",
"type": "string"
},
"severity": {
"description": "info (default), warning, or urgent — affects subject prefix and accent",
"type": "string",
"enum": [
"info",
"warning",
"urgent"
]
},
"actions": {
"description": "Optional buttons, max 3. Hosts outside Conduit are rejected.",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Button label, e.g. View Invoices"
},
"type": {
"description": "Button style (default primary)",
"type": "string",
"enum": [
"primary",
"danger",
"ghost"
]
},
"url": {
"type": "string",
"description": "https URL on hub.aiconduit.app, aiconduit.app, or mcp.aiconduit.app, or a Hub path like /invoices"
}
},
"required": [
"title",
"url"
]
}
},
"idempotency_key": {
"description": "Replay key — same agent + key returns the original notify_id without sending again",
"type": "string"
},
"order_id": {
"description": "Optional order correlation",
"type": "string"
},
"search_id": {
"description": "Optional search correlation",
"type": "string"
},
"dry_run": {
"description": "If true, resolve recipients and from-address without sending or storing",
"type": "boolean"
}
},
"required": [
"agent_id",
"to",
"title",
"body"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}