Documents

Documents represent compliance and regulatory files associated with a node. The API supports uploading, downloading, listing, and deleting documents. Each document has a type that categorizes it for compliance purposes.

Document Model

Field	Type	Description
id	string (UUID)	Unique document identifier
node_id	string (UUID)	Node this document belongs to
type	string	Document type (see below)
url	string	Internal storage URL
size	integer	File size in bytes
content_type	string	MIME type (e.g., application/pdf)
hash	string	SHA-256 hash of the file content
created_at	string (ISO 8601)	Creation timestamp
updated_at	string (ISO 8601)	Last update timestamp
deleted_at	string (ISO 8601) | null	Soft deletion timestamp

Document Types

Value	Category	Description
crypto_asset_custody_policy	Policy	Crypto asset custody policy
private_key_management_policy	Policy	Private key management policy
wallet_usage_and_segmentation_policy	Policy	Wallet usage and segmentation policy
transfer_and_approval_processes_policy	Policy	Transfer and approval processes policy
hardware_security_policy	Policy	Hardware security policy
wallet_opening_and_closing_procedure	Procedure	Wallet opening and closing procedure
key_generation_backup_and_recovery_procedure	Procedure	Key generation, backup, and recovery procedure
transfer_operations_procedure	Procedure	Transfer operations procedure
end_of_day_reconciliation_and_control_procedure	Procedure	End-of-day reconciliation and control procedure
incident_management_procedure	Procedure	Incident management procedure
hardware_management_and_inventory_procedure	Procedure	Hardware management and inventory procedure
custody_platform_system_architecture_document	Architecture	Custody platform system architecture document
network_topology_and_security_controls_document	Architecture	Network topology and security controls document
logging_and_monitoring_document	Architecture	Logging and monitoring document
testing_and_security_validation_documents	Architecture	Testing and security validation documents
organization_chart_and_role_definitions	Compliance	Organization chart and role definitions
risk_assessment_and_control_matrix	Compliance	Risk assessment and control matrix
customer_agreements_and_terms_of_service	Compliance	Customer agreements and terms of service
customer_disclosure_and_risk_notification_documents	Compliance	Customer disclosure and risk notification documents

Key Behaviors

• Upsert pattern: Uploading a document with the same type as an existing one replaces the previous version.
• Max file size: 100 MB.
• Node hierarchy: You can only access documents from your node or child nodes.
• Soft delete: Deleted documents are marked as deleted but the S3 file is retained for audit purposes.

Endpoints

Method	Path	Description
POST	/v1/documents	Upload a document
GET	/v1/documents	List documents
GET	/v1/documents/{document_id}	Get document metadata
GET	/v1/documents/{document_id}/download	Download document file
DELETE	/v1/documents/{document_id}	Delete a document