Version: 1.0.0

Propper Locker API

Document Storage & Chat API for the Propper Platform.

Base URL

• Production: https://api.propper.ai/v1/locker

Authentication

OAuth 2.0 Bearer token:

Authorization: Bearer <access_token>

OAuth Scopes

Scope	Description
locker:read	Read documents, download files, chat
locker:write	Create documents
locker:admin	Administrative operations (grants read + write)

Key Endpoints

• GET /v1/locker/documents - List documents
• POST /v1/locker/documents - Create document
• GET /v1/locker/documents/:id/download - Download document
• POST /v1/locker/chat - Chat with documents
• POST /v1/locker/chat/stream - Chat with documents (SSE streaming)

Rate Limits

Category	Limit
Default	300 req/min
Chat	30 req/min
Downloads	120 req/min

Authentication

HTTP: Bearer Auth

OAuth 2.0 access token

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer
Bearer format:	JWT