import requests
url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/tools/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/tools/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/tools/ \
--header 'Authorization: Bearer <token>'{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": "4f4a0a36-2c3d-4e6c-9a3b-2b1f0f1a2c11",
"name": "Search financial chunks",
"description": "Semantic search over chunks tagged as financial reports.",
"tool_type": "retrieval",
"retrieval_mode": "semantic-chunks",
"category": "local",
"owner_project_id": "9c2b1c0a-7a1d-4d1d-8e3a-1d2b3c4d5e6f",
"owner_project_name": "Finance Analytics",
"readonly": false,
"created_at": "2026-04-12T10:21:33Z",
"updated_at": "2026-05-02T08:44:01Z"
},
{
"id": "c1a7f2e0-6e8f-4f0a-9d11-8b6e5d4c3b2a",
"name": "Document retrieval (annual reports)",
"description": "Retrieve documents by name or tag.",
"tool_type": "document_retrieval",
"retrieval_mode": "semantic-chunks",
"category": "imported",
"owner_project_id": "11111111-2222-3333-4444-555555555555",
"owner_project_name": "Shared Tools",
"readonly": true,
"created_at": "2026-03-08T15:02:11Z",
"updated_at": "2026-04-22T11:30:00Z"
}
]
}{
"error": "Authentication credentials were not provided."
}{
"error": "You do not have permission to perform this action."
}{
"error": "Not found."
}List tools
List all tools available to the project, including tools owned by the
project (category: local) and tools imported from other projects
(category: imported).
Use the returned id together with
getToolParameters to discover the
request body schema for a given tool, then call
runTool to execute it.
import requests
url = "https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/tools/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/tools/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url https://eu.app.clarifeye.ai/api/v1/projects/{project_id}/tools/ \
--header 'Authorization: Bearer <token>'{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": "4f4a0a36-2c3d-4e6c-9a3b-2b1f0f1a2c11",
"name": "Search financial chunks",
"description": "Semantic search over chunks tagged as financial reports.",
"tool_type": "retrieval",
"retrieval_mode": "semantic-chunks",
"category": "local",
"owner_project_id": "9c2b1c0a-7a1d-4d1d-8e3a-1d2b3c4d5e6f",
"owner_project_name": "Finance Analytics",
"readonly": false,
"created_at": "2026-04-12T10:21:33Z",
"updated_at": "2026-05-02T08:44:01Z"
},
{
"id": "c1a7f2e0-6e8f-4f0a-9d11-8b6e5d4c3b2a",
"name": "Document retrieval (annual reports)",
"description": "Retrieve documents by name or tag.",
"tool_type": "document_retrieval",
"retrieval_mode": "semantic-chunks",
"category": "imported",
"owner_project_id": "11111111-2222-3333-4444-555555555555",
"owner_project_name": "Shared Tools",
"readonly": true,
"created_at": "2026-03-08T15:02:11Z",
"updated_at": "2026-04-22T11:30:00Z"
}
]
}{
"error": "Authentication credentials were not provided."
}{
"error": "You do not have permission to perform this action."
}{
"error": "Not found."
}Authorizations
Use Authorization: Bearer <token>. The token is either a user token / OAuth access
token, or a service-account API key (cfk_...). A key is valid on every endpoint and
acts as its service account, an organization member with per-store permissions.
Refused keys answer 403 with Invalid API key., API key revoked.,
API key expired. or API key disabled..
Path Parameters
UUID of the project
Query Parameters
Filter by tool type
Category of tool, which controls how it is executed and what
parameters it accepts. The retrieval family additionally exposes a
retrieval_mode field (e.g. semantic-chunks, semantic-objects,
templated-query).
retrieval, math, document_retrieval, data_statistics, websearch, sub_agent Maximum number of results per page
1 <= x <= 1000Number of results to skip for pagination
x >= 0