Skip to main content

API-only agents

An agent identity you drive entirely through the Dart API

An API-only agent has no built-in automation in Dart. Instead, it acts as an identity that you control through the Dart API, you decide when it reads tasks, posts comments, and updates statuses from your own code.

API agent sample

When to use it

Choose API-only when you want full programmatic control and are building your own orchestration outside Dart, rather than relying on Instructions, Forwarding, or Local behavior.

Setup

  1. Go to Agents and select Create a custom agent

  2. Give it a Name and Icon

  3. Choose API-only as the type

  4. Use your Dart API credentials to assign work to and act as the agent from your code

Did this answer your question?