--- updatedAt: 2026-05-29T09:20:09.000Z agentTools: projectIndex: https://developer.katanamrp.com/llms.txt --- # Update a sales return row Updates the specified sales return row by setting the values of the parameters passed. Any parameters not provided will be left unchanged. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "RESOURCES", "version": "1.0.0", "description": "public api" }, "servers": [ { "url": "https://api.katanamrp.com/v1" } ], "security": [ { "bearerAuth": [] } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" } } }, "paths": { "/sales_return_rows/{id}": { "patch": { "summary": "Update a sales return row", "tags": [ "Sales return row" ], "description": "Updates the specified sales return row by setting the values of the parameters passed.\n Any parameters not provided will be left unchanged. ", "operationId": "updateSalesReturnRow", "parameters": [ { "name": "id", "required": true, "description": "Sales return row id", "schema": { "type": "integer" }, "in": "path" } ], "requestBody": { "description": "sales return fields to be updated with new values", "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "quantity": { "type": "string", "description": "New quantity of the sales return row. Updatable only when current return status is NOT_RETURNED.", "nullable": false }, "restock_location_id": { "type": "integer", "description": "Restock location id. Updatable only when current return status is NOT_RETURNED or RETURNED.", "maximum": 2147483647 }, "reason_id": { "type": "integer", "description": "Reason id. Updatable only when current return status is NOT_RETURNED.", "maximum": 2147483647 }, "batch_transactions": { "type": "array", "description": "Batch transactions. Updatable only when current return status is NOT_RETURNED or RETURNED.", "minItems": 1, "items": { "type": "object", "required": [ "batch_id", "quantity" ], "properties": { "batch_id": { "type": "integer", "description": "Batch id", "maximum": 2147483647 }, "quantity": { "type": "number", "description": "Quantity", "maximum": 100000000000000000 } } } } } } } } }, "responses": { "200": { "description": "Sales return row updated", "headers": { "X-Ratelimit-Limit": { "description": "Number of requests available for this application.", "schema": { "type": "number" } }, "X-Ratelimit-Remaining": { "description": "Number of requests remaining in quota.", "schema": { "type": "number" } }, "X-Ratelimit-Reset": { "description": "The timestamp when the quota will reset.", "schema": { "type": "number" } } }, "content": { "application/json": { "example": { "id": 764, "sales_return_id": 1147, "variant_id": 19789420, "fulfillment_row_id": 30048990, "sales_order_row_id": 41899179, "quantity": "2.00", "net_price_per_unit": "2.0000000000", "reason_id": 123, "restock_location_id": 26331, "batch_transactions": [ { "batch_id": 2288104, "quantity": 1 } ], "created_at": "2025-02-07T07:51:27.145Z", "updated_at": "2025-02-07T07:51:27.145Z" } } } }, "401": { "description": "Make sure you've entered your API token correctly.", "headers": { "X-Ratelimit-Limit": { "description": "Number of requests available for this application.", "schema": { "type": "number" } }, "X-Ratelimit-Remaining": { "description": "Number of requests remaining in quota.", "schema": { "type": "number" } }, "X-Ratelimit-Reset": { "description": "The timestamp when the quota will reset.", "schema": { "type": "number" } } }, "content": { "application/json": { "example": { "statusCode": 401, "name": "UnauthorizedError", "message": "Unauthorized" } } } }, "404": { "description": "Make sure data is correct", "headers": { "X-Ratelimit-Limit": { "description": "Number of requests available for this application.", "schema": { "type": "number" } }, "X-Ratelimit-Remaining": { "description": "Number of requests remaining in quota.", "schema": { "type": "number" } }, "X-Ratelimit-Reset": { "description": "The timestamp when the quota will reset.", "schema": { "type": "number" } } }, "content": { "application/json": { "example": { "statusCode": 404, "name": "NotFoundError", "message": "Not found" } } } }, "422": { "description": "Check the details property for a specific error message.", "headers": { "X-Ratelimit-Limit": { "description": "Number of requests available for this application.", "schema": { "type": "number" } }, "X-Ratelimit-Remaining": { "description": "Number of requests remaining in quota.", "schema": { "type": "number" } }, "X-Ratelimit-Reset": { "description": "The timestamp when the quota will reset.", "schema": { "type": "number" } } }, "content": { "application/json": { "example": { "statusCode": 422, "name": "UnprocessableEntityError", "message": "The request body is invalid. See error object `details` property for more info.", "code": "VALIDATION_FAILED", "details": [ { "path": ".name", "code": "maxLength", "message": "should NOT be longer than 10 characters", "info": { "limit": 10 } } ] } } } }, "429": { "description": "The rate limit has been reached. Please try again later.", "headers": { "X-Ratelimit-Limit": { "description": "Number of requests available for this application.", "schema": { "type": "number" } }, "X-Ratelimit-Remaining": { "description": "Number of requests remaining in quota.", "schema": { "type": "number" } }, "X-Ratelimit-Reset": { "description": "The timestamp when the quota will reset.", "schema": { "type": "number" } } }, "content": { "application/json": { "example": { "statusCode": 429, "name": "TooManyRequests", "message": "Too Many Requests" } } } }, "500": { "description": "The server encountered an error. If this persists, please contact support", "headers": { "X-Ratelimit-Limit": { "description": "Number of requests available for this application.", "schema": { "type": "number" } }, "X-Ratelimit-Remaining": { "description": "Number of requests remaining in quota.", "schema": { "type": "number" } }, "X-Ratelimit-Reset": { "description": "The timestamp when the quota will reset.", "schema": { "type": "number" } } }, "content": { "application/json": { "example": { "statusCode": 500, "name": "InternalServerError", "message": "Internal Server Error" } } } } } } } }, "x-explorer-enabled": false, "x-samples-enabled": true, "x-samples-languages": [ "curl", "node", "go", "ruby", "python", "php" ], "x-headers": [ { "key": "Authorization", "value": "Bearer " } ] } ```