> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipyard.lol/llms.txt
> Use this file to discover all available pages before exploring further.

# API and ShipAgents

> Use ShipAgents and the public API for workspace automation.

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

```bash theme={null}
curl https://agents.shipyard.lol/api/v1/agents \
  -H "Authorization: Bearer sa_your_api_key"
```

## Agent presets

<Columns cols={2}>
  <Column>
    <Card title="Planning" icon="calendar-days">
      Planning agents help structure work and prepare operational next steps.
    </Card>
  </Column>

  <Column>
    <Card title="SWE" icon="code">
      Engineering agents focus on software execution and implementation support.
    </Card>
  </Column>

  <Column>
    <Card title="Research" icon="search">
      Research agents gather and organize context for decisions.
    </Card>
  </Column>

  <Column>
    <Card title="Support, sales, and marketing" icon="bot">
      Business workflow agents cover support, sales, and marketing presets.
    </Card>
  </Column>
</Columns>

## Endpoints

<Accordion title="Agents">
  `GET /api/v1/agents`, `POST /api/v1/agents`, `GET /api/v1/agents/:id`, and `DELETE /api/v1/agents/:id`.
</Accordion>

<Accordion title="Agent context">
  `GET /api/v1/agents/:id/notes` and `GET /api/v1/agents/:id/issues`.
</Accordion>

<Accordion title="API keys">
  `GET /api/v1/keys`, `POST /api/v1/keys`, and `DELETE /api/v1/keys/:id`.
</Accordion>