Discussion turn stop requested

This event fires when someone requests that an agent stop its current turn in a discussion. Use it to stop generating a response while keeping the discussion available for the next message. requestedBy identifies who requested the stop, and requestedAt records when they requested it. The discussion object identifies the agent session to stop. Read discussion.agent to see which machine user the stop is for. It is null on a discussion Plain’s own Sidekick Agent runs. Interacting in discussions covers what to do next.

This event requires a webhook target on version 2026-09-14 or later.

Schema

View JSON Schema → Example:

{
  "timestamp": "2026-09-18T10:12:41.019Z",
  "workspaceId": "w_01HZ7QK3M9N4P5R6S7T8V9W0XY",
  "payload": {
    "eventType": "discussion.turn_stop_requested",
    "discussion": {
      "id": "thd_01HZ8A1B2C3D4E5F6G7H8J9K0M",
      "type": "AGENT_SESSION",
      "agent": {
        "id": "mu_01HZ8B3C4D5E6F7G8H9J0K1M2N",
        "fullName": "Acme Support Agent",
        "publicName": "Acme Support",
        "description": "Answers billing questions in Ask Agent",
        "createdAt": "2026-09-01T09:14:22.117Z",
        "createdBy": {
          "actorType": "user",
          "userId": "u_01HZ8C4D5E6F7G8H9J0K1M2N3P"
        },
        "updatedAt": "2026-09-01T09:14:22.117Z",
        "updatedBy": {
          "actorType": "user",
          "userId": "u_01HZ8C4D5E6F7G8H9J0K1M2N3P"
        },
        "deletedAt": null,
        "deletedBy": null
      },
      "status": "OPEN",
      "agentStatus": "IDLE",
      "threadId": "th_01HZ8N2P3Q4R5S6T7V8W9X0Y1Z"
    },
    "requestedBy": {
      "actorType": "user",
      "userId": "u_01HZ8C4D5E6F7G8H9J0K1M2N3P"
    },
    "requestedAt": "2026-09-18T10:12:40.972Z"
  },
  "id": "pEv_01HZ8H9J0K1M2N3P4Q5R6S7T8V",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HZ8K1M2N3P4Q5R6S7T8V9W0X",
    "webhookTargetVersion": "2026-10-26",
    "webhookDeliveryAttemptId": "whAttempt_01HZ8P4Q5R6S7T8V9W0X1Y2Z3A",
    "webhookDeliveryAttemptNumber": 1,
    "webhookDeliveryAttemptTimestamp": "2026-09-18T10:12:41.019Z"
  },
  "type": "discussion.turn_stop_requested"
}

Using the Webhooks SDK

You can use the @team-plain/webhooks package to parse and verify this event with full type safety:

import { verifyPlainWebhook } from "@team-plain/webhooks";

const result = verifyPlainWebhook(rawBody, signature, secret);

if (result.error) {
  console.error(result.error.message);
} else {
  // result.data is fully typed with the event payload
  const event = result.data;
  console.log(event.eventType, event.payload);
}

GraphQL API

Building Agents

Agent integrations

Webhooks

Channels

Customer Cards

UI Components

Security

Changelog

Discussion turn stop requested

Schema

Using the Webhooks SDK

​Schema

​Using the Webhooks SDK

Schema

Using the Webhooks SDK