Skip to main content

​
List Agents

​
GET
string
required
/v1/agents
List all agents.

​
Query Parameters

​
limit
number
Maximum number of agents to return (default: 20, max: 100)
​
offset
number
Number of agents to skip (default: 0)
​
agents
array
List of agents
​
total
number
Total number of agents
curl -X GET https://api.valmi.io/v1/agents \
  -H "Authorization: Bearer sk_api_abc123xyz"

{
  "agents": [
    {
      "id": "agent_abc123",
      "name": "Customer Support Bot",
      "type": "langgraph",
      "created_at": "2024-01-15T10:00:00Z"
    }
  ],
  "total": 1
}

​
Get Agent

​
GET
string
required
/v1/agents/
Get details of a specific agent.
​
id
string
Agent ID
​
name
string
Agent name
​
type
string
Agent type (langgraph, crewai, n8n, custom)
curl -X GET https://api.valmi.io/v1/agents/agent_abc123 \
  -H "Authorization: Bearer sk_api_abc123xyz"

​
Create Agent

​
POST
string
required
/v1/agents
Create a new agent.

​
Body

​
name
string
required
Agent name
​
type
string
required
Agent type (langgraph, crewai, n8n, custom)
​
description
string
Agent description
curl -X POST https://api.valmi.io/v1/agents \
  -H "Authorization: Bearer sk_api_abc123xyz" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Bot",
    "type": "langgraph",
    "description": "AI customer support agent"
  }'