Swush
API

Upload Requests

Public upload links and approval queues.

Upload Requests let you create public upload links with limits, optional passwords, and approval workflows.

Endpoints (Owner)

  • GET /api/v1/upload-requests — list your upload requests
  • POST /api/v1/upload-requests — create upload request
  • PATCH /api/v1/upload-requests/{id} — update upload request
  • DELETE /api/v1/upload-requests/{id} — delete upload request
  • GET /api/v1/upload-requests/queue — list pending approvals
  • GET /api/v1/upload-requests/{id}/queue — list items for a request
  • PATCH /api/v1/upload-requests/{id}/queue/{itemId} — approve/reject item

Endpoints (Public)

  • GET /api/v1/upload-requests/p/{slug} — fetch public upload link details
  • POST /api/v1/upload-requests/p/{slug}/files — upload file to the link

Auth

Owner endpoints require x-api-key or a signed-in session. Public endpoints are unauthenticated but may require a password and captcha headers depending on configuration.

On this page