Troubleshooting

API

Markdown

For a complete list of error codes and their meanings, see Errors Reference.

Reporting API issues

When reporting API issues to support, provide the following:

  • cURL command: Include the exact cURL to reproduce the issue

  • Request ID: Add x-request-id: <uuid> header to your request and share the UUID (generate at uuidgenerator.net)

    curl 'https://backend.composio.dev/api/v3/tools' \
      -H 'x-api-key: YOUR_API_KEY' \
      -H 'x-request-id: YOUR_UUID_HERE'
  • Error details: Share the complete error message. For example:

    {
      "error": {
        "message": "Validation error while processing request",
        "error_code": 10400,
        "suggested_fix": "Please check the payload.",
        "errors": [
          "Error in payload.text.arguments: Only one of 'text' or 'arguments' must be provided"
        ]
      }
    }
  • Reproduction steps: Include any steps needed to reproduce the issue

Getting help