Skip to main content
GET
/
api
/
v1
/
tools
/
List Agent Tools
curl --request GET \
  --url https://api.ravan.ai/api/v1/tools/ \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Tools fetched successfully",
  "data": [
    {
      "id": "1a2b3c4d-1111-2222-3333-444455556666",
      "organizationId": "0b8e2f10-1234-4abc-9def-567890abcdef",
      "name": "book_appointment",
      "description": "Books an appointment in the connected calendar",
      "type": "custom",
      "definition": {
        "url": "https://example.com/book",
        "method": "POST",
        "parameters": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string"
            }
          }
        }
      },
      "isActive": true,
      "agentId": "9f1c2b3a-4d5e-6f70-8190-a1b2c3d4e5f6",
      "enabledFunctions": {
        "values": [
          "book",
          "reschedule"
        ]
      }
    }
  ],
  "meta": {
    "total": "5",
    "limit": 20,
    "offset": 0
  }
}

​
Authorizations

​
Authorization
string
required
Bearer JWT used to authenticate the request for the organization scope.

​
Query Parameters

​
limit
integer
Maximum number of records to return.
​
offset
integer
Number of records to skip before returning results.
​
agentId
string
Filter tools to one agent UUID. The API also accepts agent_id.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object[]
Returned tools.
​
meta
object
Pagination metadata.
{
  "success": true,
  "message": "Tools fetched successfully",
  "data": [
    {
      "id": "1a2b3c4d-1111-2222-3333-444455556666",
      "organizationId": "0b8e2f10-1234-4abc-9def-567890abcdef",
      "name": "book_appointment",
      "description": "Books an appointment in the connected calendar",
      "type": "custom",
      "definition": {
        "url": "https://example.com/book",
        "method": "POST",
        "parameters": {
          "type": "object",
          "properties": {
            "date": {
              "type": "string"
            }
          }
        }
      },
      "isActive": true,
      "agentId": "9f1c2b3a-4d5e-6f70-8190-a1b2c3d4e5f6",
      "enabledFunctions": {
        "values": [
          "book",
          "reschedule"
        ]
      }
    }
  ],
  "meta": {
    "total": "5",
    "limit": 20,
    "offset": 0
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer<int32>

Maximum number of records to return.

​
offset
integer<int32>

Number of records to skip before returning results.

​
agentId
string<uuid>

Filter tools to a single agent UUID.

​
agent_id
string<uuid>

Alias for agentId.

Response

Tools fetched successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Tools fetched successfully"

​
data
object[]
​
meta
object