---
title: "Upload a build artifact file to Ketryx"
method: POST
path: "/build-artifacts"
tags: ["Builds"]
---

# Upload a build artifact file to Ketryx

`POST /build-artifacts`

## Request

- Base URL: `https://app.ketryx.com/api/v1`
- URL: `https://app.ketryx.com/api/v1/build-artifacts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ketryx/apis/ketryx-api/docs/build-artifacts/post.ts> (a function with typed inputs; its response is checked against the schema)

Uploads a build artifact to Ketryx, which can then be included in a build using the `/builds` API. The file is encoded in a request of type `multipart/form-data`.

## Query parameters

- `project` string

## Request body `multipart/form-data`

- object
  - `content` string, binary

## Response `200`

OK

- object
  - `ok` boolean: Whether the upload was successful
  - `id` string: Artifact ID, which can be referenced in the `/builds` API (under `artifacts`)

## Other responses

- `400`: The request is not valid.
- `401`: The requester is not authenticated.
- `403`: The requester is unauthorized.
- `404`: The resource was not found.

---

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