List tools | Runtype Documentation

curl https://api.runtype.com/v1/tools \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
      "name": "Content Generator",
      "description": "AI-powered tool for generating marketing content",
      "toolType": "text-generation",
      "isActive": true,
      "createdAt": "2024-05-10T09:15:00Z",
      "updatedAt": "2024-06-01T12:00:00Z",
      "parametersSchema": {
        "maxTokens": 500,
        "temperature": 0.7,
        "language": "en"
      }
    }
  ],
  "pagination": {
    "nextCursor": "cursor_12345",
    "prevCursor": "cursor_12343",
    "hasMore": true,
    "hasPrev": true,
    "limit": 10,
    "currentOffset": 10,
    "totalPages": 5,
    "currentPage": 2,
    "totalCount": 45
  }
}

Get all tools for the authenticated user with filtering and cursor pagination.

Authentication

AuthorizationBearer

API key or Clerk session token

Query parameters

limitstringOptional

cursorstringOptional

directionstringOptional

includeCountstringOptional

distinctstringOptional

tool_typestringOptional

searchstringOptional

isActivestringOptional

idsstringOptional

includestringOptional

Response

Paginated list of tools

datalist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/tools \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

1	{
2	"data": [
3	{
4	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
5	"name": "Content Generator",
6	"description": "AI-powered tool for generating marketing content",
7	"toolType": "text-generation",
8	"isActive": true,
9	"createdAt": "2024-05-10T09:15:00Z",
10	"updatedAt": "2024-06-01T12:00:00Z",
11	"parametersSchema": {
12	"maxTokens": 500,
13	"temperature": 0.7,
14	"language": "en"
15	}
16	}
17	],
18	"pagination": {
19	"nextCursor": "cursor_12345",
20	"prevCursor": "cursor_12343",
21	"hasMore": true,
22	"hasPrev": true,
23	"limit": 10,
24	"currentOffset": 10,
25	"totalPages": 5,
26	"currentPage": 2,
27	"totalCount": 45
28	}
29	}