---
updatedAt: 2025-05-19T20:19:59.000Z
agentTools:
  projectIndex: https://cogito.readme.io/llms.txt
---

# Start audio redaction

Starts the audio redaction for the current user or for a specified user
if given a username. The calling user must be a super user to specify a
username.

<HTMLBlock>{`
<style>
  .rm-PlaygroundResponse,
  .Reference-section,
  .rm-TryIt{
      display: none;
  }
</style>
`}</HTMLBlock>

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Cogito Notifications API Reference",
    "version": "1.0",
    "description": "API exposed from the Cogito Dialog Application Server\n",
    "contact": {
      "name": "Cogito Corporation",
      "email": "info@cogitocorp.com",
      "url": "https://cogitocorp.com"
    }
  },
  "paths": {
    "/api/calls/redact/start": {
      "post": {
        "tags": [
          "Redaction"
        ],
        "summary": "Start audio redaction",
        "operationId": "redactStart",
        "description": "Starts the audio redaction for the current user or for a specified user\nif given a username. The calling user must be a super user to specify a\nusername.\n",
        "requestBody": {
          "description": "Optional username parameter",
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/Username"
              }
            },
            "application/octet-stream": {
              "schema": {
                "$ref": "#/components/schemas/Username"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          },
          "500": {
            "description": "Internal Server Error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Username": {
        "type": "object",
        "properties": {
          "username": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```