GET /v1/agents/{id}

Obtener un agente

curl --request GET \
  --url https://api.keebai.com/v1/agents/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.keebai.com/v1/agents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.keebai.com/v1/agents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.keebai.com/v1/agents/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.keebai.com/v1/agents/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "agent": {
    "id": "<string>",
    "name": "<string>",
    "model": "<string>",
    "voice_response_enabled": true,
    "description": "<string>",
    "avatar_url": "<string>",
    "created_at": "<string>"
  }
}

GET

agents

{id}

Obtener un agente

curl --request GET \
  --url https://api.keebai.com/v1/agents/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.keebai.com/v1/agents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.keebai.com/v1/agents/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.keebai.com/v1/agents/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.keebai.com/v1/agents/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "agent": {
    "id": "<string>",
    "name": "<string>",
    "model": "<string>",
    "voice_response_enabled": true,
    "description": "<string>",
    "avatar_url": "<string>",
    "created_at": "<string>"
  }
}

Returns one agent with everything the list endpoint leaves out: its goal, the sections of its prompt with their text, the channels it answers on, the tools it may call and the knowledge nodes it can search. One call is enough. In the block model this replaced, the text lived somewhere else and reading a prompt took three calls; a section belongs to its agent, so it comes back here.

Endpoint

GET https://api.keebai.com/v1/agents/{id}

Required scope

agents:read

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer kbai_pk_<token>`

Path parameters

Parameter	Type	Description
`id`	`string`	`ObjectId` of the agent.

Example request

curl https://api.keebai.com/v1/agents/6650a1b2c3d4e5f6a7b8c9d0 \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const resp = await fetch(
  "https://api.keebai.com/v1/agents/6650a1b2c3d4e5f6a7b8c9d0",
  { headers: { Authorization: `Bearer ${process.env.KEEBAI_API_TOKEN}` } },
);
const { agent } = await resp.json();

import os, requests

resp = requests.get(
    "https://api.keebai.com/v1/agents/6650a1b2c3d4e5f6a7b8c9d0",
    headers={"Authorization": f"Bearer {os.environ['KEEBAI_API_TOKEN']}"},
    timeout=10,
)
resp.raise_for_status()
agent = resp.json()["agent"]

Response

200 OK

{
  "agent": {
    "_id": "6650a1b2c3d4e5f6a7b8c9d0",
    "name": "Recepción",
    "description": "Atiende reservas y consultas de horario",
    "model": "gpt-5",
    "language": "es-CL",
    "timezone": "America/Santiago",
    "goal": { "type": "appointment_management", "instructions": null },
    "prompts": [
      {
        "section": "business_context",
        "label": null,
        "markdown": "# Quiénes somos\n\nBarbería en Providencia."
      },
      {
        "section": "agent_limits",
        "label": null,
        "markdown": "Los precios los das del catálogo."
      }
    ],
    "channels": ["whatsapp"],
    "reengagement": { "enabled": true, "max_attempts": 2 },
    "tools": ["6650cccc3333dddd4444eeee"],
    "knowledge_node_ids": ["6650dddd4444eeee5555ffff"],
    "voice_response_enabled": false,
    "is_active": true,
    "created_at": "2026-07-20T14:02:11.870Z",
    "updated_at": "2026-08-14T18:21:04.112Z"
  }
}

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the agents:read scope.

404 Not Found

No agent with that id in the token’s company and project.

502 Bad Gateway

The agent service is unreachable.

Operational notes

prompts carries the text. What each section is for comes from the catalogue; the order is the order they take in the assembled prompt.
A section that was never written is absent, not empty. There is no placeholder row per section type.
goal.type decides which tools the agent can actually use, beyond the ids in tools. Changing it changes the agent’s capabilities, not just a label.
tools and knowledge_node_ids are ids into company-level collections. Deleting the agent leaves them alone.
This endpoint returns inactive agents too, unlike the list. is_active: false means the agent does not answer, but its configuration is intact.
404 covers the cross-project case. An agent that belongs to another project of the same company reads as not found, not as forbidden — the project of the token is part of its identity.
company, project, metadata and created_by are never returned. The first two are implied by the token, the third has no published schema, and the fourth is an internal user id.

Authorizations

Authorization

string

header

required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

string

required

Response

200 - application/json

agent

object

required

Show child attributes

Get started

Agents

Prompt sections

Section history

Tools

Reference

GET /v1/agents/{id}

Endpoint

Required scope

Headers

Path parameters

Example request

Response

200 OK

401 Unauthorized

403 Forbidden

404 Not Found

502 Bad Gateway

Operational notes

Authorizations

Path Parameters

Response

​Endpoint

​Required scope

​Headers

​Path parameters

​Example request

​Response

​200 OK

​401 Unauthorized

​403 Forbidden

​404 Not Found

​502 Bad Gateway

​Operational notes

Authorizations

Path Parameters

Response

Endpoint

Required scope

Headers

Path parameters

Example request

Response

200 OK

401 Unauthorized

403 Forbidden

404 Not Found

502 Bad Gateway

Operational notes