> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seyaha.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Products & Catalog

> View and manage your synced products in the Seyaha partner dashboard.

The **Products** page shows all activities that Seyaha has synced from your OCTO API.
Each product corresponds to one activity visible to customers on Seyaha.

## Products list

Navigate to **Products** in the left sidebar. The table shows:

| Column           | Description                                                 |
| ---------------- | ----------------------------------------------------------- |
| **Name**         | Activity title (editable by Seyaha admins after first sync) |
| **External ID**  | Your `product.id` from the OCTO response                    |
| **Variations**   | Count of options synced from your API                       |
| **Status**       | `Active`, `Inactive`, or `Pending sync`                     |
| **Last synced**  | Timestamp of the most recent successful sync                |
| **Availability** | Whether live availability data is being fetched             |

### Filtering and search

Use the search bar to find a product by name or external ID.
Use the **Status** filter to narrow results to `Active` or `Inactive` products only.

## Sync status indicators

Each product row displays one of four states:

| State         | Meaning                                                           |
| ------------- | ----------------------------------------------------------------- |
| `Synced`      | Product and availability are up to date                           |
| `Sync failed` | Last sync attempt returned an error — hover the badge for details |
| `Pending`     | Awaiting next scheduled sync                                      |
| `Excluded`    | Manually excluded from syncing by a Seyaha admin                  |

A red badge on the **Products** page title indicates one or more products have sync errors.
Click **View errors** to open the error log with timestamps and HTTP response codes from
your API.

## Triggering a manual sync

You do not need to wait for the nightly scheduled sync. To sync immediately:

1. Go to **Products**
2. Click **Sync now** in the top-right corner
3. Seyaha calls your `GET /products` and `POST /availability` endpoints in sequence

The sync typically completes within a few minutes depending on catalog size.
You can also trigger a sync programmatically — see [Sync & Webhooks](/pages/partner/sync).

<Note>
  Manual sync triggers are rate-limited to once every 15 minutes per integration
  to prevent overloading your API.
</Note>

## Product detail view

Click any product row to open the detail panel. It has three tabs:

### Overview tab

* **Activity title** — the name displayed to customers on Seyaha (may differ from your `internalName`)
* **Description** — added or edited by Seyaha admins, not sourced from your API
* **Media** — photos managed by Seyaha (your OCTO API does not serve media)
* **Variations** — each OCTO option with its pricing, units, and availability type

### Availability tab

* A 60-day calendar showing synced slots
* Slot-level details: date, time, vacancies, status (`AVAILABLE`, `LIMITED`, `SOLD_OUT`, etc.)
* Any overrides applied by Seyaha admins to individual slots

### Sync log tab

* Chronological log of sync attempts for this product
* HTTP status codes and response times from your API
* Full error messages for failed attempts, including the raw response body

## What Seyaha controls vs. what you control

| Data                              | Controlled by                       |
| --------------------------------- | ----------------------------------- |
| Activity title (after first sync) | Seyaha admins                       |
| Description, photos, tags         | Seyaha admins                       |
| Pricing, unit types, availability | Your OCTO API (refreshed each sync) |
| Product/option IDs                | Your OCTO API — never change these  |

<Warning>
  Never change your `product.id` or `option.id` values after your first sync.
  Seyaha uses them as permanent deduplication keys. Changing them causes duplicate
  activities to be created.
</Warning>

## Requesting changes to product content

If you need changes to the Seyaha-controlled fields (title, description, media),
submit a request via **Support** in the left sidebar. Include the product name,
your external product ID, and the specific change needed.