Skip to main content
PATCH
/
v1
/
tool-servers
/
{toolServerId}
Update tool server
curl --request PATCH \
  --url https://api.devic.ai/v1/tool-servers/{toolServerId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "url": "<string>",
  "enabled": true,
  "mcpServerProperties": {
    "mode": "public",
    "slug": "<string>",
    "status": "active"
  },
  "authenticationConfig": {
    "authenticationMethod": "jwt",
    "jwt": {
      "token": "<string>"
    },
    "basic": {
      "username": "<string>",
      "password": "<string>"
    },
    "oauth2": {
      "refreshToken": "<string>",
      "clientId": "<string>",
      "clientSecret": "<string>",
      "refreshTokenEndpoint": "<string>",
      "grant_type": "refresh_token",
      "scope": "<string>",
      "requestFormat": "json"
    },
    "customHeader": {
      "headerName": "<string>",
      "value": "<string>"
    }
  },
  "imageUrl": "<string>",
  "toolDefinitions": [
    {
      "function": {
        "name": "<string>",
        "description": "<string>",
        "strict": true,
        "parameters": {
          "type": "<string>",
          "properties": {},
          "required": [
            "<string>"
          ],
          "additionalProperties": true
        }
      },
      "type": "function",
      "endpoint": "<string>",
      "method": "GET",
      "queryParametersKeys": [
        "<string>"
      ],
      "pathParametersKeys": [
        "<string>"
      ],
      "bodyPropertyKey": "<string>",
      "customHeaders": [
        {
          "headerName": "<string>",
          "value": "<string>"
        }
      ],
      "isFormDataBody": true,
      "bodyMode": "simple",
      "bodyJsonTemplate": "<string>",
      "responsePostProcessingEnabled": true,
      "responsePostProcessingTemplate": "<string>"
    }
  ]
}
'
{
  "_id": "<string>",
  "clientUID": "<string>",
  "enabled": true,
  "url": "<string>",
  "identifier": "<string>",
  "name": "<string>",
  "description": "<string>",
  "mcpType": true,
  "mcpServerProperties": {
    "mode": "public",
    "slug": "<string>",
    "status": "active"
  },
  "toolServerDefinitionId": "<string>",
  "imageUrl": "<string>",
  "creartionTimestampMs": 123,
  "lastEditTimestampMS": 123,
  "toolServerDefinition": {
    "_id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "toolDefinitions": [
      {
        "function": {
          "name": "<string>",
          "description": "<string>",
          "strict": true,
          "parameters": {
            "type": "<string>",
            "properties": {},
            "required": [
              "<string>"
            ],
            "additionalProperties": true
          }
        },
        "type": "function",
        "endpoint": "<string>",
        "method": "GET",
        "queryParametersKeys": [
          "<string>"
        ],
        "pathParametersKeys": [
          "<string>"
        ],
        "bodyPropertyKey": "<string>",
        "customHeaders": [
          {
            "headerName": "<string>",
            "value": "<string>"
          }
        ],
        "isFormDataBody": true,
        "bodyMode": "simple",
        "bodyJsonTemplate": "<string>",
        "responsePostProcessingEnabled": true,
        "responsePostProcessingTemplate": "<string>"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Use JWT token for authentication

Path Parameters

toolServerId
string
required

The unique identifier of the tool server

Body

application/json
name
string

Tool server name

description
string

Tool server description

url
string

Base URL for the tool server API

enabled
boolean

Whether the tool server is enabled

mcpServerProperties
object
authenticationConfig
object
imageUrl
string

Image URL for the tool server

toolDefinitions
object[]

Array of tool definitions

Response

Tool server updated successfully

_id
string

Tool server ID

clientUID
string

Client UID

enabled
boolean

Whether the tool server is enabled

url
string

Base URL

identifier
string

Tool server identifier

name
string

Tool server name

description
string

Tool server description

mcpType
boolean

Whether this is an MCP type server

mcpServerProperties
object
toolServerDefinitionId
string

Tool server definition ID

imageUrl
string

Image URL

creartionTimestampMs
integer

Creation timestamp in milliseconds

lastEditTimestampMS
integer

Last edit timestamp in milliseconds

toolServerDefinition
object