---
title: "Add a document's schematic components from an uploaded zip"
method: PUT
path: "/api/v0/documents/{document_id}/schematic/archive"
tags: ["Documents"]
---

# Add a document's schematic components from an uploaded zip

`PUT /api/v0/documents/{document_id}/schematic/archive`

Reads an archive produced by GET and adds a new schematic visual component to this document for every component in the archive — same type, label, page, bbox, and graph as the source. Components are always created, never matched against existing VCs, so the same bundle can be loaded onto any document. Returns the public ids of the newly created VCs.

## Path parameters

- `document_id` string, uuid, required

## Response `200`

Successful Response

- OpCoreApiEndpointsDocumentsSchematicArchiveImportArchiveResponse — Outcome of an archive import: the new VCs added to the document.
  - `created_count` integer, required
  - `created_vc_ids` string[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) · [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outerport/outerport-api/revisions/f565b46daaea/schema)