---
title: "Publish a Shared Pipeline Artifact"
method: POST
path: "/v1/shared-pipelines/artifacts"
tags: ["Shared Pipeline Artifacts"]
---

# Publish a Shared Pipeline Artifact

`POST /v1/shared-pipelines/artifacts`

Publishes a shared pipeline artifact as a multipart upload. The sharedPipelineIdPrefix identifies the shared pipeline group.

## Headers

- `content-type` string, required
- `sharedPipelineIdPrefix` string, required
- `versionName` string, required
- `commitHash` string
- `branch` string

## Response `201`

Shared pipeline artifact published successfully

- PublishSharedPipelineResponse
  - `ignoredResources` IgnoredAsset[] — List of resources that were excluded from the published shared pipeline and the reasons they were ignored
    - `name` string — Name of the asset that has been ignored
    - `reason` string — Reason the asset was ignored
  - `versionName` string — The version name of the shared pipeline artifact

## Other responses

- `400` — Invalid sharedPipelineIdPrefix format or missing required headers
- `401` — Missing or invalid authentication token
- `403` — Insufficient permissions to publish shared pipeline artifacts
- `404` — Resource not found
- `409` — Artifact version already exists for this sharedPipelineIdPrefix
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)