list_resources

Paginated list of project resources (the places a connector gates plus manual perks) scoped to one project, narrowable by kind and by connector.

Purpose

List every resource attached to a project — the places a connector gates, manual PDF / URL perks, and any other unit the creator has registered as gated content. Results are scoped to the caller's team and ordered newest-first. kind narrows the page to one kind of resource and connector to everything one connector gates; either alone or both together.

Required ability

project-resource:view-any

Input schema

{
  "type": "object",
  "required": ["project_id"],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "UUID of the parent project."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum resources to return per page (1..100)."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "1-indexed page number."
    },
    "kind": {
      "type": "string",
      "description": "Only resources of one kind: `manual`, or a connector's kind spelled `connector:kind` (`telegram:channel`)."
    },
    "connector": {
      "type": "string",
      "description": "Only the resources one connector gates, by its key (`telegram`)."
    }
  }
}

Output shape

{
  "data": [
    {
      "id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "kind": "telegram:channel",
      "connector": "telegram",
      "space": {
        "id": "3c1f7a58-2b6e-4d90-8f41-6a2e9c5d7b10",
        "external_id": "-1001234567890",
        "title": "Research Premium Lounge"
      },
      "title": "Research Premium Lounge",
      "description": "Daily research notes.",
      "active": true,
      "created_at": "2026-05-18T10:05:00Z",
      "updated_at": "2026-05-18T10:05:00Z"
    },
    {
      "id": "8c2f4a61-3d7e-4b90-a5c8-1e6f9d0b2c73",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "kind": "manual",
      "connector": null,
      "space": null,
      "title": "Onboarding PDF",
      "description": "Link to the onboarding pack.",
      "active": true,
      "created_at": "2026-05-18T10:05:00Z",
      "updated_at": "2026-05-18T10:05:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 2,
    "has_more": false
  }
}

space is the place the resource is bound to, null for a manual perk and for a place-kind resource that was unlinked. The row is the same object GET /v1/projects/{project}/resources returns.

Example prompts

"List resources on project 7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13."

"Which Telegram channels does my Research Premium project sell?"

"Which resources are still unlinked on my Research Premium project?"

Failure modes

RESOURCE_NOT_FOUND — unknown project_id, or the project belongs to a team outside the token's scope.
VALIDATION_FAILED — kind is neither manual nor connector:kind, or connector is not a connector key.
TOKEN_MISSING_ABILITY — token lacks project-resource:view-any.

get_resource
create_resource
request_resource_link
unlink_resource
list_connectors — each connector's resource_kinds, the values kind takes.
Resources API