Get agent by ID
curl --request GET \
--url https://api.devic.ai/v1/agents/{agentId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.devic.ai/v1/agents/{agentId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.devic.ai/v1/agents/{agentId}', 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.devic.ai/v1/agents/{agentId}",
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.devic.ai/v1/agents/{agentId}"
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))
}HttpResponse<String> response = Unirest.get("https://api.devic.ai/v1/agents/{agentId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.devic.ai/v1/agents/{agentId}")
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{
"_id": "<string>",
"name": "<string>",
"description": "<string>",
"imgUrl": "<string>",
"disabled": true,
"archived": true,
"provider": "<string>",
"llm": "<string>",
"assistantSpecialization": {
"identifier": "<string>",
"name": "<string>",
"description": "<string>",
"presets": "<string>",
"availableToolsGroupsUids": [
"<string>"
],
"enabledTools": [
"<string>"
],
"model": "<string>",
"provider": "<string>",
"imgUrl": "<string>",
"codeSnippetIds": [
"<string>"
],
"availableSkillIds": [
"<string>"
],
"subagentsIds": [
"<string>"
],
"maxChatMessages": 123,
"maxToolResponseInputTokens": 123,
"contextManagement": {
"fullContextTurnDepth": 123,
"alwaysIncludeUserMessages": true
}
},
"creationTimestampMs": 123,
"lastEditTimestampMs": 123,
"maxExecutionInputTokens": 123,
"maxExecutionToolCalls": 123,
"agentNotificationConfig": {},
"evaluationConfig": {}
}Agents
Get agent by ID
Retrieves detailed information about a specific agent.
GET
/
v1
/
agents
/
{agentId}
Get agent by ID
curl --request GET \
--url https://api.devic.ai/v1/agents/{agentId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.devic.ai/v1/agents/{agentId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.devic.ai/v1/agents/{agentId}', 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.devic.ai/v1/agents/{agentId}",
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.devic.ai/v1/agents/{agentId}"
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))
}HttpResponse<String> response = Unirest.get("https://api.devic.ai/v1/agents/{agentId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.devic.ai/v1/agents/{agentId}")
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{
"_id": "<string>",
"name": "<string>",
"description": "<string>",
"imgUrl": "<string>",
"disabled": true,
"archived": true,
"provider": "<string>",
"llm": "<string>",
"assistantSpecialization": {
"identifier": "<string>",
"name": "<string>",
"description": "<string>",
"presets": "<string>",
"availableToolsGroupsUids": [
"<string>"
],
"enabledTools": [
"<string>"
],
"model": "<string>",
"provider": "<string>",
"imgUrl": "<string>",
"codeSnippetIds": [
"<string>"
],
"availableSkillIds": [
"<string>"
],
"subagentsIds": [
"<string>"
],
"maxChatMessages": 123,
"maxToolResponseInputTokens": 123,
"contextManagement": {
"fullContextTurnDepth": 123,
"alwaysIncludeUserMessages": true
}
},
"creationTimestampMs": 123,
"lastEditTimestampMs": 123,
"maxExecutionInputTokens": 123,
"maxExecutionToolCalls": 123,
"agentNotificationConfig": {},
"evaluationConfig": {}
}Authorizations
An API key from your Devic console, sent as Authorization: Bearer <key>. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a 401. See Authentication.
Path Parameters
The unique identifier of the agent
Response
Agent retrieved successfully
Agent ID
Agent name
Agent description
Image URL
Whether the agent is disabled
Whether the agent is archived
LLM provider
LLM model name
Configuration for the assistant specialization
Show child attributes
Show child attributes
Creation timestamp in milliseconds
Last edit timestamp in milliseconds
Maximum input tokens per execution
Maximum tool calls per execution