---
title: "Submit Remote Build"
method: POST
path: "/builds/submit"
tags: ["Builds"]
---

# Submit Remote Build

`POST /builds/submit`

Submit a Cloud Build build for an uploaded build context archive.

## Request body

- BuildSubmitRequest — Submit a Cloud Build build for a previously uploaded build context.
  - `agent_name` string, required — Agent short name
  - `bucket` string, required — GCS bucket containing uploaded build context archive.
  - `git_branch` string, nullable — Optional git branch name for metadata.
  - `git_hash` string, nullable — Optional git hash for metadata.
  - `namespace` string, required — Target namespace slug
  - `object_key` string, required — GCS object key for the uploaded build context archive.
  - `tag` string, required — Image tag to build/push

## Response `201`

Successful Response

- BuildSubmitResponse — Response after submitting a Cloud Build build.
  - `build_id` string, required — Cloud Build build ID (use for status polling).
  - `image_url` string, required — Full Artifact Registry image URL that the build will push.
  - `log_url` string, nullable — Cloud Build log URL (if available).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/terminaluse/apis/sb0-api.md) · [All operations](https://skmtc.net/terminaluse/apis/sb0-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/terminaluse/sb0-api/revisions/f24a474dc415/schema)