Snapvisor Docs
API ReferenceBuilds

Create a build

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.

POST
/builds

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.

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

curl -X POST "https://example.com/builds" \  -H "Content-Type: application/json" \  -d '{    "commit": "string",    "branch": "string",    "screenshotKeys": [      "string"    ]  }'
{  "build": {    "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"    }  },  "screenshots": [    {      "key": "string",      "putUrl": "http://example.com"    }  ],  "pwTraces": [    {      "key": "string",      "putUrl": "http://example.com"    }  ]}

Exchange a tokenless GitHub Actions token for an Argos token POST

Called by GitHub Actions to exchange a tokenless bearer token for a short-lived Argos project token. The provided commit and branch must match the GitHub workflow run.

Finalize parallel builds POST

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