Release an IP address

Release an IP address from its organization.

DELETE

https://api.katapult.io/core/v1/ip_addresses/{ip_address}

If successful, this endpoint will return a 200 OK status.

Scopes

One of the following scopes are required to use this endpoint.

The following arguments are supported for this endpoint.

Name	Type	Default Value
ip_address Required The IP address to unassign	IP Address Lookup	None

Name

Type

Default Value

ip_address Required

The IP address to unassign

None

The following errors may occur during this request.

Details	HTTP status
ip_address_not_found No IP addresses were found matching any of the criteria provided in the arguments	404 Not Found
permission_denied The authenticated identity is not permitted to perform this action	403 Forbidden
resource_does_not_support_unallocation The resource this IP address belongs to does not allow you to unallocate it.	409 Conflict

Details

HTTP status

No IP addresses were found matching any of the criteria provided in the arguments

404 Not Found

The authenticated identity is not permitted to perform this action

403 Forbidden

The resource this IP address belongs to does not allow you to unallocate it.

409 Conflict

When the request is successful, you can expect an object matching the specification below to be returned.

{
}