The Developer Portal at /developers is your self-serve hub for building products on Forge. This guide walks you through creating a consumer app, restricting its scopes, deploying a team from a manifest, and firing your first API call — no admin access needed.
Step 1: Open the Developer Portal
In the sidebar, click Build → Developers. You will see the quick-start panel with sample curl and SDK snippets, a manifest editor, and your consumer apps list.
Step 2: Create a consumer app
Click + New App. Enter a name (e.g. "My Product") and optional description. Click Create & generate key. The frg_app_… key is shown once — copy it to a secure location (a .env file or a secrets manager). It cannot be retrieved again; you can rotate it later if needed.
Step 3: Configure scopes (optional)
Click the app name to open its detail page, then click Edit. Uncheck any scopes you want to restrict. For example, uncheck runs:write and teams:write to create a read-only monitoring key. All scopes are granted by default.
Step 4: Make your first API call
curl -X POST https://forge.shanova.se/api/v1/runs \
-H "Authorization: Bearer frg_app_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"team_id": "TEAM_ID_FROM_FORGE",
"title": "My first run",
"brief": "Analyse the DACH B2B SaaS market for an HR tech entrant."
}'A run with status: queued is returned immediately. Use the id to poll or stream progress.
Step 5: Monitor usage
Click the app name to see this month's run count, token usage, and cost. The usage bar turns amber at 70% and red at 90% of your monthly quota. Contact support to raise your limit.