Logo
Search
Docs

Get tool assistants

GET https://app.sulus.ai/api/tools/{id}/assistants

List the caller's assistants with an attached flag for this tool

Authentication

Send a bearer token created on your dashboard's Developer page:

Authorization: Bearer <YOUR_API_KEY>

Path parameters

id string Required

The tool's public id.

Validation: the tool's external_tool_id (UUID, or draft_… slug for drafts)
Stored in tools.external_tool_id

Errors

StatusMeaningBody
404 Tool not found, or outside your account scope {"success":false,"message":"Tool not found"}
401 Missing or invalid bearer token
403 Feature tools not enabled for the account

Notes

  • Each row uses assistant_id (the assistant's public UUID). This assignment endpoint returns that key specifically.
  • attached reflects whether this tool's external_tool_id is currently present in the assistant's tool list.
  • Super admins see every assistant; other roles see only their own content-protected assistants.
curl --request GET \
  --url https://app.sulus.ai/api/tools/{id}/assistants \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
import requests

url = "https://app.sulus.ai/api/tools/{id}/assistants"
headers = {"Authorization": "Bearer <YOUR_API_KEY>"}

response = requests.get(url, headers=headers)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	url := "https://app.sulus.ai/api/tools/{id}/assistants"
	req, _ := http.NewRequest("GET", url, nil)
	req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
Response 200 
{
    "success": true,
    "data": [
        {
            "assistant_id": "a1b2c3d4-1e2f-4a3b-8c9d-0e1f2a3b4c5d",
            "name": "Front Desk",
            "attached": true
        },
        {
            "assistant_id": "b2c3d4e5-2f3a-4b4c-9d0e-1f2a3b4c5d6e",
            "name": "After Hours",
            "attached": false
        }
    ]
}