# Extension Registry API

API endpoints for managing extensions and providers.

## List Extensions

```http
GET /v1/extensions?category=provider&limit=20
```

Response: `200 OK`

```json
{
  "extensions": [
    {
      "id": "ext-001",
      "name": "aws-provider",
      "category": "provider",
      "version": "3.1.0",
      "author": "provisioning-team",
      "downloads": 15000
    }
  ],
  "total": 150
}
```

## Install Extension

```http
POST /v1/extensions/install
{
  "name": "aws-provider",
  "version": "3.1.0"
}
```

Response: `201 Created`

## Get Extension Details

```http
GET /v1/extensions/:name
```

## Search Extensions

```http
GET /v1/extensions/search?q=kubernetes&category=provider
```

## Publish Extension

```http
POST /v1/extensions/publish
Content-Type: multipart/form-data

{
  "extension": <binary>,
  "metadata": {
    "name": "my-extension",
    "version": "1.0.0",
    "description": "My custom extension"
  }
}
```

## Related Documentation

- [Extension Development](../development/extension-development.md)
- [REST API Overview](./rest-api.md)
