Delete a file

Private session interface. Removes a workspace file unless a Skill or its version history still references it.

DELETE /api/w/{wId}/files/{fileId}

Base URL: https://app.counso.ai

Authentication

This operation requires a user OAuth access token in Authorization: Bearer <token>. A signed-in browser may use its Counso session cookie. A workspace API key does not supply user identity.

Parameters

Parameter	Location	Type	Required	Description
wId	path	string	Yes	ID of the workspace
fileId	path	string	Yes	ID of the file

Responses

HTTP status	Description
204	File deleted
400	File is referenced by a skill or its version history
403	Permission denied
404	File not found

Specification

Download the complete OpenAPI / Postman files.

{
  "openapi": "3.0.0",
  "info": {
    "title": "Counso API",
    "version": "1.0.2",
    "description": "API reference for Counso workspaces, Agents, conversations and data sources.",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    }
  },
  "servers": [
    {
      "url": "https://app.counso.ai",
      "description": "Counso"
    }
  ],
  "paths": {
    "/api/w/{wId}/files/{fileId}": {
      "delete": {
        "summary": "Delete a file",
        "description": "Private session interface. Removes a workspace file unless a Skill or its version history still references it.",
        "tags": [
          "Private Files"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "wId",
            "required": true,
            "description": "ID of the workspace",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "fileId",
            "required": true,
            "description": "ID of the file",
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "UserAccessToken": []
          },
          {
            "BrowserSession": []
          }
        ],
        "responses": {
          "204": {
            "description": "File deleted"
          },
          "400": {
            "description": "File is referenced by a skill or its version history"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "File not found"
          }
        },
        "x-counso-auth": "user"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "WorkspaceApiKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "A workspace API key issued by this Counso deployment. Permissions and resource access are checked for each operation."
      },
      "UserAccessToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "A user OAuth access token issued for this Counso deployment. A workspace API key is not a substitute for a user token."
      },
      "BrowserSession": {
        "type": "apiKey",
        "in": "cookie",
        "name": "workos_session",
        "description": "The signed-in Counso browser session. External clients should use a user access token."
      }
    }
  }
}