> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.
# IP dedicadas
> Gestionar inventario de IP dedicadas, autorización, eliminación y asignaciones de dominio.
# IP dedicadas
Gestionar inventario de IP dedicadas, autorización, eliminación y asignaciones de dominio.
Los ejemplos usan el modo de código A2A. MCP expone el mismo modo de código mediante su herramienta `execute`.
## Funciones
### `dedicated_ips.authorize`
```text theme={null}
dedicated_ips.authorize(account_id: str, dedicated_ip_id: str, reissue?: bool) -> DedicatedIP
```
IP dedicadas: `dedicated_ips.authorize`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | --------------------------------------------------------------------------------- | ----------------------- | ----------------- |
| Permiso requerido | `proxy.authorize` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `proxy.authorize` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `POST /v1/public/accounts/{account_id}/dedicated-ips/{dedicated_ip_id}/authorize` | | |
| Nombre | Tipo | Requerido |
| ----------------- | ------ | --------- |
| `account_id` | `str` | sí |
| `dedicated_ip_id` | `str` | sí |
| `reissue` | `bool` | no |
| Campo | Tipo | Requerido |
| -------------- | ------------------------------------------------------------------------------------------ | --------- |
| `id` | `str` | sí |
| `name` | `str` | sí |
| `status` | `str` | sí |
| `type` | `str` | sí |
| `asn` | `int \| null` | no |
| `country_code` | `str \| null` | no |
| `created_at` | `str \| null` | no |
| `ip_addresses` | `[{"ip": str, "fcrdns_confirmed"?: bool, "healthy"?: bool \| null, "rdns"?: str \| null}]` | no |
| `updated_at` | `str \| null` | no |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.authorize(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", reissue=true)"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.authorize",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.authorize(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", reissue=true)"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.authorize\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.available_options`
```text theme={null}
dedicated_ips.available_options(account_id: str, asn?: str | null, country_code?: str | null) -> list[DedicatedIP]
```
IP dedicadas: `dedicated_ips.available_options`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | ---------------------------------------------------------------------- | ----------------------- | -------------- |
| Permiso requerido | `proxy.create` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `proxy.create` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `GET /v1/public/accounts/{account_id}/dedicated-ips/available-options` | | |
| Nombre | Tipo | Requerido |
| -------------- | ------------- | --------- |
| `account_id` | `str` | sí |
| `asn` | `str \| null` | no |
| `country_code` | `str \| null` | no |
| Campo | Tipo | Requerido |
| -------------- | ------------------------------------------------------------------------------------------ | --------- |
| `id` | `str` | sí |
| `name` | `str` | sí |
| `asn` | `int \| null` | no |
| `country_code` | `str \| null` | no |
| `ip_addresses` | `[{"ip": str, "fcrdns_confirmed"?: bool, "healthy"?: bool \| null, "rdns"?: str \| null}]` | no |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.available_options(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", asn=\"\", country_code=\"\")"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.available_options",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.available_options(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", asn=\"\", country_code=\"\")"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.available_options\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.claim`
```text theme={null}
dedicated_ips.claim(account_id: str, option_id?: str | null) -> DedicatedIP
```
IP dedicadas: `dedicated_ips.claim`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | ----------------------------------------------------------- | ----------------------- | -------------- |
| Permiso requerido | `proxy.create` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `proxy.create` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `POST /v1/public/accounts/{account_id}/dedicated-ips/claim` | | |
| Nombre | Tipo | Requerido |
| ------------ | ------------- | --------- |
| `account_id` | `str` | sí |
| `option_id` | `str \| null` | no |
| Campo | Tipo | Requerido |
| -------------- | ------------------------------------------------------------------------------------------ | --------- |
| `id` | `str` | sí |
| `name` | `str` | sí |
| `status` | `str` | sí |
| `type` | `str` | sí |
| `asn` | `int \| null` | no |
| `country_code` | `str \| null` | no |
| `created_at` | `str \| null` | no |
| `ip_addresses` | `[{"ip": str, "fcrdns_confirmed"?: bool, "healthy"?: bool \| null, "rdns"?: str \| null}]` | no |
| `updated_at` | `str \| null` | no |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.claim(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", option_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.claim",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.claim(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", option_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.claim\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.delete`
```text theme={null}
dedicated_ips.delete(account_id: str, dedicated_ip_id: str, force?: bool) -> DedicatedIP
```
IP dedicadas: `dedicated_ips.delete`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | ------------------------------------------------------------------------- | ----------------------- | -------------- |
| Permiso requerido | `proxy.delete` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `proxy.delete` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `DELETE /v1/public/accounts/{account_id}/dedicated-ips/{dedicated_ip_id}` | | |
| Nombre | Tipo | Requerido |
| ----------------- | ------ | --------- |
| `account_id` | `str` | sí |
| `dedicated_ip_id` | `str` | sí |
| `force` | `bool` | no |
| Campo | Tipo | Requerido |
| ----------------- | ------- | --------- |
| `dedicated_ip_id` | `str` | sí |
| `domain_ids` | `[str]` | sí |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", force=true)"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {
"dedicated_ip_id": "",
"domain_ids": [
""
]
}
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.delete",
"status": "completed",
"result": {
"dedicated_ip_id": "",
"domain_ids": [
""
]
}
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.delete(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", force=true)"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {\n \"dedicated_ip_id\": \"\",\n \"domain_ids\": [\n \"\"\n ]\n }\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.delete\",\n \"status\": \"completed\",\n \"result\": {\n \"dedicated_ip_id\": \"\",\n \"domain_ids\": [\n \"\"\n ]\n }\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.domains.assign`
```text theme={null}
dedicated_ips.domains.assign(account_id: str, dedicated_ip_id: str, domain_ids?: [str]) -> DedicatedIP
```
IP dedicadas: `dedicated_ips.domains.assign`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | -------------------------------------------------------------------------------------- | ----------------------- | --------------------- |
| Permiso requerido | `domain.proxy.assign` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `domain.proxy.assign` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `POST /v1/public/accounts/{account_id}/dedicated-ips/{dedicated_ip_id}/domains/assign` | | |
| Nombre | Tipo | Requerido |
| ----------------- | ------- | --------- |
| `account_id` | `str` | sí |
| `dedicated_ip_id` | `str` | sí |
| `domain_ids` | `[str]` | no |
| Campo | Tipo | Requerido |
| ----------------- | ------- | --------- |
| `dedicated_ip_id` | `str` | sí |
| `domain_ids` | `[str]` | sí |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.domains.assign(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain_ids=\"example.com\")"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {
"dedicated_ip_id": "",
"domain_ids": [
""
]
}
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.domains.assign",
"status": "completed",
"result": {
"dedicated_ip_id": "",
"domain_ids": [
""
]
}
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.domains.assign(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain_ids=\"example.com\")"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {\n \"dedicated_ip_id\": \"\",\n \"domain_ids\": [\n \"\"\n ]\n }\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.domains.assign\",\n \"status\": \"completed\",\n \"result\": {\n \"dedicated_ip_id\": \"\",\n \"domain_ids\": [\n \"\"\n ]\n }\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.domains.unassign`
```text theme={null}
dedicated_ips.domains.unassign(account_id: str, dedicated_ip_id: str, domain_ids?: [str]) -> DedicatedIP
```
IP dedicadas: `dedicated_ips.domains.unassign`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | ---------------------------------------------------------------------------------------- | ----------------------- | --------------------- |
| Permiso requerido | `domain.proxy.assign` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `domain.proxy.assign` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `POST /v1/public/accounts/{account_id}/dedicated-ips/{dedicated_ip_id}/domains/unassign` | | |
| Nombre | Tipo | Requerido |
| ----------------- | ------- | --------- |
| `account_id` | `str` | sí |
| `dedicated_ip_id` | `str` | sí |
| `domain_ids` | `[str]` | no |
| Campo | Tipo | Requerido |
| ----------------- | ------- | --------- |
| `dedicated_ip_id` | `str` | sí |
| `domain_ids` | `[str]` | sí |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.domains.unassign(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain_ids=\"example.com\")"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": {
"dedicated_ip_id": "",
"domain_ids": [
""
]
}
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.domains.unassign",
"status": "completed",
"result": {
"dedicated_ip_id": "",
"domain_ids": [
""
]
}
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.domains.unassign(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", domain_ids=\"example.com\")"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": {\n \"dedicated_ip_id\": \"\",\n \"domain_ids\": [\n \"\"\n ]\n }\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.domains.unassign\",\n \"status\": \"completed\",\n \"result\": {\n \"dedicated_ip_id\": \"\",\n \"domain_ids\": [\n \"\"\n ]\n }\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.get`
```text theme={null}
dedicated_ips.get(account_id: str, dedicated_ip_id: str) -> DedicatedIP
```
IP dedicadas: `dedicated_ips.get`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | ---------------------------------------------------------------------- | ----------------------- | ------------ |
| Permiso requerido | `proxy.view` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `proxy.view` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `GET /v1/public/accounts/{account_id}/dedicated-ips/{dedicated_ip_id}` | | |
| Nombre | Tipo | Requerido |
| ----------------- | ----- | --------- |
| `account_id` | `str` | sí |
| `dedicated_ip_id` | `str` | sí |
| Campo | Tipo | Requerido |
| -------------- | ------------------------------------------------------------------------------------------ | --------- |
| `id` | `str` | sí |
| `name` | `str` | sí |
| `status` | `str` | sí |
| `type` | `str` | sí |
| `asn` | `int \| null` | no |
| `country_code` | `str \| null` | no |
| `created_at` | `str \| null` | no |
| `ip_addresses` | `[{"ip": str, "fcrdns_confirmed"?: bool, "healthy"?: bool \| null, "rdns"?: str \| null}]` | no |
| `updated_at` | `str \| null` | no |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.get",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.get(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", dedicated_ip_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\")"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.get\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```
### `dedicated_ips.list`
```text theme={null}
dedicated_ips.list(account_id: str, page?: int, page_size?: int) -> Page[DedicatedIP]
```
IP dedicadas: `dedicated_ips.list`.
| Propiedad | Valor | Propiedad | Valor |
| ----------------- | ---------------------------------------------------- | ----------------------- | ------------ |
| Permiso requerido | `proxy.view` | Autenticación requerida | `sí` |
| Modo de ejecución | `sync` | Capacidad | `proxy.view` |
| Tipo de recurso | `account` | Campo ID del recurso | `account_id` |
| Ruta API pública | `GET /v1/public/accounts/{account_id}/dedicated-ips` | | |
| Nombre | Tipo | Requerido |
| ------------ | ----- | --------- |
| `account_id` | `str` | sí |
| `page` | `int` | no |
| `page_size` | `int` | no |
| Campo | Tipo | Requerido |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------- |
| `items` | `[{"id": str, "name": str, "status": str, "type": str, "asn"?: int \| null, "country_code"?: str \| null, "created_at"?: str \| null, "ip_addresses"?: [{"ip": str, "fcrdns_confirmed"?: bool, "healthy"?: bool \| null, "rdns"?: str \| null}], "updated_at"?: str \| null}]` | sí |
| `page` | `int` | sí |
| `page_size` | `int` | sí |
| `total` | `int` | sí |
Solicitud:
```json theme={null}
{
"request_id": "example",
"session_id": "session_123",
"code": "dedicated_ips.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123)"
}
```
Respuesta:
```json theme={null}
{
"request_id": "example",
"status": "completed",
"result": {
"last_value": 123
},
"responses": [
{
"index": 0,
"function": "dedicated_ips.list",
"status": "completed",
"result": 123
}
],
"complexity_score": 1
}
```
Solicitud:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"method": "tools/call",
"params": {
"name": "hybridbox_execute",
"arguments": {
"code": "dedicated_ips.list(account_id=\"3c90c3cc-0d44-4b50-8888-8dd25736052a\", page=123, page_size=123)"
}
}
}
```
Respuesta:
```json theme={null}
{
"jsonrpc": "2.0",
"id": "example",
"result": {
"content": [
{
"type": "text",
"text": "{\n \"request_id\": \"example\",\n \"status\": \"completed\",\n \"result\": {\n \"last_value\": 123\n },\n \"responses\": [\n {\n \"index\": 0,\n \"function\": \"dedicated_ips.list\",\n \"status\": \"completed\",\n \"result\": 123\n }\n ],\n \"complexity_score\": 1\n}"
}
],
"isError": false
}
}
```