# Retrac Docs

## Docs

- [Authentication](https://docs.retrac.co/api-reference/authentication.md): Authenticate API requests with workspace API keys and scoped permissions.
- [Bulk create items](https://docs.retrac.co/api-reference/endpoint/bulk-create-items.md): Bulk create up to 100 items for the authenticated workspace.
- [Create a location](https://docs.retrac.co/api-reference/endpoint/create-a-location.md): Create a new storage location in the authenticated workspace. Requires `locations.write` scope. Workspace owners only when the token user has restricted location access.
- [Create a new item](https://docs.retrac.co/api-reference/endpoint/create-a-new-item.md): Create a new item for the authenticated workspace.
- [Create a new tag](https://docs.retrac.co/api-reference/endpoint/create-a-new-tag.md): Create a new tag for the authenticated workspace.
- [Create a workspace](https://docs.retrac.co/api-reference/endpoint/create-a-new-workspace.md): Create a new workspace for the authenticated user.
- [Create a transfer](https://docs.retrac.co/api-reference/endpoint/create-a-transfer.md): Move stock between two locations instantly. Requires sufficient on-hand quantity at the source location and `transfers.write` scope. Counts toward your workspace transfer limit.
- [Delete a location](https://docs.retrac.co/api-reference/endpoint/delete-a-location.md): Delete a location. Fails if the location still has on-hand stock or is the workspace default location. Requires `locations.write` scope.
- [Delete an item](https://docs.retrac.co/api-reference/endpoint/delete-an-item.md): Delete an item for the authenticated workspace.
- [List inventory balances](https://docs.retrac.co/api-reference/endpoint/list-inventory-balances.md): Retrieve on-hand quantities per item and location. Requires `inventory.read` scope. Results respect location access for restricted members.
- [List inventory movements](https://docs.retrac.co/api-reference/endpoint/list-inventory-movements.md): Retrieve the append-only stock ledger for the workspace. Requires `inventory.read` scope.
- [List transfers](https://docs.retrac.co/api-reference/endpoint/list-transfers.md): Retrieve transfer orders for the workspace. Requires `transfers.read` scope.
- [Retrieve a list of items](https://docs.retrac.co/api-reference/endpoint/retrieve-a-list-of-items.md): Retrieve a paginated list of items for the authenticated workspace.
- [Retrieve a list of locations](https://docs.retrac.co/api-reference/endpoint/retrieve-a-list-of-locations.md): Retrieve a paginated list of locations for the authenticated workspace.
- [Retrieve a list of tags](https://docs.retrac.co/api-reference/endpoint/retrieve-a-list-of-tags.md): Retrieve a list of tags for the authenticated workspace.
- [Retrieve a list of workspaces](https://docs.retrac.co/api-reference/endpoint/retrieve-a-list-of-workspaces.md): Retrieve a list of workspaces for the authenticated user.
- [Retrieve a location](https://docs.retrac.co/api-reference/endpoint/retrieve-a-location.md): Retrieve a single location by ID.
- [Retrieve a transfer](https://docs.retrac.co/api-reference/endpoint/retrieve-a-transfer.md): Retrieve a single transfer order by ID, including line items, locations, and related movements. Requires `transfers.read` scope.
- [Retrieve a workspace](https://docs.retrac.co/api-reference/endpoint/retrieve-a-workspace.md): Retrieve a workspace for the authenticated user.
- [Retrieve an item](https://docs.retrac.co/api-reference/endpoint/retrieve-an-item.md): Retrieve the info for an item.
- [Retrieve the number of items](https://docs.retrac.co/api-reference/endpoint/retrieve-number-of-items.md): Retrieve the number of items for the authenticated workspace. The provided query parameters allow filtering the returned items.
- [Retrieve the number of locations](https://docs.retrac.co/api-reference/endpoint/retrieve-number-of-locations.md): Retrieve the number of locations for the authenticated workspace. Query parameters filter the count. Requires `locations.read` scope.
- [Revert a transfer](https://docs.retrac.co/api-reference/endpoint/revert-a-transfer.md): Undo a completed transfer and restore prior stock levels. Only workspace owners can revert. Requires `transfers.write` scope.
- [Set on-hand stock](https://docs.retrac.co/api-reference/endpoint/set-on-hand-stock.md): Set the absolute on-hand quantity for an item at a location. Creates an opening or adjustment movement in the ledger. Requires `inventory.write` scope.
- [Update a location](https://docs.retrac.co/api-reference/endpoint/update-a-location.md): Update a location's name, type, note, or active status. Requires `locations.write` scope.
- [Update an item](https://docs.retrac.co/api-reference/endpoint/update-an-item.md): Update an item for the authenticated workspace. If there's no change, returns it as it is.
- [Errors](https://docs.retrac.co/api-reference/errors.md): Troubleshoot problems with this comprehensive breakdown of all error codes.
- [Introduction](https://docs.retrac.co/api-reference/introduction.md): Fundamental concepts of Retrac's inventory API.
- [Rate limits](https://docs.retrac.co/api-reference/rate-limits.md): API rate limits per key and how to handle throttling.
- [Security](https://docs.retrac.co/api-reference/security.md): How Retrac secures the API and how to integrate safely.
- [Account settings](https://docs.retrac.co/dashboard/account/introduction.md): Manage your personal profile, password, and security across all workspaces.
- [API keys](https://docs.retrac.co/dashboard/api-keys/introduction.md): Create API keys to connect Retrac with your tools, scripts, and integrations.
- [Billing & plans](https://docs.retrac.co/dashboard/billing/introduction.md): Understand plans, usage limits, upgrades, and how billing works for your workspace.
- [CSV import & export](https://docs.retrac.co/dashboard/items/import-export.md): Bulk import items from a spreadsheet and export your catalog with per-location stock for backups or reporting.
- [Items](https://docs.retrac.co/dashboard/items/introduction.md): Create, search, filter, and manage the products in your inventory catalog.
- [Managing stock](https://docs.retrac.co/dashboard/items/managing-stock.md): Set opening balances, adjust on-hand quantities, and view stock across locations.
- [Locations](https://docs.retrac.co/dashboard/locations/introduction.md): Create and manage warehouses, vans, sites, and other places where you hold stock.
- [Movements](https://docs.retrac.co/dashboard/movements/introduction.md): Read the audit trail of every stock change in your workspace.
- [Security](https://docs.retrac.co/dashboard/security/introduction.md): Configure SAML SSO and SCIM provisioning for enterprise teams.
- [Tags](https://docs.retrac.co/dashboard/tags/introduction.md): Organize items with colored tags and filter your inventory faster.
- [Team & members](https://docs.retrac.co/dashboard/team/introduction.md): Invite teammates, assign roles, and control who can see which locations.
- [Transfers](https://docs.retrac.co/dashboard/transfers/introduction.md): Move stock between locations instantly and keep a clear record of every movement.
- [Workspaces](https://docs.retrac.co/dashboard/workspaces/introduction.md): Create, switch, and configure the workspace that holds your inventory and team.
- [Data model](https://docs.retrac.co/data-model.md): How workspaces, items, locations, balances, transfers, and movements relate to each other.
- [Advanced plan](https://docs.retrac.co/help/article/advanced-plan.md): Retrac Advanced plan limits and features for larger operations.
- [Azure AD SAML SSO](https://docs.retrac.co/help/article/azure-saml.md): Configure SAML single sign-on between Microsoft Entra ID (Azure AD) and Retrac.
- [Azure AD SCIM](https://docs.retrac.co/help/article/azure-scim.md): Automatically provision and deprovision Retrac users from Microsoft Entra ID.
- [Business plan](https://docs.retrac.co/help/article/business-plan.md): Retrac Business plan limits and features for growing teams.
- [Google Workspace SAML SSO](https://docs.retrac.co/help/article/google-saml.md): Configure SAML single sign-on between Google Workspace and Retrac.
- [Google Workspace SCIM](https://docs.retrac.co/help/article/google-scim.md): Automatically provision and deprovision Retrac users from Google Workspace.
- [How to create an item](https://docs.retrac.co/help/article/how-to-create-item.md): Add a product to your Retrac inventory catalog with SKU, description, cost, and optional opening stock.
- [How to get your workspace ID](https://docs.retrac.co/help/article/how-to-get-workspace-id.md): Find the workspace ID required for Retrac API requests and integrations.
- [How to invite teammates](https://docs.retrac.co/help/article/how-to-invite-teammates.md): Add owners and members to your Retrac workspace by email or invite link.
- [How to use tags](https://docs.retrac.co/help/article/how-to-use-tags.md): Create colored tags, assign them to items, and filter your inventory faster.
- [Inventory locations](https://docs.retrac.co/help/article/inventory-locations.md): Create and manage warehouses, vans, sites, and other places where you hold stock.
- [Inventory movements](https://docs.retrac.co/help/article/inventory-movements.md): Read the audit trail of every stock change in your workspace.
- [Inventory transfers](https://docs.retrac.co/help/article/inventory-transfers.md): Move stock between locations instantly and keep a clear record of every movement.
- [Okta SAML SSO](https://docs.retrac.co/help/article/okta-saml.md): Configure SAML single sign-on between Okta and Retrac.
- [Okta SCIM](https://docs.retrac.co/help/article/okta-scim.md): Automatically provision and deprovision Retrac users from Okta.
- [Pro plan](https://docs.retrac.co/help/article/pro-plan.md): Retrac Pro plan limits and features for small businesses.
- [What is a workspace?](https://docs.retrac.co/help/article/what-is-a-workspace.md): A workspace is your company's home in Retrac — one catalog, one team, one billing plan.
- [What is Retrac?](https://docs.retrac.co/help/article/what-is-retrac.md): Retrac is an inventory management platform for tracking products across locations and teams.
- [API](https://docs.retrac.co/help/category/api.md): Connect Retrac to your tools with the REST API and workspace credentials.
- [Billing](https://docs.retrac.co/help/category/billing.md): Compare Retrac plans and understand usage limits for your workspace.
- [Getting started](https://docs.retrac.co/help/category/getting-started.md): Set up your account, workspace, items, and team in Retrac.
- [Inventory](https://docs.retrac.co/help/category/inventory.md): Manage locations, transfers, stock movements, and tags in your workspace.
- [SAML SSO](https://docs.retrac.co/help/category/saml-sso.md): Configure SAML single sign-on and SCIM provisioning with your identity provider.
- [Help Center](https://docs.retrac.co/help/index.md): Find answers about inventory, workspaces, billing, SSO, and the Retrac API.
- [Integrations](https://docs.retrac.co/integrations.md): Connect Retrac with Raycast, custom tools, and upcoming automation platforms.
- [Introduction](https://docs.retrac.co/introduction.md): Retrac is an inventory management platform built for business owners and their teams.
- [Keyboard shortcuts](https://docs.retrac.co/keyboard-shortcuts.md): Speed up everyday inventory work with keyboard shortcuts in the dashboard.
- [Quick start](https://docs.retrac.co/quick-start.md): Get your workspace running: add items, set stock, create locations, and make your first transfer.

## OpenAPI Specs

- [api.retrac](https://api.retrac.co)