API reference | Fous API Reference

The Fous API is served at https://api.fous.com. Its contract is OpenAPI 3.1, version 1.0.0, and this reference is generated from it.

Authentication

Send your organization’s key as Authorization: Bearer $FOUS_API_KEY. Every endpoint needs it. Without a valid key, an endpoint answers 401 with unauthorized. Create a key.

Endpoints

Methods

Find methods, read their contracts, publish or delete your own.

Runs

Run a method with your own input, or send a query and get the result.

Builds

Build a method, steer it with messages, and follow it to the end.

Connections

Website logins and API keys that methods run with.

Account

The organization behind the key.

GET/v1/accountGet the account

Errors

Every failure answers an HTTP error status with an error object: branch on error.code. Errors shows the object and the codes of each status; the errors guide says what to do about each code.

Base URL
https://api.fous.com
curl 'https://api.fous.com/v1/account' \  -H "Authorization: Bearer $FOUS_API_KEY"
// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/account', {  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  },});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);
import osimport requestsresponse = requests.get(    "https://api.fous.com/v1/account",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)
Response 200
{  "organization": {    "id": "org_01M4CD7TVHDBPFQHZD05XMW5PB",    "name": "Agent Test"  },  "credits": {    "balance": 585,    "balance_usd": 5.85  },  "limits": {    "requests_per_minute": 60,    "concurrent_runs": 8,    "monthly_spend_limit_credits": null  },  "builds": {    "free_per_month": 20,    "used_this_month": 9  },  "prices": {    "search": 0,    "run": 1,    "query": 5,    "build_after_allowance": 100,    "private_build": 100  },  "key": {    "kind": "user",    "name": "Server",    "client_name": null,    "expires_at": null,    "last_used_at": "2026-10-23T09:11:15.000Z"  }}