Disarm request
Removes active elements such as macros, scripts and external links from a document and returns a file with the body text and formatting intact. It uses the same key as analysis, and requests are counted together.
disarmed_url can be downloaded for [N hours]. Once it expires, it becomes null.
Request
| Name | In | Description |
|---|---|---|
| Authorization Required | header | Bearer <evaluation key> |
| file Required | form-data | One document to disarm (DOC(X) · XLS(X) · PPT(X) · PDF · HWP [to be confirmed]) |
| Idempotency-Key | header | Resend with the same value to get the same result without being counted twice |
Response fields
| data.disarmed_url | URL of the disarmed file (valid for [N hours]) |
| data.removed[] | Elements removed (removed) or neutralized (neutralized), with their locations |
| data.preserved | Whether body text and formatting were preserved |
| quota | day_left · total_left · expires_at |
Errors
| 401 | invalid_key | Missing key, or a key stopped by reissue |
| 403 | evaluation_ended | 30-day evaluation ended or 2,000 requests used up — request an extension in My API |
| 413 | file_too_large | File too large |
| 415 | unsupported_type | Unsupported file type |
| 429 | rate_limited · daily_limit | Per-minute or concurrency limit, or more than 50 requests in a day (see Retry-After) |
| 503 | engine_busy | Temporarily unavailable — not counted |