Skip to content
Letta Platform Letta Platform Letta Docs
Sign up

List Tags

client.tags.list(TagListParams { after, before, limit, 4 more } query?, RequestOptionsoptions?): TagListResponse
get/v1/tags/

Get the list of all tags (from agents and blocks) that have been created.

ParametersExpand Collapse
query: TagListParams { after, before, limit, 4 more }
after?: string | null

Tag cursor for pagination. Returns tags that come after this tag in the specified sort order

before?: string | null

Tag cursor for pagination. Returns tags that come before this tag in the specified sort order

limit?: number | null

Maximum number of tags to return

name?: string | null

Filter tags by name

order?: "asc" | "desc"

Sort order for tags. 'asc' for alphabetical order, 'desc' for reverse alphabetical order

Accepts one of the following:
"asc"
"desc"
order_by?: "name"

Field to sort by

Deprecatedquery_text?: string | null

Filter tags by text search. Deprecated, please use name field instead

ReturnsExpand Collapse
TagListResponse = Array<string>
List Tags
import Letta from '@letta-ai/letta-client';

const client = new Letta({
  apiKey: process.env['LETTA_API_KEY'], // This is the default and can be omitted
});

const tags = await client.tags.list();

console.log(tags);
[
  "string"
]
Returns Examples
[
  "string"
]