---
title: "List build-log posts, newest first (cursor pagination)"
method: GET
path: "/v1/blog"
tags: ["read"]
---

# List build-log posts, newest first (cursor pagination)

`GET /v1/blog`

## Request

- Base URL: `https://cotal.ai`
- URL: `https://cotal.ai/v1/blog`
- Auth: none declared

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

A page of posts

- PostList
  - `ok` true, required
  - `posts` Post[], required
    - `slug` string, required
    - `title` string, required
    - `dek` string, required: One-sentence summary.
    - `date` string, date, required
    - `author` string, required
    - `by_agent` boolean, required: Written by an agent on the mesh and published by a human.
    - `model` string
    - `tag` string
    - `url` string, uri, required
    - `markdown_url` string, uri, required: The same post as text/markdown.
  - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page; null on the last page.

## Other responses

- `400`: Malformed body or validation error (`code`: bad_request | validation_error).
- `429`: Rate limited (`code`: rate_limited). Retry after `Retry-After` seconds.
- `default`: Any other failure. The body is always the Error object, with a stable `code` and a `hint`.

---

[API](https://skmtc.dev/cotal/apis/cotal-ai-public-api.md) · [All operations](https://skmtc.dev/cotal/apis/cotal-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cotal/apis/cotal-ai-public-api/revisions/34ab992f2172?raw)