Revoke a website widget embed for good

DELETE

widget-deployments

{deployment_id}

curl --request DELETE "$MITHUNAI_URL/arukz/api/v1/widget-deployments/8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

deployment_id = "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e"
response = requests.delete(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/widget-deployments/{deployment_id}",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json()["revoked_at"])

const deploymentId = '8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/widget-deployments/${deploymentId}`,
  {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log((await response.json()).revoked_at)

{
  "id": "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e",
  "name": "Docs site widget",
  "widget_key": "arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e",
  "assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
  "status": "revoked",
  "allowed_origins": ["https://docs.example.com", "https://www.example.com"],
  "created_at": "2026-09-20T14:03:11.482190+00:00",
  "created_by": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "expires_at": null,
  "revoked_at": "2026-09-24T09:12:05.640021+00:00",
  "last_used_at": "2026-09-24T07:58:30.021455+00:00"
}

{ "code": "authentication_error", "message": "Authentication is required." }

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "not_found", "message": "The requested resource was not found." }

Revocation is:

Immediate. The widget key fails authentication on the very next widget request, so the widget stops working on every page that embeds it. There is no cache to wait out.
Terminal. A revoked deployment cannot be reactivated. To embed again, create a new deployment and update your page with its new key.
Idempotent. Revoking a deployment that is already revoked succeeds and returns it unchanged, with its original revoked_at.

The response is 200 with the revoked deployment, so you can read revoked_at without a second request. The deployment stays in List widget deployments with status set to revoked. A deployment that does not exist, a deployment in another organization and a malformed ID all return the same 404. You need the assistant.publish permission, which the owner, admin and editor roles hold. Authenticate with an arukz_sk_ API key or a signed-in console session.

string

required

The deployment’s ID (UUID), as returned in id.

Response

string

required

The deployment’s ID (UUID).

string

required

The embed’s label.

The widget key, which no longer authenticates.

string

required

The embedded assistant’s ID.

string

required

Always revoked.

string[]

required

The origin list as it was at revocation.

string

required

When the deployment was created, ISO 8601 in UTC.

string | null

required

ID of the user who created it, or null when it was created with an API key.

string | null

required

When the embed would have expired, or null.

string

required

When the embed was revoked, ISO 8601 in UTC.

string | null

required

When the widget key last authenticated a request, or null if never.

curl --request DELETE "$MITHUNAI_URL/arukz/api/v1/widget-deployments/8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

deployment_id = "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e"
response = requests.delete(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/widget-deployments/{deployment_id}",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json()["revoked_at"])

const deploymentId = '8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/widget-deployments/${deploymentId}`,
  {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log((await response.json()).revoked_at)

{
  "id": "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e",
  "name": "Docs site widget",
  "widget_key": "arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e",
  "assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
  "status": "revoked",
  "allowed_origins": ["https://docs.example.com", "https://www.example.com"],
  "created_at": "2026-09-20T14:03:11.482190+00:00",
  "created_by": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "expires_at": null,
  "revoked_at": "2026-09-24T09:12:05.640021+00:00",
  "last_used_at": "2026-09-24T07:58:30.021455+00:00"
}

{ "code": "authentication_error", "message": "Authentication is required." }

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "not_found", "message": "The requested resource was not found." }

Last modified on September 26, 2026

⌘I

curl --request DELETE "$MITHUNAI_URL/arukz/api/v1/widget-deployments/8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

import os, requests

deployment_id = "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e"
response = requests.delete(
    f"{os.environ['MITHUNAI_URL']}/arukz/api/v1/widget-deployments/{deployment_id}",
    headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json()["revoked_at"])

const deploymentId = '8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e'
const response = await fetch(
  `${process.env.MITHUNAI_URL}/arukz/api/v1/widget-deployments/${deploymentId}`,
  {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
  },
)
console.log((await response.json()).revoked_at)

{
  "id": "8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e",
  "name": "Docs site widget",
  "widget_key": "arukz_wk_8d0f5a2e-3c41-4b7a-9e6d-1f2a3b4c5d6e",
  "assistant_id": "5b1e9c2a-7d4f-4e3b-9a61-0c8f2d7e4a13",
  "status": "revoked",
  "allowed_origins": ["https://docs.example.com", "https://www.example.com"],
  "created_at": "2026-09-20T14:03:11.482190+00:00",
  "created_by": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "expires_at": null,
  "revoked_at": "2026-09-24T09:12:05.640021+00:00",
  "last_used_at": "2026-09-24T07:58:30.021455+00:00"
}

{ "code": "authentication_error", "message": "Authentication is required." }

{ "code": "authorization_error", "message": "You do not have permission to perform this action." }

{ "code": "not_found", "message": "The requested resource was not found." }

Get started

Conversations

Assistants

Models

Knowledge

Widget deployments

Widget (public)

MCP

API keys

Members

Analytics

Support access

Branding

Operations

Revoke a website widget embed for good

Response

​Response

Response