Set the intent's action (event)

curl --request PUT \
  --url https://{subdomain}.mihu.ai/api/v1/agents/{uuid}/intents/{intentUuid}/event \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_type": "app",
  "app_uid": "1f0a…",
  "action_key": "ai_query",
  "config": {
    "table_uuid": "…",
    "max_results": 10,
    "query_description": "Order tracking table. durum = status."
  }
}
'

{
  "success": true,
  "message": "Intent event updated successfully",
  "data": {
    "event_type": "app",
    "status": "draft",
    "app": {
      "uid": "1f0a…",
      "name": "Tables",
      "is_builtin": true
    },
    "action": {
      "key": "ai_query",
      "name": "AI Query"
    },
    "app_connection_uuid": null,
    "config": {
      "table_uuid": "…",
      "max_results": 10,
      "query_description": "…"
    }
  }
}

Agents

Set the intent's action (event)

Sets (replaces) the single action the intent performs. Pick event_type and provide its fields:

webhook → webhook.url (+ optional webhook.auth_token).
app → app_uid + action_key (+ config). Built-in apps need no connection (omit app_connection_uuid). External apps require app_connection_uuid — an already-connected, active account; the API cannot create/authenticate connections (that’s done in the dashboard). If the app isn’t connected or the connection isn’t active, the call returns 422 telling you to connect it in the dashboard.
scenario → flow_uuid.
agent → agent_uuid (+ optional channel of call|whatsapp and channel_action_name). References are by uuid/key (never numeric ids). Discover apps/actions via GET /flow/apps and /flow/apps//actions; connections via GET /flow/connections; flows via GET /flows.

PUT

api

agents

{uuid}

intents

{intentUuid}

event

Set the intent's action (event)

curl --request PUT \
  --url https://{subdomain}.mihu.ai/api/v1/agents/{uuid}/intents/{intentUuid}/event \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_type": "app",
  "app_uid": "1f0a…",
  "action_key": "ai_query",
  "config": {
    "table_uuid": "…",
    "max_results": 10,
    "query_description": "Order tracking table. durum = status."
  }
}
'

{
  "success": true,
  "message": "Intent event updated successfully",
  "data": {
    "event_type": "app",
    "status": "draft",
    "app": {
      "uid": "1f0a…",
      "name": "Tables",
      "is_builtin": true
    },
    "action": {
      "key": "ai_query",
      "name": "AI Query"
    },
    "app_connection_uuid": null,
    "config": {
      "table_uuid": "…",
      "max_results": 10,
      "query_description": "…"
    }
  }
}

Authorizations

Authorization

string

header

required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Path Parameters

uuid

string<uuid>

required

intentUuid

string<uuid>

required

Body

application/json

The body is of type any.

Response

Intent event set (created as draft — call /event/publish to make it live)

Get the intent's action (event)Clear the intent's action (event)

Documentation Index

Authorizations

Path Parameters

Body

Response