API Reference

Base URL: https://api.fibre.dev

All authenticated endpoints require an Authorization: Bearer <token> header.

Authentication

POST/v1/auth/register

Request body

{
  "email": "you@example.com",
  "password": "••••••••"
}

Response

{
  "user": { "id": "usr_...", "email": "you@example.com" },
  "access_token": "eyJ...",
  "refresh_token": "eyJ..."
}

POST/v1/auth/login

Request body

{
  "email": "you@example.com",
  "password": "••••••••"
}

Response

{
  "user": { "id": "usr_...", "email": "you@example.com" },
  "access_token": "eyJ...",
  "refresh_token": "eyJ..."
}

Apps

POST/v1/apps

Request body

{
  "name": "my-app",
  "gpu_type": "T4",
  "exposed_port": 8000,
  "image": "nvidia/cuda:12.1.1-cudnn8-runtime-ubuntu22.04",
  "memory_mb": 4096
}

Response

{
  "app": { "name": "my-app", "status": "creating", ... },
  "hostname": "my-app--yourorg.fibre.run"
}

GET/v1/apps

Response

{
  "apps": [
    { "name": "my-app", "status": "running", "gpu_type": "T4" },
    ...
  ]
}

GET/v1/apps/:name

Response

{
  "app": {
    "name": "my-app",
    "status": "running",
    "gpu_type": "T4",
    "exposed_port": 8000,
    "hostname": "my-app--yourorg.fibre.run"
  }
}

PUT/v1/apps/:name

Request body

{
  "gpu_type": "A10G",
  "memory_mb": 8192
}

Response

{
  "app": { "name": "my-app", "gpu_type": "A10G", ... }
}

DELETE/v1/apps/:name

Response

{
  "deleted": true
}

POST/v1/apps/:name/start

Response

{
  "sandbox": {
    "id": "sbx_...",
    "status": "running",
    "started_at": "2026-04-20T12:00:00Z"
  }
}

POST/v1/apps/:name/stop

Response

{
  "stopped": true,
  "sandbox_id": "sbx_...",
  "terminated_at": "2026-04-20T12:05:00Z"
}

Secrets

POST/v1/secrets

Request body

{
  "name": "OPENAI_API_KEY",
  "value": "sk-..."
}

Response

{
  "secret": {
    "name": "OPENAI_API_KEY",
    "version": 1
  }
}

GET/v1/secrets

Response

{
  "secrets": [
    {
      "name": "OPENAI_API_KEY",
      "version": 1,
      "updated_at": "2026-04-20T10:00:00Z"
    }
  ]
}

DELETE/v1/secrets/:name

Response

{
  "deleted": true
}