Create Session from Agent

Create a session from an existing agent configuration.

string

required

The key of the agent to create a session from.

string

A specific pinned version number to use for the agent’s configuration. If omitted, the agent’s current active configuration is used.

curl -X GET "https://api.artaios.ai/api/v1/sessions/from-agent/?agent_key=agent_456def" \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.artaios.ai/api/v1/sessions/from-agent/",
    params={"agent_key": "agent_456def"},
    headers={"x-api-key": "YOUR_API_KEY"}
)
session = response.json()

const response = await fetch('https://api.artaios.ai/api/v1/sessions/from-agent/?agent_key=agent_456def', {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});
const session = await response.json();

Response

{
  "success": true,
  "session_id": "session_def456",
  "config_hash": "a1b2c3d4e5f6",
  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
  "agent_name": "My Agent"
}

This method creates a session using the current configuration of the specified agent. To use a specific pinned version instead, pass the version query parameter.

To delete all sessions created from a given agent, see Delete Sessions from Agent, which uses the same DELETE /api/v1/sessions/from-agent/ route.

API Overview

Agents

Sessions

Runtime

Artifacts

Files

Collections

Knowledge Bases

Images

Response

​Response

Response