Files

Upload, list, and delete user files.

Upload a file

put

Uploads a file as multipart/form-data. The upload is validated and accepted synchronously, then processed asynchronously.

Constraints:

• The request method must be PUT.

• Content-Type must be multipart/form-data.

• Content-Length is required (chunked transfer encoding is not supported).

• Maximum size is 125 MB.

Authorizations

AuthorizationstringRequired

API key issued for your Plus organization, sent as a bearer token.

Body

filestring · binaryRequired

The file to upload.

Responses

202

File received; processing will begin shortly.

application/json

statusstringRequiredExample: accepted

uploadIdstringRequired

messagestringRequired

401

Missing or invalid API key.

application/json

405

Method not allowed (must use PUT).

application/json

411

Content-Length header is required.

application/json

413

File exceeds the size limit.

application/json

415

Content-Type must be multipart/form-data.

application/json

put/r/v0/files/upload

PUT /r/v0/files/upload HTTP/1.1
Host: api.plusdocs.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "status": "accepted",
  "uploadId": "text",
  "message": "text"
}

List files

get

Lists the authenticated user's files in the organization, ordered by creation time (newest first). Supports cursor-based pagination.

Authorizations

AuthorizationstringRequired

API key issued for your Plus organization, sent as a bearer token.

Query parameters

limitinteger · min: 1 · max: 100Optional

Page size (1–100). Defaults to 50.

Default: 50

cursorstringOptional

The nextCursor returned by a previous page.

Responses

200

A page of files.

application/json

nextCursorstring · nullableRequired

Cursor for the next page, or null if there are no more files.

401

Missing or invalid API key.

application/json

get/r/v0/files

GET /r/v0/files HTTP/1.1
Host: api.plusdocs.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "files": [
    {
      "id": "text",
      "name": null,
      "contentType": null,
      "urn": "text",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Delete a file

delete

Deletes a file the caller owns. Returns 204 on success.

Authorizations

AuthorizationstringRequired

API key issued for your Plus organization, sent as a bearer token.

Path parameters

fileIdstringRequired

Responses

204

Deletion accepted; no content.

No content

400

The request was malformed or missing required fields.

application/json

401

Missing or invalid API key.

application/json

404

File not found.

application/json

delete/r/v0/files/{fileId}

DELETE /r/v0/files/{fileId} HTTP/1.1
Host: api.plusdocs.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content