# Repzo API - Integration App

OpenAPI specification for Repzo Integration App endpoints.

**Version:** 1.0.0

## Overview

### Base URLs

- \*\*\*\*: `https://sv.api.repzo.me`

## Authentication

No authentication required.

## Endpoints

### `/integration-app`

#### GET /integration-app

**Summary:** Find integration apps

##### Parameters

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

| `params` | query | object | No | Query parameters for filtering integration apps |

##### Responses

**200** - A list of integration apps

Content-Type: `application/json`

---

#### POST /integration-app

**Summary:** Create an integration app

##### Request Body

**Content Types:**

- `application/json`

##### Responses

**201** - Integration app created

Content-Type: `application/json`

---

### `/integration-app/{id}`

#### GET /integration-app/{id}

**Summary:** Get an integration app by ID

##### Parameters

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

| `id` | path | string | Yes | No description |

##### Responses

**200** - Integration app details

Content-Type: `application/json`

---

#### PUT /integration-app/{id}

**Summary:** Update an integration app

##### Parameters

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

| `id` | path | string | Yes | No description |

##### Request Body

**Content Types:**

- `application/json`

##### Responses

**200** - Integration app updated

Content-Type: `application/json`

---

## Data Models

### IntegrationAppFindResult

Result of finding integration apps

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

| `data` | array | No | No description |

| `total_result` | number | No | Total number of integration apps |

| `current_count` | number | No | Count of integration apps in current page |

| `total_pages` | number | No | Total number of pages |

| `current_page` | number | No | Current page number |

| `per_page` | number | No | Number of integration apps per page |

### IntegrationAppSchema

Integration app schema

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

| `_id` | string | No | Unique identifier for the integration app |

| `name` | string | No | Name of the integration app |

| `description` | string | No | Description of the integration app |

| `category` | string | No | Category of the integration |

| `version` | string | No | Version of the integration app |

| `status` | string | No | Status of the integration app |

| `available_app` | string | No | Available app reference |

| `company_namespace` | string | No | Company namespace |

| `config` | object | No | Configuration settings for the integration |

| `credentials` | object | No | Credentials for the integration |

| `endpoints` | object | No | API endpoints configuration |

| `webhooks` | object | No | Webhook configuration |

| `sync_settings` | object | No | Synchronization settings |

| `last_sync` | string | No | Last synchronization timestamp |

| `error_count` | number | No | Number of errors encountered |

| `success_count` | number | No | Number of successful operations |

| `integration_meta` | object | No | Integration metadata |

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

| `updatedAt` | string | No | Last update timestamp |

| `__v` | number | No | Version number |

### IntegrationAppCreateBody

Body for creating an integration app

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

| `name` | string | Yes | Name of the integration app |

| `description` | string | No | Description of the integration app |

| `available_app` | string | Yes | Available app reference |

| `company_namespace` | string | Yes | Company namespace |

| `config` | object | No | Configuration settings for the integration |

| `credentials` | object | No | Credentials for the integration |

| `endpoints` | object | No | API endpoints configuration |

| `webhooks` | object | No | Webhook configuration |

| `sync_settings` | object | No | Synchronization settings |

| `integration_meta` | object | No | Integration metadata |

### IntegrationAppCreateResult

Result of creating an integration app

### IntegrationAppGetResult

Result of getting an integration app

### IntegrationAppUpdateBody

Body for updating an integration app

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

| `name` | string | No | Name of the integration app |

| `description` | string | No | Description of the integration app |

| `status` | string | No | Status of the integration app |

| `config` | object | No | Configuration settings for the integration |

| `credentials` | object | No | Credentials for the integration |

| `endpoints` | object | No | API endpoints configuration |

| `webhooks` | object | No | Webhook configuration |

| `sync_settings` | object | No | Synchronization settings |

| `integration_meta` | object | No | Integration metadata |

### IntegrationAppUpdateResult

Result of updating an integration app

## TypeScript Usage

See [integration-app-examples.md](./integration-app-examples.md) for detailed TypeScript usage examples.
