Deploy a version

Deploys an uploaded archive, or the function's workspace when no archive is given, and promotes the result unless asked not to.

A container deploy answers before its build finishes: the version comes back BUILDING and promotes itself when the build succeeds. Poll GetVersion and GetBuildLog to follow it.

Authorization

BearerAuth

AuthorizationBearer <token>

A team API token, created by a team owner and presented as Authorization: Bearer fnt_…. The secret is shown once at creation and stored only as a hash.

In: header

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1

Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

functionId?string

sourceZip?string

source_zip is an uploaded source tree, at most 64 MiB. Empty deploys what is already in the function's workspace, which is the path a function authored in the console takes.

Formatbyte

gitRef?string

skipPromote?boolean

skip_promote builds a version without pointing traffic at it. Deploys promote by default: an author deploying expects it to go live.

[key: string]?never

Response Body

`application/json`

curl -X POST "https://functions.xeonr.io/xeonr.functions.v1.FunctionService/DeployVersion" \
  -H "Connect-Protocol-Version: 1" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://functions.xeonr.io/xeonr.functions.v1.FunctionService/DeployVersion" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{}'

{
  "version": {
    "versionId": "string",
    "functionId": "string",
    "state": "VERSION_STATE_UNSPECIFIED",
    "snapshotId": "string",
    "environmentId": "string",
    "appId": "string",
    "staticRoot": "string",
    "gitCommit": "string",
    "gitRef": "string",
    "failureMessage": "string",
    "createdAtUnix": 0
  }
}

{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}

Deploy a version

Authorization

Header Parameters

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`