List & Get Tools

List tools

GET/v2.0/tools

Returns the organization’s tools, newest-updated first, with pagination.

Query parameters

ParameterTypeDescription
toolTypestringFilter by type (function, static_tool, media_attachments, message_templates, instagram_templates, messenger_templates, sendiee_catalog, shopify).
isActivebooleanFilter by enabled state: true or false.
tagstringFilter by a ToolTag id.
namestringCase-insensitive substring match on the tool name.
pagenumber1-based page number.Default: 1
limitnumberPage size, 1–100.Default: 20
cURL
curl "https://api.sendiee.com/v2.0/tools?toolType=function&isActive=true&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "success": true,
  "data": [
    {
      "toolId": "V1StGXR8Z5jdHi",
      "_id": "663b1f9c2a1f4e0012ab34cd",
      "name": "get_order_status",
      "description": "Look up the delivery status of an order.",
      "toolType": "function",
      "isActive": true,
      "serverUrl": "https://api.yourstore.com/orders/{{order_id}}",
      "requestMethod": "GET",
      "auth": {
        "type": "bearer",
        "token": "••••••"
      },
      "parameters": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string"
          }
        },
        "required": [
          "order_id"
        ]
      },
      "tags": [],
      "createdAt": "2026-05-30T10:00:00.000Z",
      "updatedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1,
    "hasMore": false
  }
}

Get a tool

GET/v2.0/tools/:toolId

Fetch a single tool by its public toolId. Secrets are masked.

cURL
curl https://api.sendiee.com/v2.0/tools/V1StGXR8Z5jdHi \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "error": true,
  "code": "TOOL_NOT_FOUND",
  "message": "Tool not found"
}