## Upload a new document

**post** `/documents`

Create a new document with file content

### Returns

- `Document object { id, created_at, household_id, 6 more }`

  - `id: string`

    Unique identifier with document_ prefix

  - `created_at: string`

    Timestamp when the document was created

  - `household_id: string`

    Household ID this document belongs to

  - `name: string`

    Display name of the document

  - `type: DocumentType`

    Type of document

    - `"GRAT_DESIGN_SUMMARY"`

    - `"GENERATED_PRESENTATION"`

    - `"ASSET_VALUATION"`

    - `"SIGNED_TRUST_DOCUMENT"`

    - `"TRUST_AMENDMENT"`

    - `"TRANSFER_CONFIRMATION"`

    - `"EXISTING_REMAINDER_TRUST_DOCUMENT"`

    - `"BALANCE_SHEET"`

    - `"WILL"`

    - `"WILL_CODICIL"`

    - `"POWER_OF_ATTORNEY"`

    - `"ASSIGNMENT_OF_INTEREST"`

    - `"ASSIGNMENT_OF_TANGIBLE_PROPERTY"`

    - `"LOAN_NOTE_AGREEMENT"`

    - `"ARTICLES_OF_INCORPORATION"`

    - `"OPERATING_AGREEMENT"`

    - `"PARTNERSHIP_AGREEMENT"`

    - `"ACCOUNT_DOCUMENTATION_STATEMENT"`

    - `"TAX_ID_CONFIRMATION"`

    - `"GIFT_TAX_RETURN"`

    - `"INCOME_TAX_RETURN"`

    - `"TAX_RECEIPT"`

    - `"TAX_FILING"`

    - `"CORPORATE_BYLAWS"`

    - `"LLC_AGREEMENT"`

    - `"LLC_AGREEMENT_AMENDMENT"`

    - `"OPERATING_AGREEMENT_AMENDMENT"`

    - `"PARTNERSHIP_AGREEMENT_AMENDMENT"`

    - `"SHAREHOLDERS_AGREEMENT"`

    - `"STATE_BUSINESS_FILING"`

    - `"LOGGED_CONTRIBUTION"`

    - `"LOGGED_DISTRIBUTION"`

    - `"INSURANCE_POLICY"`

    - `"CRUMMEY_LETTER"`

    - `"INSURANCE_PREMIUM_PAYMENT"`

    - `"BENEFICIAL_OWNERSHIP_INFORMATION_REPORT"`

    - `"FINCEN_FILING"`

    - `"HEALTHCARE_PROXY"`

    - `"LIVING_WILL"`

    - `"DRIVERS_LICENSE"`

    - `"PASSPORT"`

    - `"DEED"`

    - `"OTHER"`

  - `updated_at: string`

    Timestamp when the document was last updated

  - `enable_ai_suggestions: optional boolean`

    Whether this document should be used for AI suggestions

  - `entity_id: optional string`

    Entity ID if this document is owned by an entity

  - `individual_id: optional string`

    Individual ID if this document is associated with an individual

### Example

```http
curl https://$WITHLUMINARY_SUBDOMAIN.withluminary.com/api/public/v1/documents \
    -H 'Content-Type: multipart/form-data' \
    -F 'file=@/path/to/file' \
    -F household_id=household_01ARZ3NDEKTSV4RRFFQ69G5FAV \
    -F name='Trust Agreement.pdf' \
    -F type=GRAT_DESIGN_SUMMARY \
    -F entity_id=entity_01ARZ3NDEKTSV4RRFFQ69G5FAV \
    -F individual_id=client_profile_01ARZ3NDEKTSV4RRFFQ69G5FAV
```

#### Response

```json
{
  "id": "document_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "created_at": "2024-01-15T09:30:00Z",
  "household_id": "household_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "name": "Trust Agreement.pdf",
  "type": "GRAT_DESIGN_SUMMARY",
  "updated_at": "2024-01-20T14:45:00Z",
  "enable_ai_suggestions": true,
  "entity_id": "entity_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "individual_id": "client_profile_01ARZ3NDEKTSV4RRFFQ69G5FAV"
}
```