---
title: "List Agent Resources"
method: GET
path: "/voice/agent-resources"
tags: ["Voice Agent Intelligence"]
---

# List Agent Resources

`GET /voice/agent-resources`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/voice/agent-resources`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### List Agent Resources

Lists the knowledge documents/links an agent searches during calls -- separate from the KB Gaps and FAQ Suggestions above, which are the self-improvement layer that surfaces what an agent is missing, not the content itself. Paginated; optionally scoped to one agentId, and searchable by title/description.

## Query parameters

- `agentId` string
- `page` integer
- `limit` integer
- `search` string

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `resources` object[]
      - `_id` string: MongoDB document id, included because every document has one; use resourceId to identify it.
      - `resourceId` string: Server-generated UUID. Immutable -- sent in the body on create or update is silently dropped.
      - `agentId` string: Required on create. Immutable after create -- sent on update is silently dropped.
      - `companyId` string: Stamped from the caller's authenticated company. Sent in the body is silently dropped.
      - `userId` string: Id of the user who created this resource. Sent in the body is silently dropped.
      - `url` string, uri: Required on create.
      - `title` string: Required on create. Max 200 characters.
      - `description` string: Required on create. Max 1000 characters.
      - `action` 'link' | 'presentation': Required on create.
      - `contentType` 'video' | 'pdf' | 'image'
      - `status` 'pending' | 'uploading' | 'processing' | 'completed' | 'failed': Defaults to pending. Advances as the resource's content is fetched and embedded for the agent to search during calls. Not settable directly.
      - `isDeleted` boolean: Delete is a soft delete. Not settable directly.
      - `deletedAt` string, date-time, nullable
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `total` integer
    - `page` integer
    - `limit` integer

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)