Organizations API | FlightStack

Organizations API

All endpoints under /organization.

Endpoints

Method	Path	Purpose
GET	`/organization`	List organizations. Query: `pageNumber=`, `pageSize=`, `search=`.
POST	`/organization`	Create an organization.
GET	`/organization/{id}`	Get an organization.
PUT	`/organization/{id}`	Update name / description.
DELETE	`/organization/{id}`	Delete the organization.
GET	`/organization/{id}/usage`	Get usage stats (runs, cloud-runner minutes, storage).
POST	`/organization/{id}/api-key/rotate`	Rotate the organization’s API key.
GET	`/organization/{id}/members`	List members.
PUT	`/organization/{id}/members/{userId}/role`	Update a member’s role.
DELETE	`/organization/{id}/members/{userId}`	Remove a member.

Create

curl -X POST https://api.flightstack.voostack.com/organization \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme",
    "description": "Acme Mobile Team"
  }'

Get usage

curl https://api.flightstack.voostack.com/organization/$ORG_ID/usage \
  -H "Authorization: Bearer $TOKEN"

Response includes pipeline run counts, cloud-runner minutes, and storage consumed for the current billing period.

Rotate the API key

curl -X POST https://api.flightstack.voostack.com/organization/$ORG_ID/api-key/rotate \
  -H "Authorization: Bearer $TOKEN"

Returns the new key in the response body. The old key is invalidated immediately — update any CI integrations before rotating.

Member roles

Role	Permissions
`owner`	Full control. Can transfer ownership, delete the org.
`admin`	Manage repos, pipelines, agents, secrets, members.
`member`	Author and trigger pipelines; view runs and agents.
`viewer`	Read-only access to runs and agent status.

Update a member’s role:

curl -X PUT https://api.flightstack.voostack.com/organization/$ORG_ID/members/$USER_ID/role \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role":"admin"}'