> For the complete documentation index, see [llms.txt](https://docs.flowretail.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowretail.com/docs/developers/api-documentation/warehouse/update-warehouse-details.md).

# Update warehouse details

Update details for a warehouse. Partial updates are allowed.

Required permissions: WAREHOUSE

```json
{"openapi":"3.0.2","info":{"title":"Flow Retail API version 2","version":"2.0.0"},"tags":[{"name":"Warehouse","description":"Warehouse"}],"servers":[{"description":"Flow Retail Production","url":"https://api.flowretail.com/v2"},{"description":"Flow Retail Stage","url":"https://api.stage.flowretail.com/v2"}],"security":[{"accessToken":[]},{"authToken":[]},{"integrationToken":[]}],"components":{"securitySchemes":{"accessToken":{"description":"Access token recevied after user login with a deviceToken","scheme":"bearer","type":"http"},"authToken":{"description":"Token received from the auth service","scheme":"bearer","type":"http"},"integrationToken":{"scheme":"bearer","type":"http"}},"requestBodies":{"WarehouseUpdateRequest":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseUpdateRequestSchema"}}}}},"schemas":{"WarehouseUpdateRequestSchema":{"title":"WarehouseUpdateRequestSchema","type":"object","properties":{"externalId":{"type":"string"},"name":{"type":"string"}},"required":["name"]},"WarehouseResponseSchema":{"title":"WarehouseResponseSchema","type":"object","properties":{"createdAt":{"format":"date-time","type":"string"},"externalId":{"type":"string"},"lastModifiedAt":{"format":"date-time","type":"string"},"name":{"type":"string"},"warehouseUid":{"$ref":"#/components/schemas/UID"},"accessList":{"type":"array","description":"The access grants on this warehouse: one entry per store and role that has been granted, the owning store's own rows among them — creating a warehouse grants the owner every role. On these entries storeUid and storeName name the store the grant was given to.","items":{"$ref":"#/components/schemas/MyWarehouseAccessResponseSchema"}}},"required":["createdAt","externalId","lastModifiedAt","name","warehouseUid","accessList"]},"UID":{"title":"UID","type":"string","pattern":"^[A-Za-z0-9-_]+"},"MyWarehouseAccessResponseSchema":{"title":"MyWarehouseAccessResponseSchema","description":"One access grant on a warehouse: which warehouse, which store the entry names, and what the grant allows.\nWhich store the entry names depends on where it is read. In a store's warehouse access list, storeUid and storeName name the store that owns the warehouse — the store itself on its own warehouses, another store on a warehouse it has been granted access to. In a warehouse's accessList they name the store the grant was given to, the owner's own rows among them.","type":"object","properties":{"role":{"allOf":[{"$ref":"#/components/schemas/WarehouseAccessRoleENUM"}],"description":"What the grant allows the store holding it to do with the warehouse's stock."},"storeUid":{"allOf":[{"$ref":"#/components/schemas/UID"}],"description":"In a store's warehouse access list: the store that owns the warehouse — the store itself on its own warehouses, which the create grants it every role on, and another store on a warehouse that store has granted it access to. In a warehouse's accessList: the store the grant was given to."},"storeName":{"type":"string","description":"The name of the store storeUid names — the owner of the warehouse in a store's warehouse access list, the store holding the grant in a warehouse's accessList."},"warehouseUid":{"allOf":[{"$ref":"#/components/schemas/UID"}],"description":"The warehouse the grant is on."},"warehouseName":{"type":"string","description":"The name of that warehouse."},"warehouseAccessUid":{"allOf":[{"$ref":"#/components/schemas/UID"}],"description":"The grant itself, as its own record."}},"required":["role","storeUid","storeName","warehouseUid","warehouseName","warehouseAccessUid"]},"WarehouseAccessRoleENUM":{"description":"|ENUM      | Description |\n| ---------------- | ------------ |\n| DELIVER | Can deliver products using stock from this warehouse. |\n| MOVE | Can move stock to and from this warehouse. |\n| RECEIVE | Can receive purchase orders to this warehouse. |\n| RESERVE | Can make stock reservations from this warehouse. |\n| RETURN | Can return stock to this warehouse. |\n| SHIP | Can reserve stock in this warehouse so the owning store ships it to the customer. |\n| VIEW | Only able to view quantity.|","enum":["DELIVER","MOVE","RECEIVE","RESERVE","RETURN","SHIP","VIEW"],"title":"WarehouseAccessRoleENUM","type":"string"}},"responses":{"WarehouseResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseResponseSchema"}}},"description":"Example response"}}},"paths":{"/tenants/{tenantUid}/stores/{storeUid}/warehouses/{warehouseUid}":{"put":{"description":"Update details for a warehouse. Partial updates are allowed.\n\nRequired permissions: WAREHOUSE","operationId":"put-tenants-stores-warehouses-details","requestBody":{"$ref":"#/components/requestBodies/WarehouseUpdateRequest"},"responses":{"200":{"$ref":"#/components/responses/WarehouseResponse"}},"summary":"Update warehouse details","tags":["Warehouse"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flowretail.com/docs/developers/api-documentation/warehouse/update-warehouse-details.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.