Get Assistant API

Overview

The Get Assistant endpoint retrieves a single assistant by its unique ID. It's a simple GET request that returns the assistant's full configuration object.

This is the missing Get/Read counterpart to the Assistant Delete & Update (PATCH) API — together the three endpoints cover reading, partially updating, and removing an assistant.

GET https://api.sulus.ai/assistant/{id}

You can authenticate with a private API key from your account, or with a JWT if you have JWT-based authentication configured — either is passed the same way in the Authorization header.

curl -X GET https://api.sulus.ai/assistant/{id} \
  -H "Authorization: Bearer <your-api-key>"

Or using JavaScript's fetch:

const response = await fetch("https://api.sulus.ai/assistant/<id>", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const assistant = await response.json();
console.log(assistant);

A successful request returns HTTP 200 with the full Assistant object as JSON — the same shape you'd get back from creating or updating the assistant, including its model, voice, transcriber, tools, and hooks configuration.