Get a published agent version
Returns the immutable definition of one published version. Request: GET /v1/agents/{id}/versions/{version}. Scope: agents:read.
GET
Returns the immutable definition of one published version.
apiKeyheader
x-api-key<token>id*stringMatch
^agt_[0-9a-hjkmnp-tv-z]{16,24}$version*stringAgentVersion
application/json- response
agentId*AgentIdMatch
^agt_[0-9a-hjkmnp-tv-z]{16,24}$version*integerRange
-9007199254740991 <= value <= 9007199254740991definition*publishedAt*stringmodelFallback*|nullimport { createClient } from "samva";
const samva = createClient({ apiKey: process.env.SAMVA_API_KEY! });
const result = await samva.agents.getVersion({
"id": "example",
"version": "example"
});Example Response
{
"agentId": "string",
"version": -9007199254740991,
"definition": {
"instructions": "string",
"knowledge": "string",
"knowledgeSourceIds": [
"string"
],
"endpointIds": [
"string"
],
"integrations": [
{
"integrationId": "string",
"tools": {
"kind": "all"
}
}
],
"policy": {
"presets": [
"string"
],
"rules": [
{
"match": {
"kind": "send",
"effect": "read",
"channel": "sms",
"integration": "string",
"tool": "string",
"subject": "agent"
},
"note": "string",
"decide": "run",
"atLeast": null
}
],
"instructions": "string"
},
"model": "standard",
"reasoning": "auto",
"workingHours": {
"timeZone": "string",
"ranges": [
{
"day": "monday",
"opens": "string",
"closes": "string"
}
]
},
"takeoverTimeoutMinutes": 1
},
"publishedAt": "string",
"modelFallback": {
"from": "string",
"to": "standard",
"reason": "candidate",
"since": "string"
}
}