For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList tools
      • POSTCreate tool
      • GETGet tool schemas
      • GETList built-in tools
      • GETList compatible built-in tools
      • GETGet built-in tool schema
      • GETGet tool details
      • PUTUpdate tool
      • DELDelete tool
Dashboard
LogoLogo
Runtype APITools

Update tool

PUT
/v1/tools/:id
PUT
/v1/tools/:id
$curl -X PUT https://api.runtype.com/v1/tools/id \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{}'
1{
2 "id": "a1b2c3d4-e5f6-7890-ab12-cdef34567890",
3 "name": "Content Summarizer",
4 "description": "A tool that generates concise summaries from long-form content using advanced NLP techniques.",
5 "toolType": "text-processing",
6 "isActive": true,
7 "createdAt": "2024-05-10T09:15:00Z",
8 "updatedAt": "2024-06-01T12:00:00Z",
9 "userId": "user_987654321",
10 "organizationId": "org_123456789",
11 "config": {},
12 "parametersSchema": {},
13 "validation": {
14 "warnings": [
15 {
16 "severity": "warning",
17 "code": "PARAM_SCHEMA_DEPRECATED",
18 "message": "The 'maxLength' parameter is deprecated and will be removed in future versions.",
19 "suggestion": "Remove 'maxLength' from the parameters schema to avoid future issues.",
20 "line": 12,
21 "column": 5
22 }
23 ]
24 }
25}
Update fields on an existing tool.
Was this page helpful?
Previous

Delete tool

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.
namestringOptional1-100 characters
descriptionstringOptional1-5000 characters
parametersSchemamap from strings to anyOptional
configmap from strings to anyOptional
isActivebooleanOptional

Response

Updated tool
idstring
namestring
descriptionstring or null
toolTypestring
isActiveboolean
createdAtstring
updatedAtstring
userIdstring
organizationIdstring or null
configmap from strings to any or null
parametersSchemamap from strings to any
validationobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error