Sharing and Administration Endpoints

Public Routes (no authentication required)

Method	Endpoint	Description
GET	`/s/:token`	Share link information
GET	`/s/:token/consent-text`	Loi 25 consent text
POST	`/s/:token/accept-consent`	Accept consent
GET	`/s/:token/encryption-info`	Encryption information
GET	`/s/:token/download`	Download file
POST	`/s/:token/upload`	Upload file (25 MB max)
GET	`/s/:token/files`	List link files
GET	`/s/:token/files/:fileId`	File metadata

Protected Routes (authentication required)

Share links are managed under /api/v1/clients/:client_id/share-links.

Method	Endpoint	Description
GET	`.../share-links`	List links (with creator info)
POST	`.../share-links`	Create a link
GET	`.../share-links/:id/files`	List link files
DELETE	`.../share-links/:id`	Delete a link

{
  "name": "Documents for client",
  "resource_type": "file",
  "resource_id": "uuid",
  "allow_upload": false,
  "password": "optionalPassword",
  "expires_in": 168,
  "max_downloads": 10
}

Response:

{
  "id": "uuid",
  "token": "abc123...long-hex-token",
  "url": "https://secufile.secuaas.dev/s/abc123...",
  "created_at": "2026-02-14T00:00:00Z"
}

Every action on a share link is traced in the audit trail:

share_link_access: Link access (consultation)
share_link_download: File download
share_link_upload: File upload
consent_accepted: Loi 25 consent acceptance

Administration

Admin Endpoints (service account authentication)

Method	Endpoint	Description
GET	`/api/v1/admin/auth/validate`	Validate service token
POST	`/api/v1/admin/auth/regenerate`	Regenerate service token
DELETE	`/api/v1/admin/clients/:cid/folders/:fid`	Permanent folder delete
DELETE	`/api/v1/admin/clients/:cid/files/:fid`	Permanent file delete
GET	`/api/v1/admin/clients/:cid/files/:fid/download`	Download with custom key
GET	`/api/v1/admin/diagnostic/crypto`	Crypto diagnostics
GET	`/api/v1/admin/diagnostic/master-key-fingerprint`	Master key fingerprint
GET	`/api/v1/admin/diagnostic/clients/:cid/keys`	Client key diagnostics
DELETE	`/api/v1/admin/organizations/:org_id/complete`	Complete org deletion (with OVH deprovisioning)
GET	`/api/v1/admin/config/service-account`	Get service account config
PUT	`/api/v1/admin/config/service-account`	Set service account config
GET	`/api/v1/admin/storage/stats`	Storage statistics
POST	`/api/v1/admin/storage/collect`	Trigger stats collection

Admin Endpoints (JWT superadmin authentication)

Method	Endpoint	Description
POST	`/api/v1/admin/auth/impersonate`	Impersonate a user (superadmin only)

File Types Management (admin)

Method	Endpoint	Description
GET	`/api/v1/admin/file-types`	List file types
GET	`/api/v1/admin/file-types/:id`	Get file type
PATCH	`/api/v1/admin/file-types/:id`	Update file type settings

Stripe Configuration (superadmin only)

Method	Endpoint	Description
GET	`/api/v1/stripe-config`	Get Stripe configuration
PUT	`/api/v1/stripe-config`	Update configuration
POST	`/api/v1/stripe-config/switch-mode`	Switch test/prod mode
GET	`/api/v1/stripe-config/audit-logs`	Stripe audit logs

Platform Configuration (superadmin only)

Method	Endpoint	Description
GET	`/api/v1/platform-config`	Global configuration
PUT	`/api/v1/platform-config`	Update configuration
PUT	`/api/v1/platform-config/mode`	Switch dev/prod mode

MSP Pricing Management

Method	Endpoint	Description
GET	`/api/v1/msp/:msp_id/pricing`	List MSP pricing
POST	`/api/v1/msp/:msp_id/pricing`	Create MSP pricing
PATCH	`/api/v1/msp/:msp_id/pricing/:id`	Update MSP pricing
DELETE	`/api/v1/msp/:msp_id/pricing/:id`	Delete MSP pricing

Monitoring and Metrics

Method	Endpoint	Description
GET	`/health`	Liveness probe (200 OK)
GET	`/ready`	Readiness probe (DB + Redis check)
GET	`/metrics`	Prometheus metrics

Available Prometheus Metrics

http_requests_total: HTTP request count (by method, path, status)
http_request_duration_seconds: HTTP request duration (histogram)
s3_operations_total: S3 operation count (by operation, status)
s3_operation_duration_seconds: S3 operation duration
active_goroutines: Number of active goroutines
login_attempts_total: Login attempts (by status)
file_uploads_total: Number of files uploaded

Sharing and Administration Endpoints

On this page