Skip to main content

List All Sites

Returns all sites owned by the authenticated user.
GET /api/v1/publishes

Headers

HeaderRequiredDescription
AuthorizationYesBearer sl_live_...

Example

curl -X GET https://supalink.dev/api/v1/publishes \
  -H "Authorization: Bearer sl_live_your_key_here"

Response (200)

{
  "sites": [
    {
      "slug": "bright-canvas-a7k2",
      "siteUrl": "https://bright-canvas-a7k2.supalink.dev/",
      "status": "active",
      "title": "My Project",
      "fileCount": 5,
      "totalSize": 102400,
      "createdAt": "2026-03-19T20:37:48.537Z",
      "updatedAt": "2026-03-19T20:50:57.655Z",
      "expiresAt": null
    },
    {
      "slug": "deep-dock-h336",
      "siteUrl": "https://deep-dock-h336.supalink.dev/",
      "status": "pending",
      "title": null,
      "fileCount": 0,
      "totalSize": 0,
      "createdAt": "2026-03-20T10:15:00.000Z",
      "updatedAt": "2026-03-20T10:15:00.000Z",
      "expiresAt": null
    }
  ],
  "total": 2
}

Response Fields

FieldTypeDescription
slugstringThe site’s unique identifier
siteUrlstringThe live URL
statusstringactive, pending, or expired
titlestring | nullThe site title (from metadata)
fileCountnumberNumber of files in the current version
totalSizenumberTotal size in bytes of all files
createdAtstringISO 8601 timestamp
updatedAtstringISO 8601 timestamp
expiresAtstring | nullExpiry timestamp (null = permanent)