Builds API | FlightStack

Builds API

Build jobs are the unit of work the agent actually executes. All endpoints under /build.

Endpoints

Method	Path	Purpose
GET	`/build`	List builds. Filters: `repositoryId=`, `status=`, `branch=`. Paginated.
POST	`/build`	Trigger a build.
GET	`/build/{id}`	Get build details (status, agent, steps, outputs).
GET	`/build/{id}/logs`	Get the full log buffer for a build.
POST	`/build/{id}/cancel`	Cancel a running build.
POST	`/build/{id}/retry`	Retry a failed or cancelled build.
DELETE	`/build/{id}`	Remove a build from history.

Trigger a build

curl -X POST https://api.flightstack.voostack.com/build \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "repositoryId": "7d2a8c84-...",
    "branch": "main",
    "platform": "ios",
    "buildMode": "release",
    "flutterVersion": "3.27.0",
    "flavor": "prod",
    "scheme": "Runner",
    "autoDeploy": true,
    "signing": { "iosCredentialId": "..." },
    "envVariables": { "API_BASE_URL": "https://api.example.com" },
    "buildArgs": ["--dart-define=ENV=prod"],
    "timeoutMinutes": 45
  }'

Payload fields

Field	Type	Notes
`repositoryId`	string	Required. ID of a connected repository.
`branch`	string	Defaults to the repo’s default branch.
`platform`	`ios`\|`android`\|`web`\|`macos`\|`linux`	Required.
`flutterVersion`	string	Pinned Flutter SDK version. Omit to use agent default.
`buildMode`	`debug`\|`profile`\|`release`	Defaults to `release`.
`flavor`	string	Flutter flavor name.
`scheme`	string	iOS Xcode scheme. Defaults to `Runner`.
`signing`	object	Code-signing credential refs — see Code signing.
`autoDeploy`	bool	Auto-trigger deployment job on success.
`envVariables`	`map<string,string>`	One-off env injected into the build.
`buildArgs`	`string[]`	Extra args appended to `flutter build`.
`timeoutMinutes`	int	Default `60`. Server enforces a tier-specific upper bound.

Inspect a build

curl https://api.flightstack.voostack.com/build/$BUILD_ID \
  -H "Authorization: Bearer $TOKEN"

Logs

curl https://api.flightstack.voostack.com/build/$BUILD_ID/logs \
  -H "Authorization: Bearer $TOKEN"

Returns the full log buffer (newest at the end). For live logs, subscribe to the SignalR build hub — see Realtime.

Cancel / retry

curl -X POST https://api.flightstack.voostack.com/build/$BUILD_ID/cancel \
  -H "Authorization: Bearer $TOKEN"

curl -X POST https://api.flightstack.voostack.com/build/$BUILD_ID/retry \
  -H "Authorization: Bearer $TOKEN"

Retry creates a new build with the same configuration (new build ID, fresh agent assignment).