Create Document

Create a new document

Requires authentication

Endpoint

POST /documents

Request Body

Field	Type	Required	Description
url	string	Yes	URL to document file
type	string	Yes	Document type (NATIONAL, LICENSE, PASSPORT, RESIDENCE, OTHER)
expiryDate	string	Yes	Document expiry date (ISO string)
issuedBy	string	Yes	Issuing authority
adminId	UUID	No	Link document to an admin (required if userId not provided)
userId	UUID	No	Link document to a resident user (required if adminId not provided)

Example

{
  "url": "https://storage.example.com/national-id.pdf",
  "type": "NATIONAL",
  "expiryDate": "2025-12-31T00:00:00Z",
  "issuedBy": "Ministry of Interior",
  "adminId": "admin-uuid"
}

Response

{
  "success": true,
  "data": {
    "id": "uuid",
    "url": "https://storage.example.com/national-id.pdf",
    "type": "NATIONAL",
    "expiryDate": "2025-12-31T00:00:00Z",
    "issuedBy": "Ministry of Interior",
    "adminId": "admin-uuid",
    "userId": null
  }
}