Skip to main content

​
List Projects

GET /api/v1/content/projects
Returns a paginated list of all projects in your shop.

​
Authentication

Requires a Content API key. See Authentication.

​
Query parameters

ParameterTypeDefaultDescription
limitinteger50Number of projects to return (max 100)
afterstring—Cursor for pagination (from nextCursor)

​
Response

{
  "object": "list",
  "data": [
    {
      "id": "clx1abc23def456ghij",
      "name": "My Storefront",
      "parentProjectId": null,
      "createdAt": "2026-01-15T08:30:00.000Z"
    },
    {
      "id": "clx2ghi78jkl901mnop",
      "name": "Holiday Campaign",
      "parentProjectId": "clx1abc23def456ghij",
      "createdAt": "2026-02-20T14:15:00.000Z"
    }
  ],
  "nextCursor": null
}

​
Response fields

FieldTypeDescription
objectstringAlways "list"
dataarrayArray of project objects
data[].idstringProject ID
data[].namestringProject display name
data[].parentProjectIdstring | nullParent project ID (for child projects)
data[].createdAtstring | nullISO 8601 creation timestamp
nextCursorstring | nullCursor for the next page, null if no more results

​
Errors

CodeStatusWhen
UNAUTHORIZED401Missing or invalid API key
INVALID_PARAMS400Invalid cursor value
INTERNAL_ERROR500Unexpected server error

​
Examples

# List first 10 projects
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://studio.weaverse.io/api/v1/content/projects?limit=10"