Reference

API Reference

The InkieAI REST API is versioned and prefixed at /api/v1. All requests must include a valid Clerk session cookie or bearer token. Unauthenticated requests receive a 401. The API is rate-limited to 100 requests per minute per user, with a 429 returned when the limit is exceeded.

GET /api/v1/articles returns a paginated list of all articles for the authenticated user. Query parameters include siteId, status (draft, published, archived), and page. The response contains an items array and a pagination object with total, page, and perPage counts.

GET /api/v1/articles/[slug] returns a single article object including title, content, html, meta fields, featuredImage, tags, and generation metadata. If the article does not exist or belongs to another user, the endpoint returns 404. PATCH /api/v1/articles/[slug] allows updating status and tags. DELETE is not supported; use status=archived instead.