List content

Paginated list of content documents for the project. Filter by mode (CREATE or OPTIMIZE) and/or status (PENDING, IN_PROGRESS, COMPLETED, FAILED, STOPPED) to narrow results. Each row includes status, mode, title, linked prompt id/text, and timestamps but omits the full markdown content body — use GET /content/:id for the complete document. Pagination uses size (page length) with total/page/totalPages in the response, matching other v2 list endpoints.

GET /content

List content

cURL

curl --request GET \
  --url https://server.promptwatch.com/api/v2/content \
  --header 'X-API-Key: <api-key>'

200

Example

{ "documents": [ { "id": "6ba7b82c-9dad-11d1-80b4-00c04fd430c8", "status": "COMPLETED", "mode": "CREATE", "type": "ARTICLE", "title": "Illustrative GEO checklist article", "promptId": "6ba7b823-9dad-11d1-80b4-00c04fd430c8", "prompt": "How do I track AI search visibility?", "createdAt": "2026-03-20T10:00:00.000Z", "updatedAt": "2026-03-20T10:08:00.000Z", "completedAt": "2026-03-20T10:08:00.000Z" }, { "id": "6ba7b82d-9dad-11d1-80b4-00c04fd430c8", "status": "FAILED", "mode": "OPTIMIZE", "type": null, "title": null, "promptId": "6ba7b825-9dad-11d1-80b4-00c04fd430c8", "prompt": "How does Example Brand compare on integrations?", "createdAt": "2026-03-21T09:00:00.000Z", "updatedAt": "2026-03-21T09:02:00.000Z", "completedAt": null } ], "total": 2, "page": 1, "size": 25, "totalPages": 1 }

Authorizations

X-API-Key · string · header · required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Query Parameters

page · integer · default: 1

Page number (1-based).

Required range: x >= 1

size · integer · default: 25

Page size (max 100); matches other v2 list endpoints.

Required range: 1 <= x <= 100

orderBy · enum<string> · default: createdAt

Sort field.

Available options: createdAt, updatedAt

sortOrder · enum<string> · default: desc

Sort direction.

Available options: asc, desc

mode · enum<string>

Filter by CREATE vs OPTIMIZE.

Available options: CREATE, OPTIMIZE

status · enum<string>

Filter by generation status.

Available options: PENDING, IN_PROGRESS, COMPLETED, FAILED, STOPPED

Response

200

application/json

Default Response

documents · object[] · required

Documents for the current page (no full markdown body).

Show child attributes

total · integer · required

Total documents matching filters (all pages).

Required range: x >= 0

page · integer · required

Required range: x >= 1

size · integer · required

Page length (same as request size).

Required range: x >= 1

totalPages · integer · required

Ceil(total / size).

Required range: x >= 0