Overview
GET/content/markdowncontent

List/search the caller's markdown documents (metadata only)

Lists the caller’s documents, most-recently-updated first. Optional filters narrow the set: `q` (free-text, case-insensitive substring across title, body, category, and tags), `category` (exact match), and `tag` (set membership).

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • workspacequery · optionalstring

    Scope to this WORKSPACE’s owning principal (the caller’s own customer slug, or an organization the caller belongs to). Omitted: the caller’s own documents. Unknown/foreign slug: 404.

  • pagequery · optionalinteger
  • pageSizequery · optionalinteger
  • qquery · optionalstring

    Free-text query matched across title, body, category, and tags.

  • categoryquery · optionalstring

    Restrict to documents with this exact category.

  • tagquery · optionalstring

    Restrict to documents whose tag set contains this tag.

  • sourcequery · optionalstring

    Restrict to documents whose frontmatter adh_source equals this value. Used by researchUpsert to look up an existing doc without scanning the full export.

Responses
200

A page of document metadata, most-recently-updated first

  • itemsMarkdownDocumentSummary[]
  • totalinteger
  • pageinteger
  • pageSizeinteger
Example
{
  "items": [
    {
      "id": "string",
      "title": "string",
      "frontmatter": {},
      "category": "string",
      "tags": [
        "string"
      ],
      "visibility": "private",
      "stage": "draft",
      "kind": "paper",
      "publicRoute": "string",
      "contentHash": "string",
      "sizeBytes": 0,
      "currentVersion": 0,
      "latestVersionId": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "total": 0,
  "page": 0,
  "pageSize": 0
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/content/markdown" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/content/markdown", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  },
});
const data = await res.json();