---
title: "Upload Initiate"
method: POST
path: "/artifacts/{artifact_id}/upload-initiate"
tags: ["Artifacts"]
---

# Upload Initiate

`POST /artifacts/{artifact_id}/upload-initiate`

Initiate an S3 upload for an artifact.

The artifact_id here is the *container* (workspace) the upload belongs to.
Delegates to workspace_service.initiate_upload_and_create_artifact().

## Path parameters

- `artifact_id` string, required

## Request body

- UploadInitiateRequest — Initiate an S3 upload for an artifact.
  - `filename` string, required
  - `content_type` string, required
  - `size` integer, required
  - `order_key` string, nullable
  - `context` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agience/apis/agience-platform-api.md) · [All operations](https://skmtc.net/agience/apis/agience-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agience/agience-platform-api/versions/187bad270c94/schema)