AI assistants

An assistant is an Orbit AI agent: a named system prompt, model, and tool set that you bind to a channel when you deploy it. This page is the worked reference for the assistant lifecycle — create, list, fetch, update, deploy, undeploy, and delete — with one assistant_id carried across the whole sequence. Field-level reference lives in the Agents API; this page walks the sequence end to end. Base path: /api/v1/agents Authentication: API key (X-API-Key) or session JWT. Create, update, deploy, undeploy, and delete require an owner, admin, or developer role; list and fetch are open to any authenticated role. Every response below carries the full { data, meta } envelope — meta.request_id and meta.timestamp on the success path, a labelled error envelope on the failure path — the same floor as SDK sample coverage policy.

Using the SDKs

The assistant lifecycle has no typed helpers yet, so the Node.js samples on this page route through the generic orbit.request() escape hatch — auth, retries, and the { data, meta } envelope stay identical to the typed client:

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY! });

// every sample below uses this generic request() form
const { data } = await orbit.request<unknown>("GET", "/agents", undefined);

Python samples use plain requests, and Go, Ruby, and PHP use the plain standard-library HTTP form — deliberately dependency-free per the SDK language policy and Writing compliant API samples. Full SDK index at SDK quickstart.

Lifecycle worked sequence

Create the assistant once, reuse its assistant_id for everything afterward. Nothing seeds channel binding on create — the agent lands as a draft, and deploy flips it active.

1. Create the assistant

curl -X POST "https://api.orbit.devotel.io/api/v1/agents" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order support assistant",
    "type": "chatbot",
    "model": "claude-sonnet-4-6",
    "system_prompt": "You answer order-status questions for Acme Kitchens. Cite the order id in every reply.",
    "tools": [
      {
        "name": "lookup_order",
        "description": "Fetch one order by id",
        "parameters": {
          "type": "object",
          "properties": { "order_id": { "type": "string" } },
          "required": ["order_id"]
        }
      }
    ],
    "safety_config": { "pii_redaction": true, "content_filter": true }
  }'

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY });

const created = await orbit.request("POST", "/agents", {
  name: "Order support assistant",
  type: "chatbot",
  model: "claude-sonnet-4-6",
  system_prompt:
    "You answer order-status questions for Acme Kitchens. Cite the order id in every reply.",
  tools: [
    {
      name: "lookup_order",
      description: "Fetch one order by id",
      parameters: {
        type: "object",
        properties: { order_id: { type: "string" } },
        required: ["order_id"],
      },
    },
  ],
  safety_config: { pii_redaction: true, content_filter: true },
});

const assistantId = created.data.id;

import os
import requests

headers = {
    "X-API-Key": os.environ["ORBIT_API_KEY"],
    "Content-Type": "application/json",
}

body = {
    "name": "Order support assistant",
    "type": "chatbot",
    "model": "claude-sonnet-4-6",
    "system_prompt": "You answer order-status questions for Acme Kitchens. Cite the order id in every reply.",
    "tools": [
        {
            "name": "lookup_order",
            "description": "Fetch one order by id",
            "parameters": {
                "type": "object",
                "properties": {"order_id": {"type": "string"}},
                "required": ["order_id"],
            },
        }
    ],
    "safety_config": {"pii_redaction": True, "content_filter": True},
}

res = requests.post(
    "https://api.orbit.devotel.io/api/v1/agents",
    headers=headers,
    json=body,
)
assistant_id = res.json()["data"]["id"]

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "name": "Order support assistant",
	  "type": "chatbot",
	  "model": "claude-sonnet-4-6",
	  "system_prompt": "You answer order-status questions for Acme Kitchens. Cite the order id in every reply.",
	  "tools": [{
	    "name": "lookup_order",
	    "description": "Fetch one order by id",
	    "parameters": {
	      "type": "object",
	      "properties": { "order_id": { "type": "string" } },
	      "required": ["order_id"]
	    }
	  }],
	  "safety_config": { "pii_redaction": true, "content_filter": true }
	}`)
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/agents", bytes.NewReader(body))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	var out struct {
		Data struct {
			ID string `json:"id"`
		} `json:"data"`
	}
	json.NewDecoder(res.Body).Decode(&out)
	// out.Data.ID is the assistant_id reused below
}

require "net/http"
require "json"

uri = URI("https://api.orbit.devotel.io/api/v1/agents")
req = Net::HTTP::Post.new(uri)
req["X-API-Key"] = ENV["ORBIT_API_KEY"]
req["Content-Type"] = "application/json"
req.body = JSON.dump(
  name: "Order support assistant",
  type: "chatbot",
  model: "claude-sonnet-4-6",
  system_prompt: "You answer order-status questions for Acme Kitchens. Cite the order id in every reply.",
  tools: [{
    name: "lookup_order",
    description: "Fetch one order by id",
    parameters: {
      type: "object",
      properties: { order_id: { type: "string" } },
      required: ["order_id"]
    }
  }],
  safety_config: { pii_redaction: true, content_filter: true }
)
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
assistant_id = JSON.parse(res.body).dig("data", "id")

<?php
$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents");
$body = json_encode([
  "name" => "Order support assistant",
  "type" => "chatbot",
  "model" => "claude-sonnet-4-6",
  "system_prompt" => "You answer order-status questions for Acme Kitchens. Cite the order id in every reply.",
  "tools" => [[
    "name" => "lookup_order",
    "description" => "Fetch one order by id",
    "parameters" => [
      "type" => "object",
      "properties" => ["order_id" => ["type" => "string"]],
      "required" => ["order_id"],
    ],
  ]],
  "safety_config" => ["pii_redaction" => true, "content_filter" => true],
]);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => $body,
  CURLOPT_HTTPHEADER => [
    "X-API-Key: " . getenv("ORBIT_API_KEY"),
    "Content-Type: application/json",
  ],
]);
$res = json_decode(curl_exec($ch), true);
$assistantId = $res["data"]["id"];
?>

Response 201:

{
  "data": {
    "id": "agt_8f2e41abcc9d70",
    "name": "Order support assistant",
    "type": "chatbot",
    "model": "claude-sonnet-4-6",
    "status": "draft",
    "created_at": "2026-09-15T13:11:02.418Z"
  },
  "meta": {
    "request_id": "req_agc_9d31ef2",
    "timestamp": "2026-09-15T13:11:02.418Z"
  }
}

Carry the returned assistant_id (agt_8f2e41abcc9d70) through the rest of this page — it is the same id you pass to fetch, update, deploy, undeploy, and delete.

2. Deploy the assistant to a channel

deploy binds a channel and moves the assistant out of draft into active. The channel name is one of webhook, sms, whatsapp, voice, or rcs; webhook_url is required only for webhook channels, and a phone_number is required only for SMS / WhatsApp / voice.

curl -X POST "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/deploy" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "channel": "sms", "phone_number": "+14155550100" }'

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY });

const deployed = await orbit.request("POST", "/agents/agt_8f2e41abcc9d70/deploy", {
  channel: "sms",
  phone_number: "+14155550100",
});

import os
import requests

headers = {
    "X-API-Key": os.environ["ORBIT_API_KEY"],
    "Content-Type": "application/json",
}

res = requests.post(
    "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/deploy",
    headers=headers,
    json={"channel": "sms", "phone_number": "+14155550100"},
)
status = res.json()["data"]["status"]  # "active"

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{ "channel": "sms", "phone_number": "+14155550100" }`)
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/deploy", bytes.NewReader(body))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	var out struct {
		Data struct {
			Status string `json:"status"`
		} `json:"data"`
	}
	json.NewDecoder(res.Body).Decode(&out)
	// out.Data.Status == "active"
}

require "net/http"
require "json"

uri = URI("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/deploy")
req = Net::HTTP::Post.new(uri)
req["X-API-Key"] = ENV["ORBIT_API_KEY"]
req["Content-Type"] = "application/json"
req.body = JSON.dump(channel: "sms", phone_number: "+14155550100")
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
status = JSON.parse(res.body).dig("data", "status") # "active"

<?php
$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/deploy");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode(["channel" => "sms", "phone_number" => "+14155550100"]),
  CURLOPT_HTTPHEADER => [
    "X-API-Key: " . getenv("ORBIT_API_KEY"),
    "Content-Type: application/json",
  ],
]);
$res = json_decode(curl_exec($ch), true);
$status = $res["data"]["status"]; // "active"
?>

Response 200 — status is active and config.deployment carries the channel binding:

{
  "data": {
    "id": "agt_8f2e41abcc9d70",
    "status": "active",
    "config": {
      "deployment": {
        "channel": "sms",
        "phone_number": "+14155550100",
        "deployed_at": "2026-09-15T13:14:50.117Z"
      }
    }
  },
  "meta": {
    "request_id": "req_dpl_77a1b2",
    "timestamp": "2026-09-15T13:14:50.117Z"
  }
}

3. List to confirm the assistant is live

curl "https://api.orbit.devotel.io/api/v1/agents?status=active&limit=1" \
  -H "X-API-Key: dv_live_sk_your_key_here"

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY });

const list = await orbit.request("GET", "/agents?status=active&limit=1", undefined);

import os
import requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}

res = requests.get(
    "https://api.orbit.devotel.io/api/v1/agents?status=active&limit=1",
    headers=headers,
)
assistants = res.json()["data"]

package main

import (
	"encoding/json"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/agents?status=active&limit=1", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	var out struct {
		Data []struct {
			ID     string `json:"id"`
			Status string `json:"status"`
		} `json:"data"`
	}
	json.NewDecoder(res.Body).Decode(&out)
}

require "net/http"
require "json"

uri = URI("https://api.orbit.devotel.io/api/v1/agents?status=active&limit=1")
req = Net::HTTP::Get.new(uri)
req["X-API-Key"] = ENV["ORBIT_API_KEY"]
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
assistant = JSON.parse(res.body)["data"].first

<?php
$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents?status=active&limit=1");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("ORBIT_API_KEY")],
]);
$res = json_decode(curl_exec($ch), true);
$assistant = $res["data"][0];
?>

Response 200 — the envelope’s meta.pagination carries the cursor and has_more pair you use to walk the full list:

{
  "data": [
    {
      "id": "agt_8f2e41abcc9d70",
      "name": "Order support assistant",
      "type": "chatbot",
      "model": "claude-sonnet-4-6",
      "status": "active",
      "created_at": "2026-09-15T13:11:02.418Z",
      "active_conversations": 1,
      "conversation_count": 4,
      "total_tokens": 981,
      "version": 1
    }
  ],
  "meta": {
    "request_id": "req_agl_201d88x",
    "timestamp": "2026-09-15T13:16:22.044Z",
    "pagination": {
      "cursor": "2026-09-15T13:11:02.418Z|agt_8f2e41abcc9d70",
      "has_more": false,
      "total": 1
    }
  }
}

4. Fetch one assistant by id

curl "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70" \
  -H "X-API-Key: dv_live_sk_your_key_here"

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY });

const assistant = await orbit.request("GET", "/agents/agt_8f2e41abcc9d70", undefined);

import os
import requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}

res = requests.get(
    "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70",
    headers=headers,
)
assistant = res.json()["data"]

package main

import (
	"encoding/json"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	var out struct {
		Data struct {
			ID     string `json:"id"`
			Status string `json:"status"`
		} `json:"data"`
	}
	json.NewDecoder(res.Body).Decode(&out)
}

require "net/http"
require "json"

uri = URI("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70")
req = Net::HTTP::Get.new(uri)
req["X-API-Key"] = ENV["ORBIT_API_KEY"]
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
assistant = JSON.parse(res.body)["data"]

<?php
$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("ORBIT_API_KEY")],
]);
$res = json_decode(curl_exec($ch), true);
$assistant = $res["data"];
?>

The same { data, meta } envelope as the list, without pagination. Use this form when you already know the id — there is no separate “assistant detail” resource.

5. Update the system prompt, tools, or safety config in place

PATCH rewrites only the fields you send. Bump the prompt or safety configuration without redeploying.

curl -X PATCH "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70" \
  -H "X-API-Key: dv_live_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "system_prompt": "You answer order-status questions for Acme Kitchens. Cite the order id in every reply, and link the tracking URL from the order record." }'

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY });

const updated = await orbit.request("PATCH", "/agents/agt_8f2e41abcc9d70", {
  system_prompt:
    "You answer order-status questions for Acme Kitchens. Cite the order id in every reply, and link the tracking URL from the order record.",
});

import os
import requests

headers = {
    "X-API-Key": os.environ["ORBIT_API_KEY"],
    "Content-Type": "application/json",
}

res = requests.patch(
    "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70",
    headers=headers,
    json={
        "system_prompt": "You answer order-status questions for Acme Kitchens. Cite the order id in every reply, and link the tracking URL from the order record."
    },
)
version = res.json()["data"]["version"]  # 2

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{ "system_prompt": "You answer order-status questions for Acme Kitchens. Cite the order id in every reply, and link the tracking URL from the order record." }`)
	req, _ := http.NewRequest("PATCH", "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70", bytes.NewReader(body))
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	var out struct {
		Data struct {
			Version int `json:"version"`
		} `json:"data"`
	}
	json.NewDecoder(res.Body).Decode(&out)
	// out.Data.Version == 2
}

require "net/http"
require "json"

uri = URI("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70")
req = Net::HTTP::Patch.new(uri)
req["X-API-Key"] = ENV["ORBIT_API_KEY"]
req["Content-Type"] = "application/json"
req.body = JSON.dump(
  system_prompt: "You answer order-status questions for Acme Kitchens. Cite the order id in every reply, and link the tracking URL from the order record."
)
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
version = JSON.parse(res.body).dig("data", "version") # 2

<?php
$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70");
$body = json_encode([
  "system_prompt" => "You answer order-status questions for Acme Kitchens. Cite the order id in every reply, and link the tracking URL from the order record.",
]);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => $body,
  CURLOPT_HTTPHEADER => [
    "X-API-Key: " . getenv("ORBIT_API_KEY"),
    "Content-Type: application/json",
  ],
]);
$res = json_decode(curl_exec($ch), true);
$version = $res["data"]["version"]; // 2
?>

Response 200:

{
  "data": {
    "id": "agt_8f2e41abcc9d70",
    "version": 2,
    "updated_at": "2026-09-15T13:24:18.508Z"
  },
  "meta": {
    "request_id": "req_agp_31ed47c",
    "timestamp": "2026-09-15T13:24:18.508Z"
  }
}

6. Undeploy, then delete

undeploy drops the channel binding and flips status back to draft. Delete the assistant only when it is no longer needed — conversation history stays on the tenant.

curl -X POST "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/undeploy" \
  -H "X-API-Key: dv_live_sk_your_key_here"

curl -X DELETE "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70" \
  -H "X-API-Key: dv_live_sk_your_key_here"

import { Orbit } from "@devotel-orbit/node";

const orbit = new Orbit({ apiKey: process.env.ORBIT_API_KEY });

await orbit.request("POST", "/agents/agt_8f2e41abcc9d70/undeploy", undefined);
await orbit.request("DELETE", "/agents/agt_8f2e41abcc9d70", undefined);

import os
import requests

headers = {"X-API-Key": os.environ["ORBIT_API_KEY"]}

requests.post(
    "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/undeploy",
    headers=headers,
)
requests.delete(
    "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70",
    headers=headers,
)

package main

import (
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/undeploy", nil)
	req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	res, _ := http.DefaultClient.Do(req)
	res.Body.Close()

	req2, _ := http.NewRequest("DELETE", "https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70", nil)
	req2.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
	res2, _ := http.DefaultClient.Do(req2)
	defer res2.Body.Close()
}

require "net/http"

uri = URI("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/undeploy")
req = Net::HTTP::Post.new(uri)
req["X-API-Key"] = ENV["ORBIT_API_KEY"]
Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }

uri2 = URI("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70")
req2 = Net::HTTP::Delete.new(uri2)
req2["X-API-Key"] = ENV["ORBIT_API_KEY"]
Net::HTTP.start(uri2.hostname, uri2.port, use_ssl: true) { |h| h.request(req2) }

<?php
$headers = ["X-API-Key: " . getenv("ORBIT_API_KEY")];

$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70/undeploy");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => $headers,
]);
curl_exec($ch);

$ch = curl_init("https://api.orbit.devotel.io/api/v1/agents/agt_8f2e41abcc9d70");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => $headers,
]);
curl_exec($ch); // 204 No Content
?>

Undeploy returns 200 with the same envelope. Delete returns 204 No Content with an empty body.

Error envelopes

An unknown id — whether passed to fetch, update, deploy, undeploy, or delete — answers 404 with a labelled error envelope, not a bare status:

404 Error

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Assistant agt_8f2e41abcc9d70 was not found in this organization.",
    "status": 404
  },
  "meta": {
    "request_id": "req_age_41d0b8",
    "timestamp": "2026-09-15T13:30:02.447Z"
  }
}

Validation failures on create come back as 422 VALIDATION_ERROR — one entry per field, with the same meta block. A cross-tenant id returns the same 404 NOT_FOUND as one that never existed, so existence cannot be probed across organizations. If you receive a 403 INSUFFICIENT_PERMISSIONS, the caller’s role is below developer; only owner, admin, and developer may write assistants.

Language coverage per the SDK sample policy

Every operation on this page shows the compliant six-form block — cURL, Node.js (TypeScript), Python, Go, Ruby, and PHP inside one <CodeGroup> — the same per-operation floor the SDK sample coverage policy sets and Writing compliant API samples operationalizes. Node.js runs the orbit.request() escape hatch; Python uses plain requests; Go, Ruby, and PHP use the plain standard-library HTTP forms, so no sample depends on a typed helper that may not exist yet. For routes outside this lifecycle — or when the anchor id you need is outside the worked sequence — each public SDK still ships an untyped request method that reaches any endpoint. The route shape above applies verbatim; the per-language escape-hatch names (client.request in Java and Ruby, client.RequestAsync in C#, $client->request in PHP) are catalogued in the SDK language policy escape-hatch table. See also Agents API for the full field catalogue and Agent templates for the pre-built-into-assistant flow.

API Reference

All Endpoints

AI assistants: create, deploy, and run the lifecycle

AI assistants

Using the SDKs

Lifecycle worked sequence

1. Create the assistant

2. Deploy the assistant to a channel

3. List to confirm the assistant is live

4. Fetch one assistant by id

5. Update the system prompt, tools, or safety config in place

6. Undeploy, then delete

Error envelopes

Language coverage per the SDK sample policy

​AI assistants

​Using the SDKs

​Lifecycle worked sequence

​1. Create the assistant

​2. Deploy the assistant to a channel

​3. List to confirm the assistant is live

​4. Fetch one assistant by id

​5. Update the system prompt, tools, or safety config in place

​6. Undeploy, then delete

​Error envelopes

​Language coverage per the SDK sample policy

AI assistants

Using the SDKs

Lifecycle worked sequence

1. Create the assistant

2. Deploy the assistant to a channel

3. List to confirm the assistant is live

4. Fetch one assistant by id

5. Update the system prompt, tools, or safety config in place

6. Undeploy, then delete

Error envelopes

Language coverage per the SDK sample policy