A2 Agent

 # Start an interactive session
a2 interact
                

 # Execute a single task
a2 task "Create a new file named 'hello.md' with content '# Hello Agent'"
                

 # Run a task in the background
a2 task "Analyze entire codebase for security vulnerabilities" --background

# List all jobs
a2 jobs list

# Check specific job status
a2 jobs show [job-id]

# Wait for job completion
a2 jobs wait [job-id]
            

 # Pass context to your task
a2 task "Review this file" --param file=src/main.py --param language=python
            

API Documentation

Our API provides full compatibility with OpenAI, Anthropic, and OpenRouter formats. Access comprehensive documentation for all available endpoints:

• View Full API Documentation
• List Available Models
• Health Check Endpoint

OpenAI-Compatible Examples

Use the following example to make requests to our OpenAI-compatible endpoint:

curl -X POST https://a2-agent.k42.ventures/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-coder-v2",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello, how are you?"}
    ],
    "temperature": 0.7
  }'

Anthropic-Compatible Examples

Use the following example to make requests to our Anthropic-compatible endpoint:

curl -X POST https://a2-agent.k42.ventures/v1/messages \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-coder-v2",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Hello, how are you?"}
    ]
  }'

OpenRouter-Compatible Examples

Use the following example to make requests to our OpenRouter-compatible endpoint:

curl -X POST https://a2-agent.k42.ventures/openrouter/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-coder-v2",
    "messages": [
      {"role": "user", "content": "Hello, how are you?"}
    ]
  }'

JavaScript/Node.js Example

import axios from 'axios';

const response = await axios.post('https://a2-agent.k42.ventures/v1/chat/completions', {
  model: 'deepseek-coder-v2',
  messages: [
    { role: 'user', content: 'Hello, how are you?' }
  ]
}, {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

console.log(response.data);

Python Example

import requests

response = requests.post(
    'https://a2-agent.k42.ventures/v1/chat/completions',
    headers={
        'Authorization': 'Bearer YOUR_API_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'model': 'deepseek-coder-v2',
        'messages': [
            {'role': 'user', 'content': 'Hello, how are you?'}
        ]
    }
)

print(response.json())

Verify Examples

You can test these example requests directly in our API tester above. Just select the appropriate endpoint and enter your API token to execute the requests.

Quick Test Examples:

• OpenAI: Select "OpenAI: /v1/chat/completions" and use the example JSON in the body
• Anthropic: Select "Anthropic: /v1/messages" and use the example JSON in the body
• OpenRouter: Select "OpenRouter: /openrouter/chat/completions" and use the example JSON in the body
• Models List: Select any of the models endpoints and use GET method (no body needed)

For detailed information about all endpoints and their usage, visit our comprehensive API documentation.