curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/locations/b2c3d4e5-f6a7-8901-bcde-f12345678901' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"notes": "Added warehouse function"
}'
{
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"notes": "Added warehouse function"
}
{
"is_active": false,
"end_date": "2025-06-30"
}
{
"message": "Successfully updated location.",
"data": {
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"address": {
"address_line_1": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "US"
},
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"is_primary": true,
"is_active": true,
"start_date": "2024-01-01",
"notes": "Added warehouse function",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-03-01T09:00:00Z"
}
}
{
"error": {
"type": "LOCATION_NOT_FOUND",
"title": "Location not found.",
"detail": {
"description": "The location does not exist or you don't have access."
},
"status": 404,
"instance": "/api/v1/locations/b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}
Locations
Update location
Update a location’s details
POST
/
api
/
v1
/
locations
/
{location_id}
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/locations/b2c3d4e5-f6a7-8901-bcde-f12345678901' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"notes": "Added warehouse function"
}'
{
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"notes": "Added warehouse function"
}
{
"is_active": false,
"end_date": "2025-06-30"
}
{
"message": "Successfully updated location.",
"data": {
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"address": {
"address_line_1": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "US"
},
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"is_primary": true,
"is_active": true,
"start_date": "2024-01-01",
"notes": "Added warehouse function",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-03-01T09:00:00Z"
}
}
{
"error": {
"type": "LOCATION_NOT_FOUND",
"title": "Location not found.",
"detail": {
"description": "The location does not exist or you don't have access."
},
"status": 404,
"instance": "/api/v1/locations/b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}
Update a location’s address, types, active status, or date range.
Path parameters
string
required
The unique identifier (UUID) of the location to update.
Request body
object
Updated address. If provided,
country is required within the address object.array
Updated array of location types. Minimum 1 type if provided.
boolean
Whether this is the primary location.
string
Updated start date (YYYY-MM-DD).
string
Updated end date (YYYY-MM-DD).
boolean
Whether the location is active.
string
Updated notes.
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/locations/b2c3d4e5-f6a7-8901-bcde-f12345678901' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"notes": "Added warehouse function"
}'
{
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"notes": "Added warehouse function"
}
{
"is_active": false,
"end_date": "2025-06-30"
}
{
"message": "Successfully updated location.",
"data": {
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"corporation_id": "550e8400-e29b-41d4-a716-446655440000",
"address": {
"address_line_1": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"postal_code": "94105",
"country": "US"
},
"location_types": ["HEADQUARTERS", "REGISTERED_OFFICE", "WAREHOUSE"],
"is_primary": true,
"is_active": true,
"start_date": "2024-01-01",
"notes": "Added warehouse function",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-03-01T09:00:00Z"
}
}
{
"error": {
"type": "LOCATION_NOT_FOUND",
"title": "Location not found.",
"detail": {
"description": "The location does not exist or you don't have access."
},
"status": 404,
"instance": "/api/v1/locations/b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}
Was this page helpful?
⌘I