Create a builder project

Open a workspace for a product, consultancy, or freelance practice.

Required scopes: builders:write · Base https://api.fatheron.dev

Steps

1. 1. Create project

   POST /v1/builders/projects
   X-API-Key: fh_live_…
   Content-Type: application/json
   
   {
     "name": "Acme Launch",
     "slug": "acme-launch",
     "description": "Agent-provisioned workspace"
   }

   Omit slug to auto-derive from name. Returns 201 with id like bprj-…

2. 2. List projects

   GET /v1/builders/projects
   X-API-Key: fh_live_…

   Add ?include_archived=true to see archived workspaces.

Failure remediation

• invalid_slug

  Use lowercase kebab: a-z, 0-9, hyphens only.

• slug_taken

  Pick another slug or omit slug.

• insufficient_scope

  Mint a key with builders:write (or legacy write).

All agent recipes