Skip to main content
POST
Initialize a Template build-context upload

Authorizations

Authorization
string
header
required

API Key or Access Token, always sent as Authorization: Bearer <token>. The gateway recognizes the token type automatically.

Headers

Idempotency-Key
string
required

Caller-generated key that makes Template file initialization safe to retry. Matched byte-for-byte: 1-64 printable ASCII characters with no whitespace. The key is scoped to the organization and Template and is retained with the Template file lifecycle. A different request body under the same key returns 400 Sandbox.IdempotentParameterMismatch.

Required string length: 1 - 64

Path Parameters

template_id
string<uuid>
required

Owning GMI Template identifier.

Query Parameters

idc_name
string

Filter by data center name, e.g. us-denver-1

Body

application/json
name
string
required
Required string length: 1 - 255
content_type
enum<string>
required
Available options:
tar,
tgz
sha256
string
required
Pattern: ^[0-9a-fA-F]{64}$
size_bytes
integer<int64>
required
Required range: 1 <= x <= 1073741824

Response

Staging upload session initialized, or the original result replayed. Replays include Idempotency-Replayed: true.

request_id
string
required
data
object
required