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"
      }
    }
  ]
}

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key