REST API

FreeCloudPhone exposes a small JSON API for scripting and integrations. All endpoints live under /api/v1/. For the live, interactive docs see Swagger UI.

Auth

Two methods. Use whichever fits your client.

Cookie session — browser apps. Set automatically after Discord OAuth login.
Bearer API key — scripts/CLI. Generate a key on the Settings page.

curl https://freecloudphone.com/api/v1/me \
  -H "Authorization: Bearer fcp_xxx_yyy"

Endpoints

GET

/api/v1/me

Current user profile.

GET

/api/v1/wallet

Coin balance + pending.

GET

/api/v1/history

Recent activity (limit, offset, action filter).

POST

/api/v1/reg

POST

/api/v1/buff

Buff account. Body { service, code, rounds }.

POST

/api/v1/getlink

Get cloud phone link. Body { provider, mode }.

GET

/api/v1/jobs/{id}

Poll a queued job status.

GET

/api/v1/devices

List your assigned cloud phone devices.

GET

/api/v1/accounts

List your managed Roblox accounts.

GET

/api/v1/keys

List your API keys.

POST

/api/v1/keys

Create a new API key. Query ?label=my-cli.

DELETE

/api/v1/keys/{id}

Revoke an API key.

Errors

Errors come back as JSON with { "detail": "..." }. Status codes: 401 (not authenticated), 402 (out of quota), 403 (forbidden), 429 (rate limited).

Rate limits

Reg/buff jobs respect the same daily quota as the Discord bot, plus per-IP backoff. Plan accordingly.