API Overview

API Overview

FlightStack provides a REST API for programmatic access to all features.

Base URL

https://api.flightstack.dev

For self-hosted instances, use your configured API URL.

Authentication

All API requests require authentication via JWT Bearer token:

curl -H "Authorization: Bearer <token>" \
  https://api.flightstack.dev/repository

See Authentication for details on obtaining tokens.

Response Format

All responses are JSON:

{
  "data": { ... },
  "error": null
}

Error responses:

{
  "data": null,
  "error": "Error message",
  "statusCode": 400
}

Endpoints

Endpoint	Description
/auth/*	Authentication
/repository	Repository management
/pipeline	Pipeline management
/buildagent	Build agent management
/organization	Organization management

Rate Limiting

API requests are rate-limited to prevent abuse:

• 100 requests per minute for authenticated users
• 10 requests per minute for unauthenticated

SDKs

Official SDKs are available:

• Dart/Flutter: flightstack_core package
• CLI: flightstack command-line tool

Next Steps

• Authentication
• Build Agents API
• Repositories API