Skip to content
Convor
Convor Docs
API ReferenceOperator Teams

Delete an operator team definition

Permanently deletes an operator team within the current organization, including its member assignments and project bindings.

DELETE/api/operator-teams/{id}

Permanently deletes an operator team within the current organization, including its member assignments and project bindings. Returns a not-found response if the team does not exist.

Endpoint requirements

Credentials
Use either Bearer API key or X-API-Key header.
Required scope
operator-teams:write
Module
Automation & API module (api_access)
Organization and site scope
Requests can access only resources owned by the authenticated organization. The API does not reveal whether an identifier belongs to another organization or site.
Retry behavior
Convergent write: Retrying leaves the resource in the same resulting state. If the first request succeeded, a later retry may return conflict or not found because the change has already taken effect.

Path Parameters

id*string

Path parameter. Unique identifier of this resource.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{  "success": true,  "deleted": true}

Request examples

curl

curl --request DELETE \
  'https://api.convor.io/api/operator-teams/5482ca34-d0cf-46a4-96ef-748803087ae1' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer convor_sk_...'

JavaScript

const response = await fetch("https://api.convor.io/api/operator-teams/5482ca34-d0cf-46a4-96ef-748803087ae1", {
  method: "DELETE",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer convor_sk_..."
  },
});

const contentType = response.headers.get("content-type") ?? "";
const data = response.status === 204
  ? null
  : contentType.includes("json")
    ? await response.json()
    : contentType.startsWith("text/")
      ? await response.text()
      : await response.blob();

if (!response.ok) {
  const message = typeof data === "object" && data !== null
    && "error" in data && typeof data.error === "object"
    && data.error !== null && "message" in data.error
      ? String(data.error.message)
      : "Convor API request failed (" + response.status + ")";
  throw new Error(message);
}

console.log(data);

Was this page helpful?

Create an operator team

Creates a new operator team in the current organization with a name, optional description, routing priority, and project binding scope.

List operator teams and project bindings

Returns every operator team in the current organization, ordered by priority, together with the projects each team is bound to.

On this page

Request examplescurlJavaScript