Optional calls

Delete Protocol

Use the deleteProtocol mutation to permanently remove a protocol and all its associated data. This is useful for data cleanup, privacy compliance, or when a protocol is no longer needed.

Input Parameters

protocolSlug (String!) — the slug of the protocol to delete.

GraphQL Mutation

mutation DeleteProtocol($protocolSlug: String!) {
  deleteProtocol(protocolSlug: $protocolSlug) {
    success
  }
}

Mutation Variables

{
  "protocolSlug": "PROTOCOL_SLUG"
}

Example JavaScript Implementation

import axios from "axios";

async function deleteProtocol(protocolSlug) {
  const res = await axios({
    method: "POST",
    url: "https://api-v2.speechmind.com/external/v2/graphql",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.SPEECHMIND_API_KEY,
    },
    data: JSON.stringify({
      query: DELETE_PROTOCOL,
      variables: { protocolSlug },
    }),
  });

  const { success } = res.data.data.deleteProtocol;
  console.log(success ? "Protocol deleted:" : "Failed to delete protocol:", protocolSlug);

  return success;
}

Notes

This operation permanently deletes the protocol and all its associated data — including metadata, agenda items, transcriptions, and analysis results. It cannot be undone.
Use this mutation when complying with data retention policies, GDPR deletion requests, or other privacy regulations.
Once deleted, the protocol cannot be recovered. Ensure you have any necessary backups before calling this mutation.

Have questions?

Still have questions? Talk to support.