---
title: "Clear a file's AI flag"
method: POST
path: "/documents/{document_id}/flag/clear"
tags: ["document"]
---

# Clear a file's AI flag

`POST /documents/{document_id}/flag/clear`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/documents/{document_id}/flag/clear`
- Auth: HTTP bearer

A member looks at the words in an uploaded file that read as written to steer an AI, and clears the file for agents, with the reason. Agents then read its text, still as content and never as instructions. A person clears it, in the app; the reason is kept with their name.

## Path parameters

- `document_id` string, required

## Request body

- object
  - `reason` string, required

## Response `200`

The result.

- object
  - `document_id` string, required
  - `cleared_by` string, required
  - `cleared_at` string, date-time, required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)