DELETE /stocks/warehouses/{warehouseId}

Delete a warehouse

Deletes a specific Warehouse and its associated stock. Before deleting, ensure any related operators and ongoing purchases are handled using the 'associations' parameter. If 'associations' is not provided and the warehouse has linked operators or purchases, the deletion will fail to prevent data loss. Important: To avoid deleting the stock, you must transfer it to another warehouse before deleting this one.

Operation ID: deleteStockWarehouse

lock This endpoint requires a Bearer token in the Authorization header.

Path Parameters

Name Type Description

Name	Type	Description
`warehouseId` required path	string	The unique identifier of the warehouse within the system. This ID is immutable and assigned upon creation. Example: `1`

warehouseId required

path

string

The unique identifier of the warehouse within the system. This ID is immutable and assigned upon creation.

Example: 1

Query Parameters

Name Type Description

Name	Type	Description
`associations` query	string	A comma-separated list of dependencies (related resources). `operators` `purchases`
`destinationWarehouseId` query	integer	The ID of the target warehouse to which associated resources (operators or purchases) should be moved when deleting the current warehouse. Example: `1`

associations

query

string

A comma-separated list of dependencies (related resources).

operators purchases

destinationWarehouseId

query

integer

The ID of the target warehouse to which associated resources (operators or purchases) should be moved when deleting the current warehouse.

Example: 1

Responses

status string

error

error object

http_code integer

400

message string

more_info string

status string

error

error object

http_code integer

401

message string

Example: Authentication token invalid.

more_info string

status string

error

error object

http_code integer

404

message string

Example: Resource not found

more_info string | null

status string

error

error object

http_code integer

429

message string

Example: Too Many Requests.

more_info string

status string

error

error object

http_code integer

500

message string

Example: An error has occurred during the request.

more_info string

play_circle Try It

Environment

Authorization

Bearer

Path Parameters

warehouseId

DELETE https://api.sandbox.infraspeak.com/v3/stocks/warehouses/1?destinationWarehouseId=1

curl -X DELETE \
  'https://api.sandbox.infraspeak.com/v3/stocks/warehouses/1?destinationWarehouseId=1' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

const response = await fetch('https://api.sandbox.infraspeak.com/v3/stocks/warehouses/1?destinationWarehouseId=1', {
  method: 'DELETE',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN',
  },
});

const data = await response.json();

$response = Http::withHeaders([
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
])->withToken('YOUR_API_TOKEN')
  ->delete('https://api.sandbox.infraspeak.com/v3/stocks/warehouses/1?destinationWarehouseId=1');

import requests

response = requests.delete(
    'https://api.sandbox.infraspeak.com/v3/stocks/warehouses/1?destinationWarehouseId=1',
    headers={
        'Accept': 'application/json',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_TOKEN',
    },
)

data = response.json()

data_object Example Response

400 The request to delete the warehouse could not be fulfilled due to existing dependencies that prevent deletion without specific handling.

{
    "status": "error",
    "error": {
        "http_code": 400,
        "message": "string",
        "more_info": "string"
    }
}

401 Unauthorized. Authentication or permission error. E.g.: missing, incorrect or invalid Access Token.

{
    "status": "error",
    "error": {
        "http_code": 401,
        "message": "Authentication token invalid.",
        "more_info": "string"
    }
}

404 Resource Not Found. Requests to resources that don't exist or are malformed.

{
    "status": "error",
    "error": {
        "http_code": 404,
        "message": "Resource not found",
        "more_info": "string"
    }
}

429 Too Many Requests. The client has sent too many requests in a given amount of time (check Throttling section).

{
    "status": "error",
    "error": {
        "http_code": 429,
        "message": "Too Many Requests.",
        "more_info": "string"
    }
}

500 Internal Server Error. Please, report us and try to provide as much information as possible, such as the endpoint, HTTP request headers and request body if applicable.

{
    "status": "error",
    "error": {
        "http_code": 500,
        "message": "An error has occurred during the request.",
        "more_info": "string"
    }
}