Repositories API | FlightStack

Repositories API

All endpoints under /repository. List endpoints accept X-Organization-Id to scope.

Endpoints

Connected repositories

Method	Path	Purpose
GET	`/repository`	List connected repos. Filters: `isConnected=`, `search=`. Paginated.
POST	`/repository`	Connect a repository (alias for `/repository/connect`).
POST	`/repository/connect`	Connect a GitHub repo by full name.
GET	`/repository/{id}`	Get a single repository.
PUT	`/repository/{id}`	Update repository metadata.
DELETE	`/repository/{id}`	Delete the repository and all associated data (pipelines, secrets, history).
POST	`/repository/{id}/disconnect`	Disconnect without deleting (keeps pipelines).
POST	`/repository/{id}/sync`	Resync branches and metadata from GitHub.

Settings & webhook

Method	Path	Purpose
GET	`/repository/{id}/settings`	Get repo-level settings.
PUT	`/repository/{id}/settings`	Update repo-level settings.
POST	`/repository/{id}/webhook/enable`	Install or enable the GitHub webhook.
POST	`/repository/{id}/webhook/disable`	Disable the GitHub webhook.

File browsing

Method	Path	Purpose
GET	`/repository/{id}/directories`	List child directories. Query: `path=`, `branch=`.
GET	`/repository/{id}/contents`	List file + directory entries at a path.
GET	`/repository/{id}/file`	Fetch file contents. Query: `path=`, `branch=`.

GitHub catalog

Method	Path	Purpose
GET	`/repository/github/available`	List GitHub repos available to connect (per the installed App).

Connect a repository

curl -X POST https://api.flightstack.voostack.com/repository/connect \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "githubRepoFullName": "acme/mobile",
    "organizationId": "7d2a8c84-..."
  }'

organizationId is optional — omit it to create a personal connection.

List with pagination

curl "https://api.flightstack.voostack.com/repository?skip=0&take=20&isConnected=true" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Organization-Id: 7d2a8c84-..."

Read a file

curl "https://api.flightstack.voostack.com/repository/$REPO_ID/file?path=pubspec.yaml&branch=main" \
  -H "Authorization: Bearer $TOKEN"

Returns the file contents inline (text) or base64 (binary).