clinik.documents

Compositions are structured clinical documents with sections — discharge summaries, referral letters, care plans, etc.

create

const { data, meta } = await clinik.documents.create(request: DocumentCreateRequest): Promise<ApiResponse<Composition>>

Field	Type	Required	Description
`status`	`string`	Yes	preliminary, final, amended
`type`	`string`	Yes	Document type (e.g. “discharge-summary”)
`category`	`string[]`	No	Document categories for classification
`patientId`	`string`	Yes	Patient reference
`encounterId`	`string`	No	Encounter reference
`practitionerId`	`string`	Yes	Author reference
`title`	`string`	Yes	Document title
`date`	`string`	No	Document date
`sections`	`DocumentSection[]`	Yes	Document sections (recursive)
`confidentiality`	`'N' \| 'R' \| 'V'`	No	Normal, Restricted, Very Restricted
`attester`	`DocumentAttester[]`	No	Who attested to accuracy
`custodianId`	`string`	No	Organization maintaining the document
`relatesTo`	`DocumentRelatesTo[]`	No	Relationships to other compositions
`event`	`DocumentEvent[]`	No	Clinical services being documented

Section Structure (recursive)

{
  title: string;
  code?: string;
  text: string;
  resourceIds?: string[];
  authorId?: string;       // Per-section author
  mode?: 'working' | 'snapshot' | 'changes';
  sections?: DocumentSection[];  // Nested sub-sections
}

Attester Structure

{
  mode: 'personal' | 'professional' | 'legal' | 'official';
  time?: string;
  partyId?: string;  // Practitioner ID
}

search / read / update / delete

Same pattern as other resources.