Snapvisor Docs
API ReferenceBuilds

Finalize parallel builds

Mark every parallel shard sharing the given `parallelNonce` as complete. Once finalized, Argos compares the aggregated screenshots and starts processing the build.

POST
/builds/finalize

Mark every parallel shard sharing the given parallelNonce as complete. Once finalized, Argos compares the aggregated screenshots and starts processing the build.

Authorization

projectToken
AuthorizationBearer <token>

Authenticate as a project with a project token.

Send it as a bearer token in the Authorization header:

Authorization: Bearer <project-token>

You can find your project token in your Argos project settings. Project tokens are used by CI and the SDK to create builds and deployments.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/builds/finalize" \  -H "Content-Type: application/json" \  -d '{    "parallelNonce": "string"  }'
{  "builds": [    {      "id": "string",      "number": 1,      "head": {        "sha": "string",        "branch": "string"      },      "base": {        "sha": "string",        "branch": "string"      },      "status": "accepted",      "conclusion": "no-changes",      "stats": {        "added": 0,        "removed": 0,        "unchanged": 0,        "changed": 0,        "ignored": 0,        "failure": 0,        "retryFailure": 0,        "total": 0      },      "metadata": {        "testReport": {          "status": "passed",          "stats": {            "startTime": "string",            "duration": 0          }        }      },      "url": "http://example.com",      "notification": {        "description": "string",        "context": "string",        "github": {          "state": "pending"        },        "gitlab": {          "state": "pending"        },        "url": "http://example.com"      }    }  ]}

Create a build POST

Create a build and receive signed upload targets for its screenshots and Playwright traces. The response lists, for every file Argos doesn't already have, a secure `postUrl` with `fields` (or a legacy `putUrl`) to upload it to. Supports single and parallel builds.

Find an eligible baseline from a list of commits POST

Find the build eligible to be used as a baseline among a list of commits. Useful when no Git provider is connected: the CLI can send the candidate ancestor commits and let Argos pick the closest one that has an eligible (complete, valid, approved and not rejected) baseline build.