API v1 ReferenceDocuments
Create document metadata
Create document metadata without file upload. File must be uploaded separately using the file upload endpoint.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Request Body
application/json
title*string
Document title
Length
1 <= lengthdescription?string
Document description
description_markdown?string
Markdown-formatted description
category*string
Category ID (must be UUID)
Format
uuidaccess_level*string
Document access level
Value in
"public" | "restricted" | "requires_nda" | "internal"issue_date?string
Issue date in YYYY-MM-DD format
Match
^\d{4}-\d{2}-\d{2}$Format
dateexpiry_date?string
Expiry date in YYYY-MM-DD format
Match
^\d{4}-\d{2}-\d{2}$Format
datevalidity_months?integer
Validity period in months
Range
1 <= valuestate?string
Initial document state
Default
"valid"Value in
"valid" | "pending" | "expired" | "inactive"featured?
Featured placement flags for controls/resources sections
show_validity_period_on_card?boolean
Show validity period on card display
Default
truetemplate?string
Template ID to use for document creation
Format
uuidResponse Body
application/json
application/json
curl -X POST "https://app.orbiqhq.com/api/v1/documents" \ -H "Content-Type: application/json" \ -d '{ "title": "Privacy Policy", "description": "Company privacy policy document", "category": "550e8400-e29b-41d4-a716-446655440000", "access_level": "public" }'{
"success": true,
"data": {
"documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",
"uploadUrl": "/api/v1/documents/doc-123/file"
}
}{
"error": "Invalid input: category: category_must_be_uuid"
}Empty
Empty
How is this guide?