Tool call approval resolved

Fired when a user approves or denies a custom agent tool call.

This event is fired when a user decides an approval a custom agent asked for. Subscribe to it so your agent resumes on a decision instead of polling the discussion.

status is APPROVED or DENIED, and reviewerNote is what the user typed, or null. On DENIED, Plain has already failed the gated tool call and set reviewerNote as its error, so do not report an error on that call yourself: feed the note back to your model and try again under a new toolCallId.

discussion.agentStatus tells you where the discussion is now. It stays TOOL_CALL_APPROVAL_PENDING while another approval is open, and otherwise it is IN_PROGRESS if any tool call is still PENDING or IDLE if none is. An approval a user has approved leaves its own call PENDING for you to run, so a lone approval reads IN_PROGRESS and a lone denial reads IDLE.

Schema

View JSON Schema →

Example:

{
  "timestamp": "2026-09-07T10:14:08.503Z",
  "workspaceId": "w_01HZ7QK3M9N4P5R6S7T8V9W0XY",
  "payload": {
    "eventType": "discussion.tool_call_approval_resolved",
    "discussion": {
      "id": "thd_01HZ8A1B2C3D4E5F6G7H8J9K0M",
      "type": "AGENT_SESSION",
      "agent": {
        "id": "mu_01HZ8B3C4D5E6F7G8H9J0K1M2N",
        "fullName": "Acme Support Agent",
        "publicName": "Acme Support",
        "description": "Answers billing questions in Sidekick",
        "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": "IN_PROGRESS",
      "threadId": "th_01HZ8N2P3Q4R5S6T7V8W9X0Y1Z"
    },
    "approvalId": "ap_01HZ8E6F7G8H9J0K1M2N3P4Q5R",
    "toolCallId": "refund-1",
    "status": "APPROVED",
    "justification": "The invoice was double charged, so I want to refund the duplicate.",
    "reviewerNote": "Confirmed with finance, go ahead.",
    "resolvedBy": {
      "actorType": "user",
      "userId": "u_01HZ8C4D5E6F7G8H9J0K1M2N3P"
    },
    "resolvedAt": "2026-09-07T10:14:08.461Z"
  },
  "id": "pEv_01HZ8J0K1M2N3P4Q5R6S7T8V9W",
  "webhookMetadata": {
    "webhookTargetId": "whTarget_01HZ8K1M2N3P4Q5R6S7T8V9W0X",
    "webhookTargetVersion": "2026-09-06",
    "webhookDeliveryAttemptId": "whAttempt_01HZ8Q5R6S7T8V9W0X1Y2Z3A4B",
    "webhookDeliveryAttemptNumber": 1,
    "webhookDeliveryAttemptTimestamp": "2026-09-07T10:14:08.503Z"
  },
  "type": "discussion.tool_call_approval_resolved"
}

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);
}