# Activity Feedback V2 API

API for managing activity feedback (version 2)

**Version:** 2.0.0

## Overview

### Base URLs

- **Production server**: `https://api.repzo.me/v1`

### API Categories

- **Activity Feedback V2**: Activity feedback v2 management operations

## Authentication

This API uses the following authentication methods:

- **ApiKeyAuth**

## Endpoints

### `/activity-feedback-v2`

#### GET /activity-feedback-v2

**Summary:** Get all activity feedback v2

**Description:** Retrieve a list of all activity feedback v2 with optional filtering and pagination

**Tags:** Activity Feedback V2

##### Parameters

| Name | Location | Type | Required | Description |
| ---- | -------- | ---- | -------- | ----------- |

| `page` | query | integer | No | Page number for pagination |

| `per_page` | query | integer | No | Number of items per page |

| `sort` | query | string | No | Sort field |

| `company_namespace` | query | array | No | Company namespace for filtering |

| `activity_type` | query | string | No | Filter by activity type |

| `rep` | query | string | No | Filter by representative ID |

| `client` | query | string | No | Filter by client ID |

| `overall_satisfaction` | query | integer | No | Filter by overall satisfaction rating |

| `template_id` | query | string | No | Filter by feedback template ID |

| `_id` | query | array | No | Filter by ID |

##### Responses

**200** - Successful response

Content-Type: `application/json`

**400** - No description

**401** - No description

**403** - No description

**500** - No description

---

#### POST /activity-feedback-v2

**Summary:** Create new activity feedback v2

**Description:** Create a new activity feedback v2 entry

**Tags:** Activity Feedback V2

##### Request Body

**Content Types:**

- `application/json`

##### Responses

**201** - Activity feedback v2 created successfully

Content-Type: `application/json`

**400** - No description

**401** - No description

**403** - No description

**422** - No description

**500** - No description

---

### `/activity-feedback-v2/{id}`

#### GET /activity-feedback-v2/{id}

**Summary:** Get activity feedback v2 by ID

**Description:** Retrieve a specific activity feedback v2 by its ID

**Tags:** Activity Feedback V2

##### Parameters

| Name | Location | Type | Required | Description |
| ---- | -------- | ---- | -------- | ----------- |

| `id` | path | string | Yes | Activity feedback v2 ID |

##### Responses

**200** - Successful response

Content-Type: `application/json`

**400** - No description

**401** - No description

**403** - No description

**404** - No description

**500** - No description

---

#### PATCH /activity-feedback-v2/{id}

**Summary:** Update activity feedback v2

**Description:** Update an existing activity feedback v2

**Tags:** Activity Feedback V2

##### Parameters

| Name | Location | Type | Required | Description |
| ---- | -------- | ---- | -------- | ----------- |

| `id` | path | string | Yes | Activity feedback v2 ID |

##### Request Body

**Content Types:**

- `application/json`

##### Responses

**200** - Activity feedback v2 updated successfully

Content-Type: `application/json`

**400** - No description

**401** - No description

**403** - No description

**404** - No description

**422** - No description

**500** - No description

---

#### DELETE /activity-feedback-v2/{id}

**Summary:** Delete activity feedback v2

**Description:** Delete an activity feedback v2 by ID

**Tags:** Activity Feedback V2

##### Parameters

| Name | Location | Type | Required | Description |
| ---- | -------- | ---- | -------- | ----------- |

| `id` | path | string | Yes | Activity feedback v2 ID |

##### Responses

**200** - Activity feedback v2 deleted successfully

Content-Type: `application/json`

**400** - No description

**401** - No description

**403** - No description

**404** - No description

**500** - No description

---

### `/activity-feedback-v2/analytics/detailed`

#### GET /activity-feedback-v2/analytics/detailed

**Summary:** Get detailed feedback analytics

**Description:** Get detailed analytics and insights for activity feedback v2

**Tags:** Activity Feedback V2

##### Parameters

| Name | Location | Type | Required | Description |
| ---- | -------- | ---- | -------- | ----------- |

| `date_from` | query | string | No | Start date for analytics |

| `date_to` | query | string | No | End date for analytics |

| `activity_type` | query | string | No | Filter by activity type |

| `rep` | query | string | No | Filter by representative ID |

| `template_id` | query | string | No | Filter by feedback template ID |

##### Responses

**200** - Detailed analytics data retrieved successfully

Content-Type: `application/json`

**400** - No description

**401** - No description

**403** - No description

**500** - No description

---

## Data Models

### ActivityFeedbackV2

| Property | Type | Required | Description |
| -------- | ---- | -------- | ----------- |

| `_id` | string | No | Unique identifier |

| `activity_type` | string | Yes | Type of activity this feedback is for |

| `activity_id` | string | No | ID of the related activity |

| `rep` | string | Yes | Representative ID |

| `client` | string | No | Client ID |

| `template_id` | string | Yes | Feedback template ID used |

| `overall_satisfaction` | integer | Yes | Overall satisfaction rating (1-10 scale) |

| `responses` | array | No | No description |

| `nps_score` | integer | No | Net Promoter Score (0-10) |

| `sentiment_analysis` | object | No | No description |

| `completion_time` | integer | No | Time taken to complete feedback (in seconds) |

| `completion_rate` | number | No | Percentage of questions completed |

| `session_data` | object | No | No description |

| `follow_up_actions` | array | No | No description |

| `is_anonymous` | boolean | No | Whether the feedback is anonymous |

| `company_namespace` | array | No | Company namespace |

| `createdAt` | string | No | Creation timestamp |

| `modifiedAt` | string | No | Last modification timestamp |

| `SVClient` | integer | No | Client version |

| `__v` | integer | No | Document version |

### CreateActivityFeedbackV2Request

| Property | Type | Required | Description |
| -------- | ---- | -------- | ----------- |

| `activity_type` | string | Yes | Type of activity this feedback is for |

| `activity_id` | string | No | ID of the related activity |

| `rep` | string | Yes | Representative ID |

| `client` | string | No | Client ID |

| `template_id` | string | Yes | Feedback template ID used |

| `overall_satisfaction` | integer | Yes | Overall satisfaction rating (1-10 scale) |

| `responses` | array | No | No description |

| `nps_score` | integer | No | Net Promoter Score (0-10) |

| `completion_time` | integer | No | Time taken to complete feedback (in seconds) |

| `session_data` | object | No | No description |

| `is_anonymous` | boolean | No | Whether the feedback is anonymous |

| `company_namespace` | array | No | Company namespace |

### UpdateActivityFeedbackV2Request

| Property | Type | Required | Description |
| -------- | ---- | -------- | ----------- |

| `overall_satisfaction` | integer | No | Overall satisfaction rating (1-10 scale) |

| `responses` | array | No | No description |

| `nps_score` | integer | No | Net Promoter Score (0-10) |

| `follow_up_actions` | array | No | No description |

| `company_namespace` | array | No | Company namespace |

### PagingInfo

| Property | Type | Required | Description |
| -------- | ---- | -------- | ----------- |

| `total` | integer | No | Total number of items |

| `page` | integer | No | Current page number |

| `per_page` | integer | No | Items per page |

| `pages` | integer | No | Total number of pages |

## TypeScript Usage

See [activity-feedback-v2-examples.md](./activity-feedback-v2-examples.md) for detailed TypeScript usage examples.