# Addons

## `GET /api/addons`

**ListAddons**

**Response `200` — Request fulfilled, document follows**

Model: array of {ref}`AddonSchema <model-addonschema>`

Type: array of {ref}`AddonSchema <model-addonschema>`


## `POST /api/addons`

**CreateAddon**

**Request body**

Model: {ref}`AddonCreate <model-addoncreate>`

| Field | Type | Required | Description |
|---|---|---|---|
| `slug` | string | yes |  |
| `name` | string | yes |  |
| `summary` | string | yes |  |
| `version` | string | yes |  |
| `download_url` | string | yes |  |
| `homepage_url` | string \| null | no |  |
| `origin` | {ref}`AddonOrigin <model-addonorigin>` | no |  |

**Response `201` — Document created, URL follows**

Model: {ref}`AddonSchema <model-addonschema>`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `slug` | string | yes |  |
| `name` | string | yes |  |
| `summary` | string | yes |  |
| `version` | string | yes |  |
| `download_url` | string | yes |  |
| `homepage_url` | string \| null | yes |  |
| `origin` | {ref}`AddonOrigin <model-addonorigin>` | no |  |
| `updated_at` | string (date-time) | yes |  |


## `DELETE /api/addons/{addon_id}`

**DeleteAddon**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `addon_id` | path | string (uuid) | yes |  |

**Response `204`** — Request fulfilled, nothing follows


## `PATCH /api/addons/{addon_id}`

**UpdateAddon**

**Parameters**

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `addon_id` | path | string (uuid) | yes |  |

**Request body**

Model: {ref}`AddonUpdate <model-addonupdate>`

| Field | Type | Required | Description |
|---|---|---|---|
| `name` | string \| null | no |  |
| `summary` | string \| null | no |  |
| `version` | string \| null | no |  |
| `download_url` | string \| null | no |  |
| `homepage_url` | string \| null | no |  |
| `origin` | {ref}`AddonOrigin <model-addonorigin>` \| null | no |  |

**Response `200` — Request fulfilled, document follows**

Model: {ref}`AddonSchema <model-addonschema>`

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `slug` | string | yes |  |
| `name` | string | yes |  |
| `summary` | string | yes |  |
| `version` | string | yes |  |
| `download_url` | string | yes |  |
| `homepage_url` | string \| null | yes |  |
| `origin` | {ref}`AddonOrigin <model-addonorigin>` | no |  |
| `updated_at` | string (date-time) | yes |  |