API Reference

Projects

Create, list, update, and manage projects via the API.

Projects API

Manage your FloopFloop projects programmatically.

List Projects

GET /api/v1/projects

Returns all projects owned by the authenticated user.

Query Parameters:

  • teamId (optional) — Filter by team workspace
curl -X GET https://floopfloop.com/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Create Project

POST /api/v1/projects

Creates a new project and starts the AI generation pipeline.

Request Body:

{
  "name": "My Project",          // required
  "subdomain": "my-project",     // required, lowercase
  "prompt": "Description...",    // required
  "botType": "app",              // optional: site, app, bot, api, internal
  "isAuthProtected": true,       // optional, default true
  "teamId": "uuid",              // optional, for team workspace
  "attachments": [               // optional
    {
      "key": "uploads/userId/fileId/file.png",
      "fileName": "file.png",
      "fileType": "image/png",
      "fileSize": 12345
    }
  ]
}

Response (201):

{
  "data": {
    "project": { "id": "...", "name": "My Project", "status": "queued", ... },
    "deployment": { "id": "...", "version": 1, "status": "pending" }
  }
}

Get Project

GET /api/v1/projects/{projectId}

Returns details of a specific project.

Update Project

PATCH /api/v1/projects/{projectId}

Request Body (all fields optional):

{
  "name": "New Name",
  "description": "Updated description",
  "isPublic": true,
  "isAuthProtected": false,
  "hasBranding": false
}

Archive Project

DELETE /api/v1/projects/{projectId}

Archives a project and releases its subdomain. AWS resources are cleaned up in the background.

Refine Project

POST /api/v1/projects/{projectId}/refine

Send follow-up instructions to modify a live project.

{
  "message": "Add a contact form to the homepage",
  "codeEditOnly": false,         // optional, true for code-only edits (cheaper)
  "attachments": []              // optional
}

If the project is currently deploying, the message will be queued and processed automatically after the current deployment completes.

Get Conversations

GET /api/v1/projects/{projectId}/conversations

Returns the full conversation history including deployment markers and queued messages.

Browse Library

GET /api/v1/library

Query Parameters:

  • botType — Filter by type (site, app, bot, api, internal)
  • search — Search by name or description
  • sort — newest (default) or popular
  • page — Page number (default 1)
  • limit — Items per page (1-50, default 20)

Clone Library Project

POST /api/v1/library/{projectId}/clone
{ "subdomain": "my-clone" }

Clones a public project from the library to your account.

PreviousAuthenticationNextDeployments