List tools | Runtype Documentation

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

{
  "data": [
    {
      "createdAt": "2024-06-10T09:15:00Z",
      "description": "A tool for automating AI model training workflows.",
      "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
      "isActive": true,
      "name": "AI Trainer Pro",
      "toolType": "automation",
      "updatedAt": "2024-06-15T12:00:00Z",
      "parametersSchema": {
        "learningRate": {
          "type": "number",
          "default": 0.01
        },
        "batchSize": {
          "type": "integer",
          "default": 32
        }
      }
    }
  ],
  "pagination": {
    "currentOffset": 0,
    "hasMore": true,
    "hasPrev": false,
    "limit": 10,
    "nextCursor": "cursor_12345",
    "prevCursor": null,
    "currentPage": 1,
    "totalCount": 25,
    "totalPages": 3
  }
}

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: <apiKey>" \
>	-H "Content-Type: application/json"

1	{
2	"data": [
3	{
4	"createdAt": "2024-06-10T09:15:00Z",
5	"description": "A tool for automating AI model training workflows.",
6	"id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
7	"isActive": true,
8	"name": "AI Trainer Pro",
9	"toolType": "automation",
10	"updatedAt": "2024-06-15T12:00:00Z",
11	"parametersSchema": {
12	"learningRate": {
13	"type": "number",
14	"default": 0.01
15	},
16	"batchSize": {
17	"type": "integer",
18	"default": 32
19	}
20	}
21	}
22	],
23	"pagination": {
24	"currentOffset": 0,
25	"hasMore": true,
26	"hasPrev": false,
27	"limit": 10,
28	"nextCursor": "cursor_12345",
29	"prevCursor": null,
30	"currentPage": 1,
31	"totalCount": 25,
32	"totalPages": 3
33	}
34	}