API

Mark a file

Mark a file in a Business or Enterprise workspace and download the marked copy.

POST`/api/v1/mark`

Marks a file and returns the marked copy. The body is multipart/form-data.

Authentication

Authorization: Bearer mf_…

Send this header. There is no session cookie. curl and other server clients are accepted. A browser on another site is rejected.

Parameters

Name	Type	Required	Description
file	file	Yes	The file to mark. Business accepts up to 100 MB, 500 PDF pages, and video up to 10 minutes. Enterprise file size, PDF pages, video length, and video file size are Custom. Upload size, video length, and PDF page count follow the workspace plan.
identifier	string	Yes	1–32 characters, with no control characters. The label you see if this copy is detected later. It is not written into the file as readable text.

Request

curl -X POST https://markedfile.com/api/v1/mark \
  -H "Authorization: Bearer mf_…" \
  -F "file=@contract.pdf" \
  -F "identifier=northwind"

Response

{
  "file": "JVBERi0xLjQK…",
  "mime": "application/pdf",
  "name": "contract.pdf",
  "kind": "pdf",
  "layers": [
    {
      "name": "Metadata",
      "detail": "Authenticated workspace reference; the identifier stays on the server",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "remaining": 1
}

file is the marked bytes in base64. mime, name, and kind describe the download. layers lists the carriers that were applied. When the plan has no active-file cap, remaining is the number of active files after this mark. When it has a cap, remaining is how many new marks are left. Business and Enterprise have no active-file cap. Deleting a file is what ends detection.

Errors

The error field in the JSON body is English.

Status	Description
400	The file is empty, or the identifier is empty, longer than 32 characters, or contains a control character.
401	The key is missing, revoked, or unknown. The JSON body includes "code": "api-key".
403	The workspace no longer has an active Business or Enterprise plan (the body includes "code": "enterprise"), or the browser sent a cross-site or same-site fetch.
413	The file is over the plan upload limit, or the PDF has more pages than the plan allows.
422	The file could not be processed.
503	The server is busy, or marking is paused for maintenance.
429	This key has marked more than 40 files in the current minute.

Rate limit

40 requests per minute for this key. The counter is stored in the product database and survives a restart.