Update custom integration
Change a custom HTTP integration's name, base URL, active state, or non-secret auth details (api_key header, oauth2 auth/token URLs + scopes) after creation. Pass the integration id from list_workspace_integrations plus only the fields to change. authType is fixed at creation and can't be changed here. Rotating the API key or OAuth client secret can't be done through this tool; change it in the app under Settings → Connections (secrets never pass through a model tool). Requires workspace-admin.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/update_workspace_integration" \ -H "Content-Type: application/json" \ -d '{ "workspace": "string", "integrationId": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Edit KB text POST
Replace the text of a pasted-text knowledge-base source, keeping its name. The new text is embedded first and the old source is removed only once the new one is ready, so a failed read leaves the old text in place. The source gets a NEW id: use the `source.id` in the result for any later call. Refuses a website or file source (use `refresh_kb_source` or delete and re-add), a live version (create a draft first) and a version that is not the newest draft (409 with `latestVersion`). Embedding is metered like `add_text_kb_source`.
Update workspace settings POST
Change a workspace's timezone, language, how many tests run at once in a batch (evalConcurrency, 1 to 3), and its privacy and retention settings: call retention (transcripts and recordings; 0 keeps forever, the default, and no plan limits it), audit log retention, what transcripts keep (piiScrubLevel) and which personal details are hidden (piiCategories), whether calls are recorded, which roles may download a recording, what call content reaches support tools and analytics, IP capture, and session replay. Pass only what you want to change. Shortening a retention window deletes older calls or audit entries for good, so it is refused until the user agrees and you pass confirm: true. Zero data retention can be turned off here but not on. For the workspace name use rename_workspace; for the URL slug use set_workspace_slug. Require MFA is not here: only the workspace owner changes it, in Settings > Security.