Skip to main content
All API endpoints require authentication using Bearer tokens. You can get your API key from Control Hub → Settings → API access.
Using Claude Code or another AI coding assistant? Install the build-on-aster plugin and it will create, run, and maintain your agents through this API for you — no need to hand-write the calls.

​
Welcome to the Aster Agents API

Build, manage, and orchestrate AI agents programmatically. Our REST API gives you the tools to create sophisticated agent workflows and integrate them into your applications.

​
Authentication

To authenticate your API requests, you’ll need an API key. Here’s how to get yours:
  1. Go to Control Hub → Settings → API access
  2. Click Copy API key
  3. Store this key securely - it’s valid for 6 months
The key is yours: API calls made with it act as you, with your role and permissions. Use this key in the Authorization header of your API requests:

​
Core Concepts

​
Agents

Create and manage AI agents with specific roles and capabilities. Each agent can be configured with:
  • Custom instructions and system prompts
  • Tool integrations for enhanced capabilities
  • Model provider settings
  • Conversation starters

​
Model Providers

Choose from a wide range of AI model providers to power your agents. Current providers and models include:
  • Anthropic: Claude Fable 5.1, Fable 5, Opus 5.5, Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 5.5, Sonnet 5, Sonnet 4.6, Haiku 5.5, Haiku 4.5
  • OpenAI: GPT-6.1 Sol, GPT-6 (Astra / Sol / Luna), GPT-5.6 (Sol / Terra / Luna), GPT-5.5, GPT-5.4 (+ Mini / Nano / Pro), GPT-4.1
  • Google: Gemini 3.1 Pro, Gemini 3.5 Flash, Gemini 3 Flash
  • xAI: Grok 4.7, Grok 4.6, Grok 4.5
  • Fireworks: GLM 5.2, Kimi K2.6
  • Azure OpenAI: Any deployed model
Models are referenced in the provider:model-id format (e.g. anthropic:claude-sonnet-4-6, openai:gpt-5.5). The model list changes as new models ship — see Choosing a Model for the current identifiers, pricing, and guidance. Don’t hardcode model IDs from memory.

​
Integrations

Integrations connect your agents to external platforms such as Salesforce, Snowflake, or Google Drive. They’re connected once per organization by an admin in Control Hub → Integrations, and every agent in the organization can then use them. The public API doesn’t connect or manage integrations.

​
Agent Management

Use the API to create, update, and manage your agents. Key operations include:
  • Creating new agents with specific configurations.
  • Updating existing agents with new settings or capabilities.
  • Managing agent performance and monitoring usage metrics.
  • Integrating agents with enterprise platforms for enhanced functionality.