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

# Introduction

> Explore the Coconut API

# Coconut API

The Coconut API provides comprehensive programmatic access to all features of the Coconut development platform, including proposal management, agent orchestration, resource handling, terminal sessions, and AI-powered functionality.

## API Overview

The API is organized into the following categories:

<CardGroup cols={2}>
  <Card title="Proposals" icon="lightbulb">
    Manage change proposals and track development tasks
  </Card>

  <Card title="Agents" icon="robot">
    Configure and orchestrate AI agents
  </Card>

  <Card title="Resources" icon="folder">
    Handle files, media, and project resources
  </Card>

  <Card title="Terminal" icon="terminal">
    Manage integrated terminal sessions
  </Card>

  <Card title="AI" icon="sparkles">
    Access AI chat and completion endpoints
  </Card>

  <Card title="Configuration" icon="gear">
    Manage project and global settings
  </Card>
</CardGroup>

## Base URL

The API is available at `/api/v1` relative to your Coconut instance:

```
http://localhost:3000/api/v1    # Local instance
https://your-instance.coconut.dev/api/v1    # Hosted instance
```

## Authentication

The Coconut API supports multiple authentication methods:

* **Session Cookie** - For browser-based requests
* **Bearer Token** - For programmatic API access
* **API Key** - For service-to-service communication

<Tip>
  Most endpoints require authentication. Make sure to include your credentials in each request.
</Tip>

## Getting Started

Explore the API reference using the navigation menu to discover all available endpoints and their parameters.