GET /v1/articles
List your articles — Shorty API
Returns the authenticated account’s articles (summaries), newest first, cursor-paginated. Pass the previous response’s `next_cursor` as `?cursor=` to fetch the next page; a cursor is only valid against the SAME query it was minted under.
GET /v1/articlesReturns the authenticated account’s articles (summaries), newest first, cursor-paginated. Pass the previous response’s next_cursor as ?cursor= to fetch the next page; a cursor is only valid against the SAME query it was minted under.
Authentication
Requires a Bearer credential — a shk_live_ API key or an OAuth 2.1 access token with the scope for this resource. See Authentication.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
cursor | query | No | — |
limit | query | No | — |
Example request
curl -X GET https://aishorty.com/v1/v1/articles?cursor=cursorValue&limit=20 \
-H "Authorization: Bearer shk_live_your_key"Response · 200
| Field | Type | Required | Description |
|---|---|---|---|
data | Article[] | Yes | — |
has_more | boolean | Yes | Whether another page exists after this one. |
next_cursor | string or null | Yes | Opaque cursor for the next page (pass as ?cursor=), or null on the last page. Only valid against the SAME query filter. |
Errors
On failure this endpoint returns an RFC 9457 problem body. Possible statuses:
400401403429500
Switch on the problem code, not the status. See the error reference for every code and how to fix it.