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

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

`PUT /api/v0/components/{component_id}/schematic/archive`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/components/{component_id}/schematic/archive`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/components/:component_id/schematic/archive/put.ts> (a function with typed inputs; its response is checked against the schema)

Reads an archive produced by GET and adds a new schematic visual component to this document for every component in the archive, with the 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

- `component_id` string, uuid, required

## Request body `multipart/form-data`

- BodyImportDocumentArchiveApiV0ComponentsComponentIdSchematicArchivePut
  - `file` string, binary, required: A schematic archive zip from GET.

## Response `200`

Successful Response

- OpApiEndpointsComponentsSchematicDocumentArchiveImportArchiveResponse: 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

## Changes

- **2026-09-25** `fcd15f6d35b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/components/:component_id/schematic/archive/put.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)