Get tool

Retrieve a specific tool for an assistant.

Request

GET https://superinterface.ai/api/cloud/assistants/{assistantId}/tools/{toolId}

Authentication

Include your private API key in the request headers:

Authorization: Bearer YOUR_PRIVATE_API_KEY

Path Parameters

Parameter	Type	Description
`assistantId`	string	The ID of the assistant
`toolId`	string	The ID of the tool

Example request

curl -X GET "https://superinterface.ai/api/cloud/assistants/00cfe680-fee5-49b9-b386-6a7097eb8497/tools/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \ -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \ -H "Content-Type: application/json"

Response

Parameter	Type	Description
`tool`	`Tool`	Existing tool

Example response

{ "tool": { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "type": "COMPUTER_USE", "computerUseTool": { "displayWidth": 1280, "displayHeight": 720, "environment": "LINUX", "mcpServerId": null }, "createdAt": "2024-01-15T10:30:00Z", "updatedAt": "2024-01-15T10:30:00Z" } }

Errors

The endpoint may return the following errors:

401 Unauthorized

This error occurs if the API key is invalid or missing.

{ "error": "Unauthorized", "message": "Invalid or missing API key" }