Delete redaction config

Delete Redaction Config

curl --request DELETE \
  --url https://api.operata.io/v1/config/REDACTION_CONFIG \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'DELETE', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.operata.io/v1/config/REDACTION_CONFIG', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.operata.io/v1/config/REDACTION_CONFIG"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.delete(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.operata.io/v1/config/REDACTION_CONFIG"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

"REDACTION_CONFIG removed"

"REDACTION_CONFIG not found"

DELETE

config

REDACTION_CONFIG

Delete Redaction Config

curl --request DELETE \
  --url https://api.operata.io/v1/config/REDACTION_CONFIG \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'DELETE', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.operata.io/v1/config/REDACTION_CONFIG', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.operata.io/v1/config/REDACTION_CONFIG"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.delete(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.operata.io/v1/config/REDACTION_CONFIG"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

"REDACTION_CONFIG removed"

"REDACTION_CONFIG not found"

Removes the redaction config for your Operata account. After the call, the Cloud Collector reverts to the privacy-first default and ships only the mandatory CTR fields. Use it to roll back a config before applying a new one, or to retire a config you no longer need.

Destructive operation. Deleting the redaction config opens a propagation window during which subsequent CTRs may include PII fields the config previously stripped. The collector keeps applying the old config to in-flight contacts for up to 30 minutes after this call returns, then reverts to the default. To change the field set without this exposure window, send a new config to PUT /v1/config/json instead — that replaces the document atomically.

DELETE /v1/config/REDACTION_CONFIG is idempotent. Deleting an already-deleted config converges on the same end state — no config, collector on the default. The current wire response on a second call is 404 (see Errors below); treat it as success. See Idempotency for the per-method contract.

Endpoint

DELETE https://api.operata.io/v1/config/REDACTION_CONFIG

Parameters

Headers

Name	Type	Required	Description
`Idempotency-Key`	string	no, not yet honored	Reserved for a future contract. The endpoint is already idempotent — deleting an already-deleted config returns `404` and the end state matches. See Idempotency.

This endpoint takes no path, query, or body parameters. Credentials on the request determine the Operata account scope.

Response

200 OK with a plain-text body REDACTION_CONFIG removed.

REDACTION_CONFIG removed

The deletion is durable as soon as the call returns. Propagation across all collection points can take up to 30 minutes; CTRs from contacts that end during that window may still apply the now-deleted config.

Example

curl -X DELETE -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
  "https://api.operata.io/v1/config/REDACTION_CONFIG"

const groupId = process.env.OPERATA_GROUP_ID;
const apiToken = process.env.OPERATA_API_TOKEN;
const auth = Buffer.from(`${groupId}:${apiToken}`).toString("base64");

const response = await fetch(
  "https://api.operata.io/v1/config/REDACTION_CONFIG",
  {
    method: "DELETE",
    headers: { Authorization: `Basic ${auth}` },
  },
);

import os, requests

response = requests.delete(
    "https://api.operata.io/v1/config/REDACTION_CONFIG",
    auth=(os.environ["OPERATA_GROUP_ID"], os.environ["OPERATA_API_TOKEN"]),
)
response.raise_for_status()

Errors

Status	Code	When	Recover
404	`not_found`	No redaction config exists for this Operata account. Either it was never created, or a previous `DELETE` already removed it.	Confirm with Get redaction config. If no config is expected, treat `404` as success — the end state matches.

See Errors for shared codes such as 401 unauthorized, 429 rate_limited, and the 5xx family.

Data redaction — what redaction does and how the three endpoints fit together.
Get redaction config — confirm what is in effect before you delete it.
Update redaction config — replace the config atomically instead of deleting then re-creating.
Errors — shared status codes and recovery patterns.
Rate limits — per-token request budget.
Idempotency — DELETE is idempotent; the end state matches whether the config existed or not.
Versioning — this endpoint lives under /v1.

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Response

200

Update redaction config

EventBridge

Overview & quickstart

API essentials

Endpoints — Contacts

Endpoints — Logs

Endpoints — Users

Endpoints — Data redaction

Events & webhooks

Streaming & backends

AI & MCP

Endpoint

Parameters

Headers

Response

Example

Errors

Authorizations

Response

​Endpoint

​Parameters

​Headers

​Response

​Example

​Errors

​Related

Authorizations

Response

Endpoint

Parameters

Headers

Response

Example

Errors

Related