---
title: "Admin \u2014 service packs"
path: reference/api/admin-packs
status: published
---

# Admin — service packs

**5 endpoints** in this group. All paths are prefixed with `/api/v1`.

## Endpoints in this group

- [`GET /api/v1/admin/packs`](#get-api-v1-admin-packs) — Admin List Packs
- [`POST /api/v1/admin/packs`](#post-api-v1-admin-packs) — Admin Create Pack
- [`GET /api/v1/admin/packs/subscriptions`](#get-api-v1-admin-packs-subscriptions) — Admin List Pack Subscriptions
- [`DELETE /api/v1/admin/packs/{pack_id}`](#delete-api-v1-admin-packs-pack-id) — Admin Deactivate Pack
- [`PUT /api/v1/admin/packs/{pack_id}`](#put-api-v1-admin-packs-pack-id) — Admin Update Pack

---

### GET `/api/v1/admin/packs` — Admin List Packs {#get-api-v1-admin-packs}

List all service packs (including inactive).

**Parameters**:

- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_list_ServicePackResponse__` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### POST `/api/v1/admin/packs` — Admin Create Pack {#post-api-v1-admin-packs}

Create a new service pack with items.

**Parameters**:

- `authorization` (header, string, optional)


**Body**: `ServicePackCreateRequest` — {`slug`, `name`, `description`, `icon_url` + 10 more}


**Responses**:

- `201` — Successful Response. Returns: `ApiResponse_ServicePackResponse_` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### GET `/api/v1/admin/packs/subscriptions` — Admin List Pack Subscriptions {#get-api-v1-admin-packs-subscriptions}

List pack subscriptions across all tenants.

**Parameters**:

- `page` (query, integer, optional)
- `page_size` (query, integer, optional)
- `tenant_id` (query, string, optional)
- `status` (query, string, optional)
- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `PaginatedResponse_PackSubscriptionResponse_` — {`data`, `pagination`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### DELETE `/api/v1/admin/packs/{pack_id}` — Admin Deactivate Pack {#delete-api-v1-admin-packs-pack-id}

Deactivate a service pack (soft delete).

**Parameters**:

- `pack_id` (path, string, required)
- `authorization` (header, string, optional)


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_dict_` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}


### PUT `/api/v1/admin/packs/{pack_id}` — Admin Update Pack {#put-api-v1-admin-packs-pack-id}

Update a service pack. If items are provided, they replace all existing items.

**Parameters**:

- `pack_id` (path, string, required)
- `authorization` (header, string, optional)


**Body**: `ServicePackUpdateRequest` — {`name`, `description`, `icon_url`, `billing_period` + 9 more}


**Responses**:

- `200` — Successful Response. Returns: `ApiResponse_ServicePackResponse_` — {`data`, `meta`}
- `422` — Validation Error. Returns: `HTTPValidationError` — {`detail`}