Custom Domains

Custom Domains API

Manage custom domains for your projects. Custom domains require a Pro or Business subscription plan.

Get Domain Status

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

Returns the current custom domain configuration for a project, or null if none is set.

Add Custom Domain

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

{ "domain": "myapp.example.com" }

Adds a custom domain to a live project. The response includes DNS records that must be configured at your domain registrar:

{
  "data": {
    "domain": { ... },
    "dnsRecords": [
      { "type": "CNAME", "host": "myapp.example.com", "value": "my-project.floop.tech" },
      { "type": "TXT", "host": "_floopfloop-verify.myapp.example.com", "value": "verify-token" }
    ]
  }
}

Remove Custom Domain

DELETE /api/v1/projects/{projectId}/domain

Removes the custom domain from the project.

File Uploads

POST /api/v1/uploads

Generate a presigned S3 URL for uploading files (images, PDFs, text). Use the returned key in the attachments array when creating or refining a project.

{
  "fileName": "screenshot.png",
  "fileType": "image/png",
  "fileSize": 123456
}

Response:

{
  "data": {
    "uploadUrl": "https://s3.amazonaws.com/...",
    "key": "uploads/userId/fileId/screenshot.png",
    "fileId": "uuid"
  }
}

After receiving the upload URL, PUT the file directly to it with the matching Content-Type header.