gobii

Gobii Agent API

Build persistent AI agents with one API

Create an agent once, then schedule it, message it, connect tools and files, inspect its timeline, and manage its lifecycle from your product. The result is an AI employee experience without reducing ongoing work to disconnected one-off runs.

Read the API docs

API keys use the X-Api-Key header. Review Developer Basics and authentication before shipping a production integration.

Quickstart · create_agent.sh 
# Create a persistent agent on Gobii Cloud
curl -X POST \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $GOBII_API_KEY" \
  -d '{
    "name": "Market Monitor",
    "charter": "Track competitor launches and brief the product team.",
    "schedule": "@daily"
  }' \
  https://gobii.ai/api/v1/agents/

Verified against the current Agent API create example.

Response excerpt 
{
    "id": "b0bd82a5-ed5a-43f4-87f9-242585a2428f",
    "name": "Market Monitor",
    "schedule": "@daily",
    "is_active": true,
    "life_state": "active",
    "created_at": "2026-08-09T22:02:50.916739Z"
}

Additional response fields omitted for brevity.

Persistent by design

One agent resource across the lifecycle

Keep identity, configuration, schedule, messages, files, and observable work attached to the same agent instead of rebuilding context for every request.

01

Create and configure

Set a name, charter, optional schedule, contact policy, and supported tool configuration.

Agent resource fields
02

Start work

Run on cron-like schedules, send a message through the API, or deliver an event through a documented webhook surface.

Webhooks and events
03

Use tools and data

Combine browsers, connected apps, MCP servers, files, and schema-guided JSON output where supported.

Structured data
04

Inspect and control

Read timeline events and processing state, update configuration, or activate and deactivate the agent without deleting it.

Timelines and state

Pick the right interface

Four developer surfaces, four different jobs

The Agent API is the persistent resource model. Remote MCP, webhooks, and the legacy Browser Task API solve adjacent integration problems rather than naming the same interface.

Developer products

What teams build with the Agent API

These are example product patterns supported by the current developer surfaces, not customer case studies.

Research and monitoring agents Example

Run recurring research on a schedule, keep source material in the workspace, and deliver findings through the agent timeline or configured channels.

See schedule support

Event-driven operations agents Example

Trigger a specific agent from an inbound webhook or API message, then observe work through timeline events and processing state.

Configure inbound webhooks

Embedded agent experiences Example

Put your own application UI in front of dedicated agents while Gobii provides the persistent resource, schedule, messages, and timeline.

Open the Agent API reference

Cross-tool agents Example

Combine browser work, files, connected apps, structured output, and assigned MCP servers in one long-lived workflow.

Explore tools and apps

Production operations

Controls for agents running real work

Use the platform controls that match the owner, risk, cadence, and observability needs of each agent.

Personal or organization ownership

Personal agents belong to a user; organization agents belong to the team and follow organization roles and shared resources. Review ownership and roles.

Schedules, state, and usage limits

Set an optional schedule, activate or deactivate the agent, and use supported daily credit controls to bound recurring work. Understand usage and limits.

Timelines and observable outputs

Inspect messages, task markers, processing state, files, and deliverables through the supported product and API views. Learn how timelines work.

Human approval boundaries

Design agents to pause for human input, secrets, contacts, or important changes where the product supports approval requests. Set approval boundaries.

Deployment choice

Use Gobii Cloud or run the platform yourself

Choose the managed path for speed, or operate the open-source platform when infrastructure control matters more.

Developer Basics API reference Structured data Remote MCP Webhooks and events

Deploy your first persistent agent

Create your key, follow the verified quickstart, and manage the agent through its schedule, messages, tools, timeline, and lifecycle.

Read the API docs
View the open-source platform

Review current Cloud plan limits and any available first-time trial terms on Gobii pricing before purchase.