---
title: "Get a Custom Agent's rows"
method: GET
path: "/custom-agents/{id}"
tags: ["Custom Agents"]
---

# Get a Custom Agent's rows

`GET /custom-agents/{id}`

> 🚧 Alpha: Custom Agents is a new capability and still under active development. Endpoints, fields, and behavior may change without notice.

Returns the rows (one per tracked entity) and cell data for a single Custom Agent, paginated with `count`/`continuation`.

Find the `id` to use here from a `customAgent`-type item returned by `GET /dashboards`, and use that same item's `schema.columns` to interpret each row's `cells`.

## Path parameters

- `id` string, required

## Query parameters

- `count` integer
- `continuation` string

## Response `200`

A page of rows for this Custom Agent.

- CustomAgentItemsResponse — A page of rows from a Custom Agent's table.
  - `items` CustomAgentRow[], required
    - `created` integer, required — EPOCH timestamp, in milliseconds, of when this row was first added to the table.
    - `updated` integer, required — EPOCH timestamp, in milliseconds, of the last time any cell in this row was updated.
    - `id` string, required — Id/name of the tracked entity this row represents (e.g. a malware family or threat actor name).
    - `cells` Cell[], required — One cell per column defined in the agent's `schema.columns`.
      - `entity` string, required — Id/name of the row this cell belongs to. Matches the parent row's `id`.
      - `column` string, required — Which column this cell fills in, matched against `name` in the agent's `schema.columns` (see `GET /dashboards`).
      - `value` string, required — The cell's content. Predefined columns hold a plain value; `userProvided` columns generated by Feedly AI are typically Markdown, often a bullet list with inline citation links (`[↗](url)`) that correspond to entries in `citations`.
      - `citations` Citation[], required — Source citations backing `value`. Empty for columns that don't require sourcing.
        - `llmPredictionMatch` string — The substring of the cell's `value` that this citation supports.
        - `citedText` string — Excerpt of the source article text supporting the value.
        - `entry` CitationEntry — The source article a citation was pulled from.
          - `entryId` string — Feedly entry ID of the source article.
          - `url` string, uri — URL of the source article.
      - `insufficientData` boolean, required — `true` when Feedly AI didn't have enough source material to confidently populate this cell.
    - `events` object[] — Timeline events associated with this row. Not yet documented in this spec — observed as an empty array in current responses.
  - `lastRefresh` integer, required — EPOCH timestamp, in milliseconds, of the last time this agent's data was refreshed.
  - `continuation` string — Present when more rows are available beyond this page. Pass it back as the `continuation` query parameter on your next request to `GET /custom-agents/{id}` to fetch the next page. Omitted on the last page.

## Other responses

- `401` — Missing or invalid Authorization header.
- `404` — No Custom Agent exists with the given `id` for this enterprise team.
- `429` — Rate limit exceeded. See [Request Limits](https://developers.feedly.com/reference/request-limits).

---

[API](https://skmtc.net/feedly/apis/streams-api.md) · [All operations](https://skmtc.net/feedly/apis/streams-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/feedly/streams-api/revisions/d38216a6d069/schema)