---
title: "Finalize component upload and trigger processing"
method: PUT
path: "/api/v0/components/{component_id}/upload-url"
tags: ["Components"]
---

# Finalize component upload and trigger processing

`PUT /api/v0/components/{component_id}/upload-url`

Triggers processing of a component after client has uploaded to storage via presigned URL.

## Path parameters

- `component_id` string, required

## Request body

- UpdateComponentUrlRequest — Request to finalize upload and trigger processing after direct S3 upload.
  - `upload_url` string, required — The upload URL that was used
  - `filename` string, nullable — Original filename to preserve
  - `include_description` boolean — Whether to include description
  - `baseline_mode` boolean — Use baseline mode
  - `baseline_provider` 'vlm' | 'azure' | 'gcp', nullable — Baseline provider
  - `fix_text_with_vlm` boolean — Fix text with VLM
  - `detect` boolean — For schematic components: run symbol detection on the uploaded image instead of starting from an empty canvas
  - `config` object, nullable — Optional config for schematic components

## Response `200`

Successful Response

- ComponentPostResponse
  - `job_status_id` string, uuid, required — The ID of the job status
  - `status` string, required — The status of the job
  - `error_message` string, nullable, required — The error message if the job failed
  - `component_id` string, uuid, required — The ID of the component

## 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)