---
title: "Revoke the active public URL for a file. The underlying file remains
available through the authenticated content endpoint. Revoke is idempotent
— calling it on a file without an active public URL returns
`revoked: false` without an error."
method: POST
path: "/v1/files/{file_id}/public-url/revoke"
tags: ["v1"]
---

# Revoke the active public URL for a file. The underlying file remains
available through the authenticated content endpoint. Revoke is idempotent
— calling it on a file without an active public URL returns
`revoked: false` without an error.

`POST /v1/files/{file_id}/public-url/revoke`

## Path parameters

- `file_id` string, required

## Response `200`

Success

- RevokePublicUrlResponse — Response for revoking a public URL for a file.
  - `id` string, required — The file ID whose public URL was revoked.
  - `public_url` string, nullable — The full public URL that was revoked. Only present when `revoked` is `true`.
  - `revoked` boolean, required — Whether a public URL was actually revoked. `false` if the file had no active public URL (no-op).

---

[API](https://skmtc.net/x/apis/xai-s-rest-api.md) · [All operations](https://skmtc.net/x/apis/xai-s-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/x/xai-s-rest-api/revisions/8f6014272113/schema)