List Tools

GET /v1/tools

Returns all published tools with their parameter schemas. Use this to discover available tools and their input requirements.

Example

curl https://api.vidocu.ai/v1/tools \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "tools": [
    {
      "type": "video-trimmer",
      "displayName": "Video Trimmer",
      "description": "Trim a video to a specific start and end time",
      "category": "video",
      "parameters": [
        {
          "name": "videoUrl",
          "type": "url",
          "label": "Video File",
          "description": "URL of the video to trim",
          "required": true,
          "defaultValue": null
        },
        {
          "name": "startTime",
          "type": "number",
          "label": "Start Time",
          "description": "Start time in seconds",
          "required": true,
          "defaultValue": null,
          "min": 0
        },
        {
          "name": "endTime",
          "type": "number",
          "label": "End Time",
          "description": "End time in seconds",
          "required": true,
          "defaultValue": null,
          "min": 0
        }
      ],
      "output": {
        "type": "file",
        "label": "Trimmed video",
        "mimeType": "video/mp4"
      },
      "apiSupported": true
    }
  ]
}

info

The tool list is generated from the live registry, so newly published tools appear here without an API release. Check apiSupported before calling Execute Tool. It's false only for tools that can't be reached at all right now - call those in the Vidocu app.

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key