Skip to main content
ShipAgents are workspace-scoped agents for delegated work. The API surface uses bearer tokens and supports creating, listing, reading, and deleting agents, plus reading agent notes and issue suggestions.

​
Authentication

curl https://agents.shipyard.lol/api/v1/agents \
  -H "Authorization: Bearer sa_your_api_key"

​
Agent presets

Planning

Planning agents help structure work and prepare operational next steps.

SWE

Engineering agents focus on software execution and implementation support.

Research

Research agents gather and organize context for decisions.

Support, sales, and marketing

Business workflow agents cover support, sales, and marketing presets.

​
Endpoints

GET /api/v1/agents, POST /api/v1/agents, GET /api/v1/agents/:id, and DELETE /api/v1/agents/:id.
GET /api/v1/agents/:id/notes and GET /api/v1/agents/:id/issues.
GET /api/v1/keys, POST /api/v1/keys, and DELETE /api/v1/keys/:id.