---
title: "List Resource Tokens"
method: GET
path: "/api/v1/resource-tokens"
tags: ["resource-tokens"]
---

# List Resource Tokens

`GET /api/v1/resource-tokens`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/resource-tokens`
- Auth: none declared

List resource tokens with pagination (optionally filtered by resource_id).

Issue #242: Owner-only access.
Issue #264: Added pagination support.
Issue #59: Changed from APIKeyOrSessionUser to WorkspaceOwner.

Args:
    resource_id: Optional filter by resource_id
    limit: Number of tokens per page (1-100, default 50)
    offset: Starting offset (default 0)
    owner: Workspace owner (user_id, workspace_id) from dependency
    manager: ResourceTokenManager instance

Returns:
    Paginated response with tokens, total count, limit, and offset

## Query parameters

- `resource_id` string, nullable: Filter by resource_id
- `limit` integer: Number of tokens per page (max 100)
- `offset` integer: Starting offset for pagination

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- PaginatedResourceTokensResponse: Paginated response for resource tokens. Issue #264: Pagination support for large token lists.
  - `tokens` ResourceTokenResponse[], required: List of resource tokens
    - `id` unknown, required
    - `resource_id` unknown, required
    - `description` unknown
    - `quota_events_per_hour` unknown, required
    - `created_by` unknown
    - `created_at` unknown, required
    - `last_used_at` unknown
    - `is_active` unknown, required
    - `status` unknown, required
  - `total` integer, required: Total number of tokens matching filter
  - `limit` integer, required: Number of tokens per page
  - `offset` integer, required: Starting offset

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)
