# Retailgrid Documentation

> Organize, enrich and optimize your products with AI.

## Docs

- [Agents overview](https://docs.retailgrid.io/agents/overview.md): What agents are in Retailgrid, the agents available today, and the workflows that work the same way across all of them.
- [Price Optimization](https://docs.retailgrid.io/agents/price-optimization.md): AI-powered optimal price recommendations using elasticity and demand signals - suggested prices, not written rules.
- [Pricing Strategy](https://docs.retailgrid.io/agents/pricing-strategy.md): Generate an AI-powered pricing strategy presentation directly from your retail data, ready to share with stakeholders.
- [Rules Based Pricing](https://docs.retailgrid.io/agents/rules-based-pricing.md): Configure pricing rules and apply them deterministically across a grid - margin floors, competitor matching, rounding, and more.
- [Sales Forecast](https://docs.retailgrid.io/agents/sales-forecast.md): Predictive analytics that estimates future sales by SKU - demand planning, seasonality, capacity decisions.
- [Verify API key](https://docs.retailgrid.io/api-reference/auth/verify.md): Validate a Retailgrid API key and confirm the authenticated account, environment, and key permissions before making other API calls.
- [Authentication](https://docs.retailgrid.io/api-reference/authentication.md): How to issue an API key and authenticate requests against the Retailgrid Public API.
- [API changelog](https://docs.retailgrid.io/api-reference/changelog.md): Release notes for the Retailgrid Public API, including new endpoints, breaking changes, and version updates across each release.
- [Bulk upsert competitor prices](https://docs.retailgrid.io/api-reference/competitor-prices/bulk-upsert.md): Create or update many competitor price observations in Retailgrid in a single request, ideal for syncing large feeds from scraping providers.
- [Create a competitor price](https://docs.retailgrid.io/api-reference/competitor-prices/create.md): Record a single competitor price observation in Retailgrid, capturing the competitor, product match, price, currency, and observation date.
- [Delete a competitor price](https://docs.retailgrid.io/api-reference/competitor-prices/delete.md): Permanently remove a competitor price observation from Retailgrid by its entity ID, useful for correcting erroneous or duplicate data points.
- [Patch a competitor price](https://docs.retailgrid.io/api-reference/competitor-prices/patch.md): Update specific fields on an existing competitor price observation in Retailgrid without overwriting the full record, identified by entity ID.
- [Conventions](https://docs.retailgrid.io/api-reference/conventions.md): Patterns every Retailgrid API endpoint follows - bulk responses, async jobs, identifiers, decimals, and timestamps.
- [Errors](https://docs.retailgrid.io/api-reference/errors.md): Status codes used by the Retailgrid Public API and the shape of validation errors.
- [Imports vs bulk](https://docs.retailgrid.io/api-reference/imports-vs-bulk.md): Choosing between async CSV imports and synchronous JSON bulk endpoints.
- [Import competitor prices CSV](https://docs.retailgrid.io/api-reference/imports/competitor-prices.md): Upload a CSV file of competitor prices to Retailgrid for asynchronous import, returning a job ID to track ingestion progress.
- [Import products CSV](https://docs.retailgrid.io/api-reference/imports/products.md): Upload a CSV file of products to Retailgrid for asynchronous import, returning a job ID you can use to track ingestion progress.
- [Import transactions CSV](https://docs.retailgrid.io/api-reference/imports/transactions.md): Upload a CSV file of sales transactions to Retailgrid for asynchronous import, returning a job ID to track ingestion progress.
- [Introduction](https://docs.retailgrid.io/api-reference/introduction.md): The Retailgrid Public API lets you push products, variants, transactions, and competitor prices into Retailgrid programmatically - and pull job status back.
- [Get job status](https://docs.retailgrid.io/api-reference/jobs/get-status.md): Check the progress, state, and results of an asynchronous Retailgrid job such as a bulk upsert or CSV import operation.
- [Bulk upsert product variants](https://docs.retailgrid.io/api-reference/product-variants/bulk-upsert.md): Create or update many product variants in Retailgrid in a single request, ideal for syncing large variant catalogs from external systems.
- [Create a product variant](https://docs.retailgrid.io/api-reference/product-variants/create.md): Create a single product variant in Retailgrid for a specific entity, capturing size, color, or other variant-level attributes.
- [Delete a product variant](https://docs.retailgrid.io/api-reference/product-variants/delete.md): Permanently remove a product variant from Retailgrid by its entity ID, useful for cleaning up discontinued sizes, colors, or SKUs.
- [Patch a product variant](https://docs.retailgrid.io/api-reference/product-variants/patch.md): Update specific fields on an existing product variant in Retailgrid without overwriting the full record, identified by entity ID.
- [Bulk upsert products](https://docs.retailgrid.io/api-reference/products/bulk-upsert.md): Create or update many products in Retailgrid in a single request, ideal for syncing large product catalogs from external systems.
- [Create a product](https://docs.retailgrid.io/api-reference/products/create.md): Create a single product record in Retailgrid for a specific entity, including its SKU, attributes, and category metadata.
- [Delete a product](https://docs.retailgrid.io/api-reference/products/delete.md): Permanently remove a product from Retailgrid by its entity ID, useful for cleaning up discontinued or duplicated SKUs.
- [Patch a product](https://docs.retailgrid.io/api-reference/products/patch.md): Update specific fields on an existing product in Retailgrid without overwriting the full record, identified by its entity ID.
- [API quickstart](https://docs.retailgrid.io/api-reference/quickstart.md): From zero to your first product upserted via the API in under five minutes.
- [Bulk upsert transactions](https://docs.retailgrid.io/api-reference/transactions/bulk-upsert.md): Create or update many sales transactions in a single Retailgrid request, ideal for syncing large batches of POS or order history data.
- [Create a transaction](https://docs.retailgrid.io/api-reference/transactions/create.md): Create a single sales transaction in Retailgrid for a specific entity, recording the line item, quantity, price, and date.
- [Delete a transaction](https://docs.retailgrid.io/api-reference/transactions/delete.md): Permanently remove a sales transaction from Retailgrid by entity ID, useful for correcting erroneous or duplicate sales records.
- [Patch a transaction](https://docs.retailgrid.io/api-reference/transactions/patch.md): Update one or more fields on an existing sales transaction in Retailgrid without replacing the full record for the given entity.
- [Product updates](https://docs.retailgrid.io/changelog/product-updates.md): See the latest Retailgrid releases, including new features, improvements, and bug fixes in each update cycle.
- [Competitor Prices](https://docs.retailgrid.io/data-requirements/competitors.md): The Competitor Prices dataset allows you to upload, monitor, and analyze competitor pricing at SKU level over time.
- [Datasets](https://docs.retailgrid.io/data-requirements/datasets.md): Manage the product, transaction, and competitor data you have uploaded to Retailgrid in one place.
- [Product Store Data](https://docs.retailgrid.io/data-requirements/product-store-data.md): The Product Store-Level dataset allows you to provide product information at store, market, or sales-channel level.
- [Products](https://docs.retailgrid.io/data-requirements/products.md): Upload your product master data including IDs, names, prices, costs, and attributes to power Retailgrid analytics.
- [Sales](https://docs.retailgrid.io/data-requirements/sales.md): Upload transaction-level sales data to power analytics, elasticity modeling, and price optimization in Retailgrid.
- [Retailgrid](https://docs.retailgrid.io/get-started/overview.md): Learn what Retailgrid is, who it's built for, and how it helps retailers organize, enrich, and optimize pricing data.
- [Quickstart](https://docs.retailgrid.io/get-started/quickstart.md): Get started with Retailgrid in minutes by uploading your product CSV, mapping fields, and creating your first grid.
- [Configure Grid](https://docs.retailgrid.io/grids/configure-grid.md): Customize your grid layout by choosing visible columns, sorting, grouping, pinning, filtering, and saving views.
- [Create Grid](https://docs.retailgrid.io/grids/create-grid.md): Create a new grid by selecting products from your catalog to build a focused pricing and analysis workspace.
- [Export Data](https://docs.retailgrid.io/grids/export.md): Download your grid data as CSV or Excel files, with filters and sorting applied, for analysis or sharing.
- [Formula Columns](https://docs.retailgrid.io/grids/formula-columns.md): Create calculated columns using formulas, functions, and AI to compute margins, revenue, and other pricing metrics.
- [Add columns](https://docs.retailgrid.io/grids/manage-columns.md): Add custom standard, formula, single-select, or analytical-metric columns to your grid for notes, calculations, status pills, margin analysis, and more.
- [Metrics](https://docs.retailgrid.io/grids/metrics.md): Add curated, system-maintained retail KPIs to your grid in any timeframe — sales, value, profit, and margin per period.
- [Custom Columns](https://docs.retailgrid.io/grids/srg-2-fixes.md): Add editable custom columns to any workbook grid — text, number, currency, or formula.
- [Views](https://docs.retailgrid.io/grids/views.md): Save and switch between custom grid layouts to quickly access different column, filter, and sorting configurations.
- [Shopify](https://docs.retailgrid.io/integrations/shopify.md): Connect your Shopify store to Retailgrid to sync products, prices, and inventory for pricing optimization.
- [Metrics glossary](https://docs.retailgrid.io/reference/metrics.md): Reference for every analytical metric Retailgrid computes - definitions, formulas, and when each one matters.
- [Runs overview](https://docs.retailgrid.io/runs/overview.md): Track every asynchronous job - CSV imports, agent runs, optimization, dataset processing - from one place.
- [Account](https://docs.retailgrid.io/settings/account.md): Manage your personal Retailgrid account - profile, login method, and personal preferences.
- [Currency](https://docs.retailgrid.io/settings/currency.md): How Retailgrid resolves currency for prices, costs, and metrics.
- [Getting help](https://docs.retailgrid.io/settings/getting-help.md): How to reach the Retailgrid team - in-app messenger, what to expect, and where to file feedback.
- [Organization](https://docs.retailgrid.io/settings/organization.md): Configure your Retailgrid workspace - company name, defaults, and team members.
- [Session and security](https://docs.retailgrid.io/settings/session.md): How Retailgrid handles login sessions, inactivity, and auto-logout.
- [Super Admin](https://docs.retailgrid.io/settings/super-admin.md): The internal Retailgrid staff role for entering customer accounts during demos, validation, and support, with audited impersonation.

## OpenAPI Specs

- [openapi](https://docs.retailgrid.io/api-reference/openapi.json)