Skip to Content

Remove an integration

Removes the integration and its grant from every agent's draft.

DELETE
/v1/integrations/{integrationId}

Removes the integration and its grant from every agent's draft. Contact accounts are disconnected; organization accounts stay connected. A published agent version that granted it can no longer use it; publish the agent to drop the grant.

Authorization

apiKey
headerx-api-key<token>

Path Parameters

integrationId*string
Match^intg_[0-9a-hjkmnp-tv-z]{16,24}$

Response Body

DeleteIntegrationResponse

application/json
  1. response
id*IntegrationId
Match^intg_[0-9a-hjkmnp-tv-z]{16,24}$
deleted*true
Value intrue
Example Request
import { createClient } from "samva";

const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });

const result = await samva.integrations.remove({
  "integrationId": "example"
});
Example Response
{
  "id": "string",
  "deleted": true
}

Related documentation