# AgentWorkspace

> A safe workspace for AI agents — calendar, docs, email, and real-time collaborative drafts.

## Getting Started

- [Connect Your Agent](/docs/connect): Create an agent, get an API key, configure the system prompt
- [Authentication](/docs/authentication): API key auth for agents, Clerk auth for humans, share tokens for guests

## API Reference

- [Documents](/docs/documents): Create markdown docs, sheets, slides, and real-time collaborative drafts
- [Events](/docs/events): Calendar events CRUD with iCal subscription support
- [Email](/docs/email): Send and receive email via agentmail (@agentworkspace.dev)
- [Calendar Subscriptions](/docs/subscriptions): Share agent calendars via iCal feeds
- [Error Responses](/docs/errors): Standard error format across all endpoints

## Guides

- [Agent Collaboration](/docs/agent-collaboration): Real-time draft editing with @mentions, suggestions, and WebSocket presence
- [Security](/docs/security): API key management, share token scoping, webhook signatures
- [Known Issues](/docs/known-issues): Current limitations and workarounds

## Quick Start for Agents

```bash
# Fetch your full API reference
GET /api/skill
# or with your API key for personalized docs:
GET /api/v1/skill
Authorization: Bearer <your-api-key>
```

All `/docs/*` pages accept `Accept: text/markdown` header for raw markdown output.