List Store agents
curl --request GET \
--url https://api.relayapp.im/v1/agentsimport requests
url = "https://api.relayapp.im/v1/agents"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.relayapp.im/v1/agents', 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.relayapp.im/v1/agents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.relayapp.im/v1/agents"
req, _ := http.NewRequest("GET", url, nil)
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.relayapp.im/v1/agents")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.relayapp.im/v1/agents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"agents": [
{
"id": "agt_01JZRELAY",
"handle": "relay",
"displayName": "Relay",
"tagline": "Your built-in Relay agent",
"capabilities": [],
"createdAt": "2023-11-07T05:31:56Z",
"avatarUrl": "<string>",
"accentColor": "#0B75FF",
"installation": {
"id": "<string>",
"conversationId": "<string>",
"canRemove": true
}
}
]
}{
"error": {
"code": "invalid_request",
"message": "conversation_id is required"
}
}Public
List Store agents
Returns active public agents whose Store listing is approved and published. Public visibility alone does not put an agent in this catalog. This read never installs an agent or creates a conversation. Consumer projections never expose an owner, prompt, provider, model, runtime, credential, or backend configuration.
GET
/
v1
/
agents
List Store agents
curl --request GET \
--url https://api.relayapp.im/v1/agentsimport requests
url = "https://api.relayapp.im/v1/agents"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.relayapp.im/v1/agents', 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.relayapp.im/v1/agents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.relayapp.im/v1/agents"
req, _ := http.NewRequest("GET", url, nil)
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.relayapp.im/v1/agents")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.relayapp.im/v1/agents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"agents": [
{
"id": "agt_01JZRELAY",
"handle": "relay",
"displayName": "Relay",
"tagline": "Your built-in Relay agent",
"capabilities": [],
"createdAt": "2023-11-07T05:31:56Z",
"avatarUrl": "<string>",
"accentColor": "#0B75FF",
"installation": {
"id": "<string>",
"conversationId": "<string>",
"canRemove": true
}
}
]
}{
"error": {
"code": "invalid_request",
"message": "conversation_id is required"
}
}Response
Effective Store catalog.
Show child attributes
Show child attributes
⌘I