Agents
Get an agent
GET
/
v1
/
agents
/
{agent_id}
Get an agent
curl --request GET \
--url https://api.sempera.org/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sempera.org/v1/agents/{agent_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sempera.org/v1/agents/{agent_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"object": "agent",
"status": "draft",
"name": "<string>",
"business_name": "<string>",
"persona": "<string>",
"workspace_id": "<string>",
"lifecycle": "<string>",
"stage": "<string>",
"published_version_id": "<string>",
"published_version_number": 123,
"published_at": "2023-11-07T05:31:56Z",
"gates": {},
"channels": {},
"readiness": {},
"draft": {},
"published": {},
"voice": "<unknown>",
"language": "<unknown>",
"instructions": "<unknown>",
"fields": "<unknown>",
"tools": "<unknown>",
"knowledge": "<unknown>"
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}Authorizations
A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.
Path Parameters
The agent's stable id.
Response
OK
Stable Sempera id (never a provider id).
Available options:
draft, published, archived, needs_repair ⌘I
Get an agent
curl --request GET \
--url https://api.sempera.org/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sempera.org/v1/agents/{agent_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sempera.org/v1/agents/{agent_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"object": "agent",
"status": "draft",
"name": "<string>",
"business_name": "<string>",
"persona": "<string>",
"workspace_id": "<string>",
"lifecycle": "<string>",
"stage": "<string>",
"published_version_id": "<string>",
"published_version_number": 123,
"published_at": "2023-11-07T05:31:56Z",
"gates": {},
"channels": {},
"readiness": {},
"draft": {},
"published": {},
"voice": "<unknown>",
"language": "<unknown>",
"instructions": "<unknown>",
"fields": "<unknown>",
"tools": "<unknown>",
"knowledge": "<unknown>"
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}{
"error": {
"code": "AGENT_ENV_UNPINNED",
"message": "<string>",
"request_id": "<string>",
"field": "<string>",
"scope": "<string>",
"reason": "<string>"
}
}