Set Trigger Mode

Persist the onboarding trigger-mode choice (SMMT content-driven).

This is the wizard’s first question, posted after the team already exists (checkout/webhook create it strategy-driven). Flipping to “content-driven” makes the wizard show the Content Sources step and makes cycle-start skip strategy generation. Validated server-side (flag + team-type gate).

POST /api/v1/teams/{team_id}/onboarding/trigger-mode

Set Trigger Mode

cURL

curl --request POST \
  --url https://api.example.com/api/v1/teams/{team_id}/onboarding/trigger-mode \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "step": "<string>",
  "connections": [
    {
      "provider": "<string>",
      "label": "<string>",
      "required": false,
      "type": "oauth",
      "connected": false,
      "fields": [
        {
          "key": "<string>",
          "label": "<string>",
          "type": "text",
          "placeholder": "",
          "help": "",
          "default": ""
        }
      ]
    }
  ],
  "cycle_configured": false,
  "loops_configured": false,
  "lifecycle_type": "cyclical",
  "requires_brand": "optional",
  "chat_enabled": true,
  "cycle_start_mode": "<string>",
  "trigger_types": [
    "<string>"
  ],
  "trigger_mode": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

team_id · string<uuid> · required

Body

application/json

Persist the onboarding trigger-mode choice (SMMT content-driven).

Validated server-side: "content-driven" requires the feature flag + a content-driven-capable team type, else 400.

trigger_mode is deliberately REQUIRED here (no None): this request is the wizard's explicit set-trigger-mode action, so the client always sends a concrete choice. The nullable state lives on the STORED column — AgentTeam.trigger_mode may be NULL (= classic strategy-driven default, resolved by team_service._resolve_trigger_mode) for teams that never answered the wizard question. Don't widen this Literal to | None; a client with nothing to set simply doesn't call the endpoint.

trigger_mode · enum<string> · required

'strategy-driven' or 'content-driven'

Available options: strategy-driven, content-driven

Response

200

application/json

Successful Response

step · string · required

connections · ConnectionRequirement · object[]

Show child attributes

cycle_configured · boolean · default: false

loops_configured · boolean · default: false

lifecycle_type · string · default: cyclical

requires_brand · string · default: optional

chat_enabled · boolean · default: true

cycle_start_mode · string | null

trigger_types · string[]

trigger_mode · string | null