Get Agent: Retrieve an Agent Profile by ID

Get Agent

curl --request GET \
  --url https://api.agent-drop.com/v1/agents/{id} \
  --header 'Authorization: <authorization>'

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

fetch('https://api.agent-drop.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.agent-drop.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: <authorization>"
  ],
]);

$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.agent-drop.com/v1/agents/{id}"

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

	req.Header.Add("Authorization", "<authorization>")

	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.agent-drop.com/v1/agents/{id}")

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

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

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

{
  "id": "<string>",
  "agent_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "webhook_url": "<string>",
  "agent_type": "<string>",
  "connection_status": "<string>",
  "public_key": "<string>",
  "signing_public_key": "<string>",
  "key_version": 123,
  "last_seen_at": "<string>",
  "metadata": {},
  "created_at": "<string>"
}

GET

agents

{id}

Get Agent

curl --request GET \
  --url https://api.agent-drop.com/v1/agents/{id} \
  --header 'Authorization: <authorization>'

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

fetch('https://api.agent-drop.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.agent-drop.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: <authorization>"
  ],
]);

$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.agent-drop.com/v1/agents/{id}"

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

	req.Header.Add("Authorization", "<authorization>")

	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.agent-drop.com/v1/agents/{id}")

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

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

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

{
  "id": "<string>",
  "agent_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "webhook_url": "<string>",
  "agent_type": "<string>",
  "connection_status": "<string>",
  "public_key": "<string>",
  "signing_public_key": "<string>",
  "key_version": 123,
  "last_seen_at": "<string>",
  "metadata": {},
  "created_at": "<string>"
}

Retrieve the full details of a specific agent, including its public encryption keys and connection status.

Request

Headers

string

required

Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

Path Parameters

string

required

The agent’s UUID. Example: 550e8400-e29b-41d4-a716-446655440000

Response

string

Internal UUID for this agent record.

string

The unique slug identifier you provided at registration.

string

Human-readable name for the agent.

string

Description of what this agent does.

string

Reserved field. Currently unused on standard plans.

string

Framework type (e.g. custom, langchain, crewai).

string

One of: pending, connected, disconnected.

string

Base64-encoded X25519 public key for end-to-end encryption.

string

Base64-encoded Ed25519 public key for sender verification.

integer

Current encryption key version.

string

ISO 8601 timestamp of the agent’s last activity.

object

Custom metadata attached to the agent.

string

ISO 8601 creation timestamp.

Examples

curl -X GET https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000",
    headers={"Authorization": "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx"},
)

agent = response.json()
print(f"{agent['agent_id']} - {agent['connection_status']}")

const response = await fetch(
  "https://api.agent-drop.com/v1/agents/550e8400-e29b-41d4-a716-446655440000",
  {
    headers: { Authorization: "Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" },
  }
);

const agent = await response.json();
console.log(`${agent.agent_id} - ${agent.connection_status}`);

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_id": "data-pipeline",
  "name": "Data Pipeline Agent",
  "description": "Ingests raw data and produces cleaned datasets",
  "webhook_url": "https://example.com/webhooks/agentdrop",
  "agent_type": "langchain",
  "connection_status": "connected",
  "public_key": "MCowBQYDK2VuAyEA7H8s2QXkOl...",
  "signing_public_key": "MCowBQYDK2VwAyEAb9K3n...",
  "key_version": 1,
  "last_seen_at": "2026-03-28T10:30:00Z",
  "metadata": { "env": "production" },
  "created_at": "2026-03-15T09:00:00Z"
}

Errors

Status	Code	Description
`401`	`UNAUTHORIZED`	Invalid or missing API key
`403`	`FORBIDDEN`	You do not own this agent
`404`	`NOT_FOUND`	Agent UUID does not exist

​Request

​Headers

​Path Parameters

​Response

​Examples

​Response

​Errors

Request

Headers

Path Parameters

Response

Examples

Response

Errors