**Request** ```sh curl "https://api.infranest.io/api/organizations/42/contacts" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 1, "organization_id": 1, "first_name": "Alex", "last_name": "Rivera", "company": "Northwind Cloud", "email": "domains@northwind.example", "phone": "+31 20 555 0123", "address": "Keizersgracht", "city": "Amsterdam", "state": null, "zip": "1015 CJ", "country": "NL", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "house_number": "123", "vat_number": null, "company_number": null, "missing_for_registration": [], "tags": [] }, { "id": 3, "organization_id": 1, "first_name": "Priya", "last_name": "Nair", "company": "Northwind Cloud", "email": "legal@northwind.example", "phone": "+44 20 7946 0321", "address": "Shoreditch High Street", "city": "London", "state": "Greater London", "zip": "E1 6JJ", "country": "GB", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "house_number": "42", "vat_number": null, "company_number": null, "missing_for_registration": [], "tags": [] } ], "first_page_url": "http://localhost/api/organizations/1/contacts?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/contacts?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/contacts?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/contacts", "per_page": 25, "prev_page_url": null, "to": 4, "total": 4, "meta": { "tags": [] } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/contacts" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"first_name":"Ada","last_name":"Brandt","email":"ada@northwind.example","country":"DE"}' ``` **Response** · 201 — Created ```json { "first_name": "Ada", "last_name": "Brandt", "email": "ada@northwind.example", "country": "DE", "organization_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 5, "missing_for_registration": [ "address", "city" ], "tags": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/contacts/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "first_name": "Alex", "last_name": "Rivera", "company": "Northwind Cloud", "email": "domains@northwind.example", "phone": "+31 20 555 0123", "address": "Keizersgracht", "city": "Amsterdam", "state": null, "zip": "1015 CJ", "country": "NL", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "house_number": "123", "vat_number": null, "company_number": null, "missing_for_registration": [], "domains": [] } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/contacts/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"company":"Northwind Cloud GmbH","city":"Köln"}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "first_name": "Alex", "last_name": "Rivera", "company": "Northwind Cloud GmbH", "email": "domains@northwind.example", "phone": "+31 20 555 0123", "address": "Keizersgracht", "city": "Köln", "state": null, "zip": "1015 CJ", "country": "NL", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "house_number": "123", "vat_number": null, "company_number": null, "missing_for_registration": [], "tags": [] } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/contacts/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domain-findings" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "key": "expiry", "check": "expiry", "status": "error", "variant": "lapsed", "params": { "days": -6, "expires_at": "2026-01-09" }, "action": "renew", "cause": "domain:18:expiry", "rank": 390, "home": { "source": "domain_expiring", "key": "domain:18", "fingerprint": "2026-01-09" }, "snoozed": false, "domains": [ { "id": 18, "name": "nwcloud.app" } ] }, { "key": "dnssec", "check": "dnssec", "status": "error", "variant": "notValidating", "params": { "since": "2026-01-13T12:00:00.000000Z" }, "action": null, "cause": "domain:9:dnssec", "rank": 350, "home": { "source": "dnssec_broken", "key": "dnssec_broken:9", "fingerprint": "" }, "snoozed": false, "domains": [ { "id": 9, "name": "northwind.de" } ] } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 11, "organization_id": 1, "name": "northwind", "tld": "cloud", "registrar": "Porkbun", "registered_at": "2024-01-14T00:00:00.000000Z", "expires_at": "2026-11-12T00:00:00.000000Z", "auto_renew": true, "status": "active", "notes": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": [ "hydrogen.ns.hetzner.com", "oxygen.ns.hetzner.com" ], "transfer_lock": true, "whois_privacy": true, "registrar_contacts": null, "dnssec_entries": null, "has_dnssec": null, "renewal_price": "22.00", "renewal_price_currency": "EUR", "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "manual", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": null, "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": null, "dnssec_checked_at": null, "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "custom_fields": { "1": "Marketing" }, "advisor_issues": 0, "uses": { "website": { "kind": "server", "label": "web-01", "url": "/servers/1", "flagged": false, "since": null, "provider": "Hetzner", "note": null, "ours": false }, "site": { "key": "host:hetzner", "label": "Hetzner" }, "mail": { "key": "none", "label": null }, "no_zone": null }, "full_name": "northwind.cloud", "archivable": true, "dns_host": "hetzner", "management": "tracked", "sync_halt": null, "provider_credential": null, "tags": [ { "id": 4, "name": "Internal", "color": "#8b5cf6", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 11, "tag_id": 4 } } ] }, { "id": 1, "organization_id": 1, "name": "northwind", "tld": "com", "registrar": "Namecheap", "registered_at": "2023-12-28T00:00:00.000000Z", "expires_at": "2026-02-02T00:00:00.000000Z", "auto_renew": true, "status": "active", "notes": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "transfer_lock": true, "whois_privacy": true, "registrar_contacts": null, "dnssec_entries": [ { "key_tag": 62949, "algorithm": 13, "digest_type": 2, "digest": "FBF66B8D019C1EEC1E1A0B5A9D3C2E7F4A8B60D5C93E71F2A6B8D04C7E19A35B" } ], "has_dnssec": true, "renewal_price": "12.50", "renewal_price_currency": "EUR", "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "manual", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": null, "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": "signed", "dnssec_checked_at": "2026-01-15T11:25:00.000000Z", "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "custom_fields": { "1": "Marketing" }, "advisor_issues": 0, "uses": { "website": { "kind": "server", "label": "web-01", "url": "/servers/1", "flagged": false, "since": null, "provider": "Hetzner", "note": { "key": "proxied", "params": { "provider": "Cloudflare" } }, "ours": false }, "site": { "key": "host:hetzner", "label": "Hetzner" }, "mail": { "key": "other", "label": "mx.northwind.com" }, "no_zone": null }, "full_name": "northwind.com", "archivable": true, "dns_host": "cloudflare", "management": "tracked", "sync_halt": null, "provider_credential": null, "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 1, "tag_id": 5 } } ] } ], "first_page_url": "http://localhost/api/organizations/1/domains?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/domains?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/domains?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/domains", "per_page": 25, "prev_page_url": null, "to": 20, "total": 20, "meta": { "locked_ids": [], "expiry_window_days": 60, "counts": { "total": 20, "active": 19, "expiring_soon": 3, "autorenew_off": 5, "failed": 0, "archived": 0 }, "integrations": [], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6" }, { "id": 4, "name": "Internal", "color": "#8b5cf6" } ], "uses": { "sites": [ { "key": "host:hetzner", "label": "Hetzner", "count": 12 }, { "key": "none", "label": null, "count": 1 } ], "mail": [ { "key": "other", "label": null, "count": 7 }, { "key": "none", "label": null, "count": 6 } ] }, "custom_fields": [ { "id": 1, "key": "cost_centre", "label": "Cost centre", "type": "select", "options": [ "Platform", "Marketing" ] } ] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/actions" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "actions": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/advisor" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "expiry_window_days": 60, "findings": [ { "key": "expiry", "check": "expiry", "status": "info", "variant": "renewalUnknown", "params": { "days": 18, "expires_at": "2026-02-02", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "action": null, "cause": "domain:1:expiry", "rank": 222, "home": { "source": "domain_finding", "key": "domain_finding:domain:1:expiry", "fingerprint": "" }, "snoozed": false }, { "key": "auto_renew", "check": "auto_renew", "status": "info", "variant": "unknown", "params": { "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "action": null, "cause": "portfolio:auto_renew", "rank": 150, "home": { "source": "domain_finding", "key": "domain_finding:portfolio:auto_renew", "fingerprint": "" }, "snoozed": false } ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/domains/1/archive" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "northwind", "tld": "com", "registrar": "Namecheap", "registered_at": "2023-12-28T00:00:00.000000Z", "expires_at": "2026-02-02T00:00:00.000000Z", "auto_renew": true, "status": "active", "notes": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "transfer_lock": true, "whois_privacy": true, "registrar_contacts": null, "dnssec_entries": [ { "key_tag": 62949, "algorithm": 13, "digest_type": 2, "digest": "FBF66B8D019C1EEC1E1A0B5A9D3C2E7F4A8B60D5C93E71F2A6B8D04C7E19A35B" } ], "has_dnssec": true, "renewal_price": "12.50", "renewal_price_currency": "EUR", "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "manual", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": "2026-01-15T12:00:00.000000Z", "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": "signed", "dnssec_checked_at": "2026-01-15T11:25:00.000000Z", "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "full_name": "northwind.com", "archivable": true, "dns_host": "cloudflare", "management": "tracked", "sync_halt": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/capabilities" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "capabilities": { "nameservers": false, "contacts": false, "dnssec": false, "transfer_lock": false, "whois_privacy": false, "auto_renew": false, "auto_renew_reenable": false, "complete_domain_list": false, "epp_code": false, "register": false, "transfer": false, "renew": false }, "reason": "no_registrar_credential", "registry_withheld": [], "contact_roles": [ "registrant", "admin" ], "dnssec_fields": [ "key_tag", "flags" ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/contacts" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/domains/1/contacts" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"contact_id":1,"type":"admin"}' ``` **Response** · 201 — Created ```json { "id": 1, "organization_id": 1, "first_name": "Alex", "last_name": "Rivera", "company": "Northwind Cloud", "email": "domains@northwind.example", "phone": "+31 20 555 0123", "address": "Keizersgracht", "city": "Amsterdam", "state": null, "zip": "1015 CJ", "country": "NL", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "house_number": "123", "vat_number": null, "company_number": null, "missing_for_registration": [], "pivot": { "type": "admin" } } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/domains/1/contacts/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/epp-code" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/history" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/ns-health" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "checks": [ { "ns": "nina.ns.cloudflare.com", "authoritative": true, "reachable": true }, { "ns": "rick.ns.cloudflare.com", "authoritative": true, "reachable": true } ], "ns_consistency": { "consistent": true, "resolvers": { "cloudflare": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "google": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "dnssb": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "adguard": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "nextdns": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ] } }, "dnssec_validates": true, "zone_delegation": { "zone_id": 1, "zone_name": "northwind.com", "provider": "cloudflare", "delegated": true, "delegated_to": null } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/pricing" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/registry-record" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "statuses": [], "created_at": null, "updated_at": null, "source": null, "raw": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/setup" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "zone": { "id": 1, "name": "northwind.com" }, "registrar": { "label": "Namecheap", "managed": false, "credential_id": null, "provider": null }, "dns": { "provider": "cloudflare", "provider_label": "Cloudflare", "connected": true, "zone_here": true, "nameservers": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "answering": null, "checked_at": null }, "email": { "provider": null, "hosts": [ "mx.northwind.com" ] }, "website": { "records": [ { "type": "A", "value": "198.51.100.10", "url": "/dns/1?record=1" } ], "server": { "type": "server", "id": 1, "label": "web-01", "sublabel": "198.51.100.10", "url": "/servers/1", "meta": [] } }, "runs_on": [ { "record_id": 1, "zone_id": 1, "host": "northwind.com", "type": "A", "value": "198.51.100.10", "url": "/dns/1?record=1", "server": { "type": "server", "id": 1, "label": "web-01", "sublabel": "198.51.100.10", "url": "/servers/1", "meta": [] }, "certificate": { "type": "certificate", "id": 1, "label": "northwind.com", "sublabel": "2026-03-30", "url": "/certificates/1", "meta": [] }, "monitors": [ { "type": "monitor", "id": 1, "label": "Marketing site", "sublabel": "https://northwind.com", "url": "/monitoring/1", "meta": { "type": "http", "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z" } }, { "type": "monitor", "id": 4, "label": "Checkout flow", "sublabel": "https://northwind.com/checkout", "url": "/monitoring/4", "meta": { "type": "http", "last_status": "down", "last_checked_at": "2026-01-15T11:58:00.000000Z" } } ], "status_pages": [] }, { "record_id": 3, "zone_id": 1, "host": "api.northwind.com", "type": "CNAME", "value": "northwind.com", "url": "/dns/1?record=3", "server": null, "certificate": { "type": "certificate", "id": 3, "label": "api.northwind.com", "sublabel": "2026-04-13", "url": "/certificates/3", "meta": [] }, "monitors": [ { "type": "monitor", "id": 3, "label": "API health", "sublabel": "https://api.northwind.com/health", "url": "/monitoring/3", "meta": { "type": "http", "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z" } }, { "type": "monitor", "id": 6, "label": "Search API", "sublabel": "https://api.northwind.com/v1/search", "url": "/monitoring/6", "meta": { "type": "api", "last_status": "degraded", "last_checked_at": "2026-01-15T11:58:00.000000Z" } } ], "status_pages": [] } ], "mail": [ { "record_id": 4, "value": "mx.northwind.com", "url": "/dns/1?record=4" } ], "unmonitored": [ "archive.northwind.com", "cdn.northwind.com" ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/domains/1/unarchive" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "northwind", "tld": "com", "registrar": "Namecheap", "registered_at": "2023-12-28T00:00:00.000000Z", "expires_at": "2026-02-02T00:00:00.000000Z", "auto_renew": true, "status": "active", "notes": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "transfer_lock": true, "whois_privacy": true, "registrar_contacts": null, "dnssec_entries": [ { "key_tag": 62949, "algorithm": 13, "digest_type": 2, "digest": "FBF66B8D019C1EEC1E1A0B5A9D3C2E7F4A8B60D5C93E71F2A6B8D04C7E19A35B" } ], "has_dnssec": true, "renewal_price": "12.50", "renewal_price_currency": "EUR", "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "manual", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": null, "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": "signed", "dnssec_checked_at": "2026-01-15T11:25:00.000000Z", "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "full_name": "northwind.com", "archivable": true, "dns_host": "cloudflare", "management": "tracked", "sync_halt": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1/whois" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "server": "whois.verisign-grs.com", "output": " Domain Name: NORTHWIND.COM\r\n Registry Domain ID: 4516866_DOMAIN_COM-VRSN\r\n Registrar WHOIS Server: whois.godaddy.…" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "northwind", "tld": "com", "registrar": "Namecheap", "registered_at": "2023-12-28T00:00:00.000000Z", "expires_at": "2026-02-02T00:00:00.000000Z", "auto_renew": true, "status": "active", "notes": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "transfer_lock": true, "whois_privacy": true, "registrar_contacts": null, "dnssec_entries": [ { "key_tag": 62949, "algorithm": 13, "digest_type": 2, "digest": "FBF66B8D019C1EEC1E1A0B5A9D3C2E7F4A8B60D5C93E71F2A6B8D04C7E19A35B" } ], "has_dnssec": true, "renewal_price": "12.50", "renewal_price_currency": "EUR", "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "manual", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": null, "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": "signed", "dnssec_checked_at": "2026-01-15T11:25:00.000000Z", "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "full_name": "northwind.com", "archivable": true, "dns_host": "cloudflare", "management": "tracked", "sync_halt": null, "contacts": [], "provider_credential": null, "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 1, "tag_id": 5 } } ], "dns_zone": { "id": 1, "name": "northwind.com", "provider": "cloudflare", "provider_label": "Cloudflare", "points_here": true, "can_sign": true }, "tracked": { "registrar": "Namecheap", "provider": { "key": "namecheap", "label": "Namecheap", "integrable": true }, "connected": true, "checked_at": null }, "capabilities": { "nameservers": false, "contacts": false, "dnssec": false, "transfer_lock": false, "whois_privacy": false, "auto_renew": false, "auto_renew_reenable": false, "complete_domain_list": false, "epp_code": false, "register": false, "transfer": false, "renew": false }, "capabilities_reason": "no_registrar_credential", "registry_withheld": [], "contact_roles": [ "registrant", "admin" ], "settings": { "transfer_lock": { "state": "on", "source": "registry", "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "auto_renew": { "state": "unknown", "source": null, "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "whois_privacy": { "state": "on", "source": "registrar", "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "dnssec": { "state": "unknown", "source": null, "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "caa": { "state": "off", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "spf": { "state": "on", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "dmarc": { "state": "on", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "email": { "state": "on", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "dkim": { "state": "off", "source": "zone", "route": "elsewhere", "where": null }, "no_mail": { "state": "none", "source": null, "route": null, "where": null } }, "advisor": { "expiry_window_days": 60, "findings": [ { "key": "expiry", "check": "expiry", "status": "info", "variant": "renewalUnknown", "params": { "days": 18, "expires_at": "2026-02-02", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "action": null, "cause": "domain:1:expiry", "rank": 222, "home": { "source": "domain_finding", "key": "domain_finding:domain:1:expiry", "fingerprint": "" }, "snoozed": false }, { "key": "auto_renew", "check": "auto_renew", "status": "info", "variant": "unknown", "params": { "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "action": null, "cause": "portfolio:auto_renew", "rank": 150, "home": { "source": "domain_finding", "key": "domain_finding:portfolio:auto_renew", "fingerprint": "" }, "snoozed": false } ] } } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/domains/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"notes":"Main brand domain. Renew three years ahead."}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "northwind", "tld": "com", "registrar": "Namecheap", "registered_at": "2023-12-28T00:00:00.000000Z", "expires_at": "2026-02-02T00:00:00.000000Z", "auto_renew": true, "status": "active", "notes": "Main brand domain. Renew three years ahead.", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "transfer_lock": true, "whois_privacy": true, "registrar_contacts": null, "dnssec_entries": [ { "key_tag": 62949, "algorithm": 13, "digest_type": 2, "digest": "FBF66B8D019C1EEC1E1A0B5A9D3C2E7F4A8B60D5C93E71F2A6B8D04C7E19A35B" } ], "has_dnssec": true, "renewal_price": "12.50", "renewal_price_currency": "EUR", "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "manual", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": null, "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": "signed", "dnssec_checked_at": "2026-01-15T11:25:00.000000Z", "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "full_name": "northwind.com", "archivable": true, "dns_host": "cloudflare", "management": "tracked", "sync_halt": null, "contacts": [ { "id": 1, "organization_id": 1, "first_name": "Alex", "last_name": "Rivera", "company": "Northwind Cloud", "email": "domains@northwind.example", "phone": "+31 20 555 0123", "address": "Keizersgracht", "city": "Amsterdam", "state": null, "zip": "1015 CJ", "country": "NL", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "house_number": "123", "vat_number": null, "company_number": null, "missing_for_registration": [], "pivot": { "domain_id": 1, "contact_id": 1, "type": "tech", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } } ], "provider_credential": null, "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\Domain", "taggable_id": 1, "tag_id": 5 } } ], "dns_zone": { "id": 1, "name": "northwind.com", "provider": "cloudflare", "provider_label": "Cloudflare", "points_here": true, "can_sign": true }, "tracked": { "registrar": "Namecheap", "provider": { "key": "namecheap", "label": "Namecheap", "integrable": true }, "connected": true, "checked_at": null }, "capabilities": { "nameservers": false, "contacts": false, "dnssec": false, "transfer_lock": false, "whois_privacy": false, "auto_renew": false, "auto_renew_reenable": false, "complete_domain_list": false, "epp_code": false, "register": false, "transfer": false, "renew": false }, "capabilities_reason": "no_registrar_credential", "registry_withheld": [], "contact_roles": [ "registrant", "admin" ], "settings": { "transfer_lock": { "state": "on", "source": "registry", "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "auto_renew": { "state": "unknown", "source": null, "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "whois_privacy": { "state": "on", "source": "registrar", "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "dnssec": { "state": "unknown", "source": null, "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "caa": { "state": "off", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "spf": { "state": "on", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "dmarc": { "state": "on", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "email": { "state": "on", "source": "zone", "route": "here", "where": { "label": "Cloudflare", "url": null } }, "dkim": { "state": "off", "source": "zone", "route": "elsewhere", "where": null }, "no_mail": { "state": "none", "source": null, "route": null, "where": null } }, "advisor": { "expiry_window_days": 60, "findings": [ { "key": "expiry", "check": "expiry", "status": "info", "variant": "renewalUnknown", "params": { "days": 18, "expires_at": "2026-02-02", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "action": null, "cause": "domain:1:expiry", "rank": 222, "home": { "source": "domain_finding", "key": "domain_finding:domain:1:expiry", "fingerprint": "" }, "snoozed": false }, { "key": "auto_renew", "check": "auto_renew", "status": "info", "variant": "unknown", "params": { "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" } }, "action": null, "cause": "portfolio:auto_renew", "rank": 150, "home": { "source": "domain_finding", "key": "domain_finding:portfolio:auto_renew", "fingerprint": "" }, "snoozed": false } ] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/caa-protection-plan" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "domains": [ { "id": 1, "name": "northwind.com", "zone_id": 1, "route": "here", "plan": { "zone_id": 1, "zone": "northwind.com", "route": "here", "where": { "label": "Cloudflare", "url": null }, "records": [ { "key": "kept:7", "action": "none", "type": "CAA", "name": "@", "value": "0 issue \"letsencrypt.org\"", "current": null, "record_id": null, "reason": "caa_kept", "params": [] }, { "key": "issue:globalsign.com", "action": "create", "type": "CAA", "name": "@", "value": "0 issue \"globalsign.com\"", "current": null, "record_id": null, "reason": "caa_cert", "params": { "subject": "shop.northwind.com" } } ], "refusals": [], "certificates": [ { "id": 1, "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "ca": "letsencrypt.org", "wildcard": false, "state": "stays_renewable" }, { "id": 13, "subject": "cdn.northwind.com", "issuer": "Let's Encrypt (R3)", "ca": "letsencrypt.org", "wildcard": false, "state": "stays_renewable" } ], "fronts": [ { "label": "Cloudflare", "ids": [ "letsencrypt.org", "pki.goog" ], "publishes_own": true } ] } } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/email-protection-plan?mode=%3Cmode%3E" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "mode": "no_mail", "domains": [ { "id": 1, "name": "northwind.com", "zone_id": 1, "route": "refused", "plan": { "zone_id": 1, "zone": "northwind.com", "mode": "no_mail", "route": "here", "where": { "label": "Cloudflare", "url": null }, "provider": null, "providers": [], "records": [], "refusals": [ { "key": "mode", "reason": "receives_mail", "params": [] } ], "lookups": null, "dkim": null } } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/overview" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "summary": { "total": 20, "fine": 16, "need_you": 4, "this_week": 2, "registrars": 7, "renewal_cost": 327.5, "currency": "EUR", "auto_renewing": 0, "synced_at": null, "next_renewal": { "domain_id": 14, "name": "northwind-labs.com", "expires_at": "2026-01-24", "auto_renew": false } }, "needs_you": [ { "key": "expiry", "check": "expiry", "status": "error", "variant": "lapsed", "params": { "days": -6, "expires_at": "2026-01-09" }, "action": "renew", "cause": "domain:18:expiry", "rank": 390, "home": { "source": "domain_expiring", "key": "domain:18", "fingerprint": "2026-01-09" }, "snoozed": false, "domains": [ { "id": 18, "name": "nwcloud.app" } ], "attention_keys": [ "domain:18" ], "due_in_days": 0, "renewal": null, "evidence": [ { "source": "registrar", "state": "auto_renew_off", "tone": "bad" } ], "prevention": { "template": "auto_renew_expiring_domains", "active": false } }, { "key": "dnssec", "check": "dnssec", "status": "error", "variant": "notValidating", "params": { "since": "2026-01-13T12:00:00.000000Z" }, "action": null, "cause": "domain:9:dnssec", "rank": 350, "home": { "source": "dnssec_broken", "key": "dnssec_broken:9", "fingerprint": "" }, "snoozed": false, "domains": [ { "id": 9, "name": "northwind.de" } ], "attention_keys": [ "dnssec_broken:9" ], "due_in_days": 0, "renewal": null, "evidence": [], "prevention": null } ], "decided": [], "renewals": { "currency": "EUR", "priced": true, "total": 327.5, "items": 18, "unpriced": 0, "months": [ { "month": "2026-01", "cost": 44.5, "items": 2, "unpriced": 0, "decide_cost": 44.5, "decide_items": 2, "domains": [ { "id": 10, "name": "northwind.shop", "cost": 32, "decide": true }, { "id": 14, "name": "northwind-labs.com", "cost": 12.5, "decide": true } ], "more": 0 }, { "month": "2026-02", "cost": 12.5, "items": 1, "unpriced": 0, "decide_cost": 12.5, "decide_items": 1, "domains": [ { "id": 1, "name": "northwind.com", "cost": 12.5, "decide": true } ], "more": 0 } ], "savings": { "unused": [], "total": 0 } }, "protection": [ { "setting": "transfer_lock", "on": 14, "applicable": 16, "off": [ 14, 18 ], "applies": true, "here": [], "reconnect": [], "elsewhere": [ { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/", "ids": [ 14, 18 ] } ], "unknown": 0, "none": 3 }, { "setting": "auto_renew", "on": 0, "applicable": 5, "off": [ 4, 10 ], "applies": true, "here": [], "reconnect": [], "elsewhere": [ { "label": "Cloudflare", "url": "https://dash.cloudflare.com/?to=/:account/domains", "ids": [ 4 ] }, { "label": "Porkbun", "url": "https://porkbun.com/account/domainsSpeedy", "ids": [ 10 ] } ], "unknown": 14, "none": 0 } ], "stale": [], "found_elsewhere": [], "cheaper_registrar": { "groups": [], "set_aside": [] }, "setup": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/registrar-moves" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/registration-fields?credential_id=16" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "fields": [], "unknown": true, "periods": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/settings-plan?setting=%3Csetting%3E" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "setting": "auto_renew", "value": true, "applies": true, "domains": [ { "id": 1, "name": "northwind.com", "state": "unknown", "route": "elsewhere", "where": { "label": "Namecheap", "url": "https://ap.www.namecheap.com/domains/list/" }, "dnssec": null, "zone_id": null } ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/domains/track" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"northwind-studio.com"}' ``` **Response** · 201 — Created ```json { "id": 21, "organization_id": 1, "name": "northwind-studio", "tld": "com", "registrar": null, "registered_at": null, "expires_at": null, "auto_renew": true, "status": "active", "notes": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": null, "nameservers": null, "transfer_lock": null, "whois_privacy": null, "registrar_contacts": null, "dnssec_entries": null, "has_dnssec": null, "renewal_price": null, "renewal_price_currency": null, "pricing_cached_at": null, "last_details_synced_at": null, "status_message": null, "expected_issuers": null, "renewal_price_source": "api", "purchase_price": null, "purchase_price_currency": null, "registrar_price": null, "registrar_price_currency": null, "registrar_flags": null, "requested_whois_privacy": null, "requested_auto_renew": null, "archived_at": null, "requested_nameservers": null, "missing_since": null, "serves_website": null, "billing_interval": "yearly", "interval_count": 1, "dnssec_state": null, "dnssec_checked_at": null, "dnssec_broken_since": null, "requested_dns_credential_id": null, "requested_dns_template": null, "status_detail": null, "ordered_by_user_id": null, "ns_health": null, "ns_health_checked_at": null, "unused_since": null, "registry_statuses": null, "registry_checked_at": null, "registry_dnssec": null, "full_name": "northwind-studio.com", "archivable": true, "dns_host": null, "management": "tracked", "sync_halt": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/domains/transfer-preflight?name=www&tld=%3Ctld%3E" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "domain": "northwind.com", "registrar": "Namecheap", "expires_at": "2026-02-02", "source": "fixture", "checks": [ { "key": "not_locked", "status": "warn", "detail": [] }, { "key": "sixty_day_rule", "status": "pass", "detail": { "days": 749, "free_on": "2024-02-26", "since": "registration" } } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns/address-move" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "from": { "server": { "id": 1, "name": "web-01" }, "addresses": [ "198.51.100.10", "2001:db8:1c1e:5a10::/64" ] }, "to": null, "targets": [ { "id": 13, "name": "analytics-01", "ipv4": "192.0.2.80", "ipv6": null, "ipv6_basis": null }, { "id": 3, "name": "api-01", "ipv4": "198.51.100.20", "ipv6": "2001:db8:1c1e:5a20::1", "ipv6_basis": "default" } ], "records": [ { "record_id": 26, "zone_id": 5, "zone_name": "northwind-docs.com", "zone_provider": "cloudflare", "name": "@", "fqdn": "northwind-docs.com", "type": "A", "value": "198.51.100.10", "ttl": 300, "proxied": true, "family": 4, "new_value": null, "excluded": "read_only", "aliases": [ { "zone_id": 5, "record_id": 28, "fqdn": "api.northwind-docs.com" } ] }, { "record_id": 27, "zone_id": 5, "zone_name": "northwind-docs.com", "zone_provider": "cloudflare", "name": "www", "fqdn": "www.northwind-docs.com", "type": "A", "value": "198.51.100.10", "ttl": 300, "proxied": true, "family": 4, "new_value": null, "excluded": "read_only", "aliases": [] } ], "monitors": { "follow": [], "by_name": [] }, "ttl": { "long": 0, "longest": null, "threshold": 3600, "lowered": 300 } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns/moves" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns/overview" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "summary": { "state": "needs_you", "critical": false, "zones": 13, "needing_you": 2, "fine": 11, "live_match": 12, "live_checked": 12, "records": 88, "hosts": 6, "last_synced_at": "2026-01-15T11:53:00+00:00" }, "needs": [ { "key": "advisor:6:dnssec", "cause": "advisor", "critical": false, "subject": "northwind.de", "zones": [ { "id": 6, "name": "northwind.de" } ], "params": [], "since": null, "due_at": null, "route": "/dns/6", "finding": { "id": "dnssec", "status": "error", "variant": "error" }, "halt": null, "attention_keys": [ "dnssec_broken:9" ] }, { "key": "advisor:3:cf_ssl_mode", "cause": "advisor", "critical": false, "subject": "northwind-app.dev", "zones": [ { "id": 3, "name": "northwind-app.dev" } ], "params": [], "since": null, "due_at": null, "route": "/dns/3", "finding": { "id": "cf_ssl_mode", "status": "error", "value": "flexible" }, "halt": null, "attention_keys": [ "dns_zone_finding:3:cf_ssl_mode" ] } ], "decided": [], "changes": { "from": "2026-01-08T12:00:00+00:00", "entries": [ { "key": "audit:2", "kind": "audit", "action": "dns_record.created", "at": "2026-01-15T07:00:00+00:00", "zones": [ { "id": null, "name": "" } ], "actor": { "type": "user", "name": "Sam Okoye" }, "outside": false, "count": 1, "params": { "name": "@", "type": "" }, "batch": null, "writable": false, "provider": null }, { "key": "audit:8", "kind": "audit", "action": "dns_record.updated", "at": "2026-01-12T11:00:00+00:00", "zones": [ { "id": null, "name": "" } ], "actor": { "type": "user", "name": "Tom Bakker" }, "outside": false, "count": 1, "params": { "name": "@", "type": "" }, "batch": null, "writable": false, "provider": null } ], "truncated": false }, "hosts": [ { "key": "cred:2", "name": "Cloudflare DNS", "provider": "cloudflare", "credential_id": 2, "zones": 5, "connected": true, "halt": null }, { "key": "cred:1", "name": "Hetzner — Production", "provider": "hetzner", "credential_id": 1, "zones": 2, "connected": true, "halt": null } ], "domains_without_zone": 5, "recommendations": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns/search" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "query": "", "too_short": true, "min_length": 2, "total": 0, "truncated": false, "zones": [], "address_record_ids": [] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/dns-changes/undo" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"change_id":42,"batch_id":"9b2c6a1e-3f7d-4a8e-9c1b-2d3e4f5a6b7c"}' ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-templates" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "builtin": [ { "id": null, "slug": "google-workspace", "name": "Google Workspace", "description": "MX records, SPF, and DMARC starter for Google Workspace email.", "is_builtin": true, "records": [ { "type": "MX", "name": "@", "value": "aspmx.l.google.com.", "ttl": 3600, "priority": 1 }, { "type": "MX", "name": "@", "value": "alt1.aspmx.l.google.com.", "ttl": 3600, "priority": 5 } ] }, { "id": null, "slug": "microsoft-365", "name": "Microsoft 365", "description": "MX record, SPF, Autodiscover CNAME, and DMARC starter for Microsoft 365. The MX is filled in from the domain.", "is_builtin": true, "records": [ { "type": "MX", "name": "@", "value": "{zone_dashed}.mail.protection.outlook.com.", "ttl": 3600, "priority": 0 }, { "type": "TXT", "name": "@", "value": "v=spf1 include:spf.protection.outlook.com -all", "ttl": 3600 } ] } ], "custom": [ { "id": 1, "organization_id": 1, "name": "Google Workspace mail", "description": "MX, SPF and DKIM for a domain that sends mail through Google Workspace.", "slug": "google-workspace-mail", "is_builtin": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "records": [ { "id": 1, "dns_template_id": 1, "type": "MX", "name": "@", "value": "aspmx.l.google.com", "ttl": 3600, "priority": 1, "proxied": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" }, { "id": 2, "dns_template_id": 1, "type": "MX", "name": "@", "value": "alt1.aspmx.l.google.com", "ttl": 3600, "priority": 5, "proxied": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } ] } ], "ttl_options": [ 1, 30 ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/dns-templates/1/apply/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"overwrite":true,"confirm_caa_impact":true}' ``` **Response** · 200 ```json { "added": 1, "overwritten": 0, "failed": 0, "error": null, "skipped": 2, "skipped_reason": "The A record \"@\" needs a value the template cannot know ({server_ipv4}). Add it yourself. The AAAA record \"@\" needs a value the template cannot know ({server_ipv6}). Add it yourself.", "message": "Applied Static Site: 1 records added, 0 updated. 2 skipped: The A record \"@\" needs a value the template cannot know ({server_ipv4}). Add it yourself. The AAAA record \"@\" needs a value the template cannot know ({server_ipv6}). Add it yourself." } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-templates/1/preview/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "type": "A", "name": "@", "value": "{server_ipv4}", "ttl": 3600, "priority": null, "proxied": false, "unfilled": "{server_ipv4}", "status": "skipped", "existing_value": null, "reason": "The A record \"@\" needs a value the template cannot know ({server_ipv4}). Add it yourself." }, { "type": "AAAA", "name": "@", "value": "{server_ipv6}", "ttl": 3600, "priority": null, "proxied": false, "unfilled": "{server_ipv6}", "status": "skipped", "existing_value": null, "reason": "The AAAA record \"@\" needs a value the template cannot know ({server_ipv6}). Add it yourself." } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 11, "organization_id": 1, "domain_id": 20, "name": "northwind-api.dev", "provider": "openprovider", "provider_zone_id": "zone-210", "status": "pending", "last_synced_at": "2026-01-15T10:24:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 7, "ns_live": [ "ns1.openprovider.nl", "ns2.openprovider.be" ], "ns_checked_at": "2026-01-15T11:53:00.000000Z", "security_status": "info", "ns_mismatch_since": null, "provider_modified_at": null, "price_monthly": "0.00", "price_source": "manual", "price_currency": "EUR", "price_amount": "0.0000", "billing_interval": "monthly", "interval_count": 1, "live_mismatch_count": 0, "live_checked_at": "2026-01-15T11:53:00.000000Z", "live_mismatch_since": null, "dnssec_pending": null, "dnssec_pending_since": null, "provider_settings": null, "provider_settings_checked_at": null, "default_ttl": null, "registrar_name": null, "registrar_checked_at": null, "records_count": 7, "custom_fields": [], "delegation": { "state": "matches", "reason": null, "live": [ "ns1.openprovider.nl", "ns2.openprovider.be" ], "dnssec": null, "belongs_to": "openprovider", "checked_at": "2026-01-15T11:53:00.000000Z" }, "can_sign": false, "sync_halt": null, "provider_credential": { "id": 7, "organization_id": 1, "provider": "openprovider", "label": "Openprovider — Reseller", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] }, { "id": 3, "organization_id": 1, "domain_id": 3, "name": "northwind-app.dev", "provider": "cloudflare", "provider_zone_id": "zone-202", "status": "active", "last_synced_at": "2026-01-15T11:48:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 2, "ns_live": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "ns_checked_at": "2026-01-15T11:53:00.000000Z", "security_status": "error", "ns_mismatch_since": null, "provider_modified_at": null, "price_monthly": "4.00", "price_source": "manual", "price_currency": "EUR", "price_amount": "4.0000", "billing_interval": "monthly", "interval_count": 1, "live_mismatch_count": 0, "live_checked_at": "2026-01-15T11:53:00.000000Z", "live_mismatch_since": null, "dnssec_pending": null, "dnssec_pending_since": null, "provider_settings": { "ssl": "flexible", "min_tls_version": "1.0", "security_header": { "strict_transport_security": { "enabled": false } }, "always_use_https": "off", "development_mode": "on", "development_mode_expires_at": "2026-01-15T14:00:00.000000Z" }, "provider_settings_checked_at": "2026-01-15T11:40:00.000000Z", "default_ttl": null, "registrar_name": null, "registrar_checked_at": null, "records_count": 8, "custom_fields": [], "delegation": { "state": "matches", "reason": null, "live": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "dnssec": null, "belongs_to": "cloudflare", "checked_at": "2026-01-15T11:53:00.000000Z" }, "can_sign": true, "sync_halt": null, "provider_credential": { "id": 2, "organization_id": 1, "provider": "cloudflare", "label": "Cloudflare DNS", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] } ], "first_page_url": "http://localhost/api/organizations/1/dns-zones?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/dns-zones?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/dns-zones?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/dns-zones", "per_page": 25, "prev_page_url": null, "to": 13, "total": 13, "meta": { "locked_ids": [], "counts": { "total": 13, "active": 12, "stale": 0, "drift": 0, "security": 4 }, "integrations": [ { "id": 2, "provider": "cloudflare", "label": "Cloudflare DNS" }, { "id": 4, "provider": "dynadot", "label": "Dynadot Registrar" } ], "tags": [], "custom_fields": [] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "domain_id": 1, "name": "northwind.com", "provider": "cloudflare", "provider_zone_id": "zone-200", "status": "active", "last_synced_at": "2026-01-15T11:48:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 2, "ns_live": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "ns_checked_at": "2026-01-15T11:53:00.000000Z", "security_status": "warn", "ns_mismatch_since": null, "provider_modified_at": null, "price_monthly": "4.00", "price_source": "manual", "price_currency": "EUR", "price_amount": "4.0000", "billing_interval": "monthly", "interval_count": 1, "live_mismatch_count": 0, "live_checked_at": "2026-01-15T11:53:00.000000Z", "live_mismatch_since": null, "dnssec_pending": null, "dnssec_pending_since": null, "provider_settings": { "ssl": "strict", "min_tls_version": "1.2", "security_header": { "strict_transport_security": { "enabled": true } }, "always_use_https": "on", "development_mode": "off" }, "provider_settings_checked_at": "2026-01-15T11:40:00.000000Z", "default_ttl": null, "registrar_name": null, "registrar_checked_at": null, "records_count": 10, "sync_halt": null, "records": [ { "id": 1, "dns_zone_id": 1, "type": "A", "name": "@", "value": "198.51.100.10", "ttl": 300, "priority": null, "provider_record_id": "rec-200-0", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": true, "live_values": null, "live_checked_at": null, "value_is_placeholder": false, "live_mismatch": null }, { "id": 2, "dns_zone_id": 1, "type": "A", "name": "www", "value": "198.51.100.10", "ttl": 300, "priority": null, "provider_record_id": "rec-200-1", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": true, "live_values": null, "live_checked_at": null, "value_is_placeholder": false, "live_mismatch": null } ], "provider_credential": { "id": 2, "organization_id": 1, "provider": "cloudflare", "label": "Cloudflare DNS", "verified_at": "2025-10-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "enabled": true, "enabled_capabilities": null, "disabled_capabilities": null, "error_email_enabled": true, "disabled_operations": null, "alerts_muted_until": null, "spending_capacity": null, "spending_checked_at": null, "scope_check": null, "scope_checked_at": null, "removing_at": null, "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "account_identity": null, "refused_at": null, "refusal_checked_at": null }, "tags": [], "record_types": [ "A", "AAAA" ], "ttl_options": [ 1, 120 ], "can_push_records": false, "delegation": { "state": "matches", "reason": null, "live": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "dnssec": false, "belongs_to": "cloudflare", "checked_at": "2026-01-15T11:53:00.000000Z" }, "proxiable_record_types": [], "can_sign": true, "signing_reason": null, "dnssec_plan": { "shape": "sign_then_paste", "dns": { "provider": "cloudflare", "can_sign": true, "exposes_key": true, "reason": null }, "registrar": { "provider": "Namecheap", "known": true, "can_publish": false, "help_url": null, "fields": [ "key_tag", "flags" ] } }, "managed_hostnames": [], "posture": [ { "id": "cf_ssl_mode", "status": "pass", "value": "strict" }, { "id": "cf_min_tls", "status": "pass", "value": "1.2" } ], "dangling_addresses": [], "unclaimed_cnames": [], "live": { "mismatches": 0, "checked_at": "2026-01-15T11:53:00.000000Z", "mismatch_since": null } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/advisor" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "snapshot": { "spf": [ "v=spf1 include:_spf.northwind.com ~all" ], "dmarc": [ "v=DMARC1; p=quarantine; rua=mailto:dmarc@northwind.example" ], "dkim_selectors": [], "mx": [ "mx.northwind.com" ], "null_mx": false, "mail_provider": null, "mx_cname_targets": [], "apex_a": [ "198.51.100.10" ], "apex_aaaa": [], "apex_cname": [], "caa": [ "0 issue \"letsencrypt.org\"" ], "caa_required": { "certificates": [ { "id": 1, "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "ids": [ "letsencrypt.org" ], "wildcard": false, "renews_itself": true, "provider": false }, { "id": 13, "subject": "cdn.northwind.com", "issuer": "Let's Encrypt (R3)", "ids": [ "letsencrypt.org" ], "wildcard": false, "renews_itself": true, "provider": false } ], "expected": [], "fronts": [ { "key": "cloudflare", "label": "Cloudflare", "ids": [ "letsencrypt.org", "pki.goog" ], "publishes_own": true } ] }, "wildcard_a": [], "wildcard_aaaa": [], "cf_exposed_ips": [ "198.51.100.10" ], "mta_sts": [], "bimi": [], "apex_ns": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "ns_matches_provider": true, "mail_subdomains_missing_spf": [] }, "findings": [ { "id": "ns", "status": "pass", "variant": "pass", "values": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ] }, { "id": "dnssec", "status": "pass", "variant": "pass" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/caa-protection" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "zone_id": 1, "zone": "northwind.com", "route": "here", "where": { "label": "Cloudflare", "url": null }, "records": [ { "key": "kept:7", "action": "none", "type": "CAA", "name": "@", "value": "0 issue \"letsencrypt.org\"", "current": null, "record_id": null, "reason": "caa_kept", "params": [] }, { "key": "issue:globalsign.com", "action": "create", "type": "CAA", "name": "@", "value": "0 issue \"globalsign.com\"", "current": null, "record_id": null, "reason": "caa_cert", "params": { "subject": "shop.northwind.com" } } ], "refusals": [], "certificates": [ { "id": 1, "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "ca": "letsencrypt.org", "wildcard": false, "state": "stays_renewable" }, { "id": 13, "subject": "cdn.northwind.com", "issuer": "Let's Encrypt (R3)", "ca": "letsencrypt.org", "wildcard": false, "state": "stays_renewable" } ], "fronts": [ { "label": "Cloudflare", "ids": [ "letsencrypt.org", "pki.goog" ], "publishes_own": true } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/changes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "batches": [], "timeline": [ { "kind": "audit", "entry": { "id": 21, "action": "dns_zone.exported", "meta": { "zone": "northwind.com", "format": "bind", "records": 10 }, "user_id": 1, "created_at": "2026-01-15T12:00:00.000000Z" } } ], "tracked_since": null, "writable": false, "retention_days": 90, "dynamic_ip_retention_days": 7 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "dns_zone_id": 1, "type": "A", "name": "@", "value": "198.51.100.10", "ttl": 300, "priority": null, "provider_record_id": "rec-200-0", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": true, "live_values": null, "live_checked_at": null, "value_is_placeholder": false, "live_mismatch": null, "dynamic_ip_target": null }, { "id": 88, "dns_zone_id": 1, "type": "A", "name": "archive", "value": "198.51.100.11", "ttl": 300, "priority": null, "provider_record_id": "demo-certificate-archive", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": false, "live_values": [ "198.51.100.11" ], "live_checked_at": "2026-01-15T11:53:00.000000Z", "value_is_placeholder": false, "live_mismatch": false, "dynamic_ip_target": null } ] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"type":"A","name":"api","value":"192.0.2.20","ttl":3600}' ``` **Response** · 201 — Created ```json { "id": 91, "dns_zone_id": 14, "type": "A", "name": "api", "value": "192.0.2.20", "ttl": 3600, "priority": null, "provider_record_id": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": false, "live_values": null, "live_checked_at": null, "value_is_placeholder": false, "live_mismatch": null } ``` **409** — The CAA change would block a certificate's renewing CA ```json { "message": "This CAA change would block the certificate authority that renews status.example.com. Their next renewal would fail.", "error_type": "caa_blocks_renewal", "certificates": [ { "id": 12, "subject": "status.example.com", "ca": "letsencrypt.org" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "dns_zone_id": 1, "type": "A", "name": "@", "value": "198.51.100.10", "ttl": 300, "priority": null, "provider_record_id": "rec-200-0", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": true, "live_values": null, "live_checked_at": null, "value_is_placeholder": false, "live_mismatch": null } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"type":"A","name":"www","value":"192.0.2.11","ttl":3600}' ``` **Response** · 200 ```json { "id": 89, "dns_zone_id": 14, "type": "A", "name": "www", "value": "192.0.2.11", "ttl": 3600, "priority": null, "provider_record_id": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "comment": null, "proxied": false, "live_values": null, "live_checked_at": null, "value_is_placeholder": false, "live_mismatch": null } ``` **409** — The CAA change would block a certificate's renewing CA ```json { "message": "This CAA change would block the certificate authority that renews status.example.com. Their next renewal would fail.", "error_type": "caa_blocks_renewal", "certificates": [ { "id": 12, "subject": "status.example.com", "ca": "letsencrypt.org" } ] } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content **409** — The CAA change would block a certificate's renewing CA ```json { "message": "This CAA change would block the certificate authority that renews status.example.com. Their next renewal would fail.", "error_type": "caa_blocks_renewal", "certificates": [ { "id": 12, "subject": "status.example.com", "ca": "letsencrypt.org" } ] } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records/1/label" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"label":"Main website"}' ``` **Response** · 200 ```json { "label": "Main website", "points_at": { "kind": "custom", "label": "Main website", "url": null, "flagged": false, "since": null, "provider": null, "note": null, "ours": false } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/dns-records/1/propagation" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/dnssec" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "status": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/email-protection?mode=protect" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "zone_id": 1, "zone": "northwind.com", "mode": "no_mail", "route": "here", "where": { "label": "Cloudflare", "url": null }, "provider": null, "providers": [], "records": [], "refusals": [ { "key": "mode", "reason": "receives_mail", "params": [] } ], "lookups": null, "dkim": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/history" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 21, "action": "dns_zone.exported", "meta": { "zone": "northwind.com", "format": "bind", "records": 10 }, "user_id": 1, "created_at": "2026-01-15T12:00:00.000000Z" } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/leftovers" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "items": [], "writable": false, "unanswered_days": 90 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/live-mismatch" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "zone": "northwind.com", "checked_at": "2026-01-15T11:53:00.000000Z", "delegation": { "state": "matches", "reason": null, "live": [ "nina.ns.cloudflare.com", "rick.ns.cloudflare.com" ], "dnssec": null, "belongs_to": "cloudflare", "checked_at": "2026-01-15T11:53:00.000000Z" }, "can_push": false, "records": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/outside-changes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "changes": [], "writable": false } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/points-at?type=A&value=203.0.113.7" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "points_at": { "kind": "server", "label": "web-01", "url": "/servers/1", "flagged": false, "since": null, "provider": "Hetzner", "note": null, "ours": false } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/record-context" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "records": { "1": { "points_at": { "kind": "server", "label": "web-01", "url": "/servers/1", "flagged": false, "since": null, "provider": "Hetzner", "note": { "key": "proxied", "params": { "provider": "Cloudflare" } }, "ours": false }, "used_by": [ { "type": "monitor", "id": 1, "label": "Marketing site", "sublabel": "https://northwind.com", "url": "/monitoring/1", "meta": { "type": "http", "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z" } }, { "type": "monitor", "id": 4, "label": "Checkout flow", "sublabel": "https://northwind.com/checkout", "url": "/monitoring/4", "meta": { "type": "http", "last_status": "down", "last_checked_at": "2026-01-15T11:58:00.000000Z" } } ] }, "2": { "points_at": { "kind": "server", "label": "web-01", "url": "/servers/1", "flagged": false, "since": null, "provider": "Hetzner", "note": { "key": "proxied", "params": { "provider": "Cloudflare" } }, "ours": false }, "used_by": [ { "type": "monitor", "id": 8, "label": "www → apex redirect", "sublabel": "https://www.northwind.com", "url": "/monitoring/8", "meta": { "type": "redirect", "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z" } }, { "type": "certificate", "id": 1, "label": "northwind.com", "sublabel": "2026-03-30", "url": "/certificates/1", "meta": [] } ] } }, "long_ttl": 3600 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/released-address?address=203.0.113.7" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "server": { "id": 1, "name": "web-01" }, "released": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/restore-preview?batch_id=9b2c6a1e-3f7d-4a8e-9c1b-2d3e4f5a6b7c" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/security-check" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "zone": "northwind.com", "checked_at": "2026-01-15T12:00:00.000000Z", "dnssec": { "state": "unknown", "ds": [], "validates": null }, "spf": [], "dmarc": [], "dkim": [], "mx": [], "a": [], "aaaa": [], "caa": [], "wildcard_a": [], "wildcard_aaaa": [], "mta_sts": [], "bimi": [], "ns": [], "ns_matches_provider": null, "snapshot": { "spf": [], "dmarc": [], "dkim_selectors": [], "mx": [], "null_mx": false, "mail_provider": null, "mx_cname_targets": [], "apex_a": [], "apex_aaaa": [], "apex_cname": [], "caa": [], "wildcard_a": [], "wildcard_aaaa": [], "cf_exposed_ips": [], "mta_sts": [], "bimi": [], "apex_ns": [], "ns_matches_provider": null, "mail_subdomains_missing_spf": [] }, "findings": [ { "id": "dnssec", "status": "pass", "variant": "pass" }, { "id": "no_mail", "status": "info", "variant": "info", "fix": { "type": "no_mail" } } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/server-addresses" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": 13, "name": "analytics-01", "status": "stopped", "ipv4": { "address": "192.0.2.80", "basis": "exact" }, "ipv6": null }, { "id": 3, "name": "api-01", "status": "running", "ipv4": { "address": "198.51.100.20", "basis": "exact" }, "ipv6": { "address": "2001:db8:1c1e:5a20::1", "basis": "default", "block": "2001:db8:1c1e:5a20::/64" } } ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/dns-zones/1/sync" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dns-zones/1/zone-file" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 — The zone in BIND format. (`text/plain`)

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dynamic-ips" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "label": "Office — Amsterdam", "current_ipv4": null, "current_ipv6": null, "ipv4_updated_at": null, "ipv6_updated_at": null, "last_used_at": null, "created_by": 1, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "observed_ipv4": null, "observed_ipv6": null, "alert_on_change": true, "firewall_strict": false, "firewall_fail_closed": false, "country_code": null, "city": null, "asn": null, "asn_org": null, "is_hosting": false, "silent_notified_at": null, "public_id": null, "last_attempt_at": null, "last_attempt_result": null, "last_attempt_ip": null, "last_attempt_agent": null, "agent_server_id": null, "targets_count": 0, "tags": [], "targets": [] } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dynamic-ips/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "label": "Office — Amsterdam", "current_ipv4": null, "current_ipv6": null, "ipv4_updated_at": null, "ipv6_updated_at": null, "last_used_at": null, "created_by": 1, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "observed_ipv4": null, "observed_ipv6": null, "alert_on_change": true, "firewall_strict": false, "firewall_fail_closed": false, "country_code": null, "city": null, "asn": null, "asn_org": null, "is_hosting": false, "silent_notified_at": null, "public_id": null, "last_attempt_at": null, "last_attempt_result": null, "last_attempt_ip": null, "last_attempt_agent": null, "agent_server_id": null, "targets_count": 0, "targets": [], "events": [], "agent_server": null, "can_reveal": false } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dynamic-ips/1/history" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "entries": [], "truncated": false } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/dynamic-ips/agent-servers" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 3, "name": "api-01", "agent_last_seen_at": "2026-01-15T11:57:00+00:00" } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 10, "organization_id": 1, "source": "manual", "monitoring_check_id": null, "domain_id": null, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "61e58004edb797c08c1261beb441b56e31cc903bde63441cd503dca9aa79f099", "subject": "vpn.northwind.example", "issuer": "vpn.northwind.example", "serial": "EAABC774", "sans": [ "vpn.northwind.example" ], "not_before": "2025-01-03T12:00:00.000000Z", "not_after": "2026-01-03T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "rsa", "key_bits": 4096, "sig_algo": "SHA256-RSA", "trust": "self_signed", "validation": "OV", "is_wildcard": false, "is_multi_san": false, "managed": false, "renewal_source": null, "classification_override": null, "status": "expired", "superseded_by_id": null, "dismissed_at": null, "deployment_locations": [], "owner": null, "notes": null, "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": null, "chain_status": null, "sources": [ { "source": "manual", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": null, "caissuer_url": null, "no_auto_merge": false, "price_yearly": "0.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "internal", "renewal_type_basis": "guess", "served_status": null, "served_checked_at": null, "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null, "custom_fields": [], "renewer": null, "findings": [ { "tier": "problem", "code": "expired", "severity": "critical", "subject": { "type": "certificate", "id": 10, "name": "vpn.northwind.example" }, "certificate_ids": [ 10 ], "addresses": [], "attention_key": "certificate:10", "due_at": "2026-01-03T12:00:00+00:00", "evidence": { "expires_at": "2026-01-03T12:00:00+00:00", "days_left": -12, "renews_itself": false, "renewal_type": "internal", "renewal_type_basis": "guess", "renewal_source": null, "issuer": "vpn.northwind.example", "served_status": null, "role": null, "renewer": null }, "copy": { "title": { "key": "certificates.rules.expired.title", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } }, "detail": { "key": "certificates.rules.expired.detail", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } }, "short": { "key": "certificates.rules.expired.short", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } } }, "fix": { "kind": "route", "label": "certificates.rules.expired.fix", "route": "/certificates/10" }, "dismissible": false, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] } ], "finding": { "tier": "problem", "code": "expired", "severity": "critical", "subject": { "type": "certificate", "id": 10, "name": "vpn.northwind.example" }, "certificate_ids": [ 10 ], "addresses": [], "attention_key": "certificate:10", "due_at": "2026-01-03T12:00:00+00:00", "evidence": { "expires_at": "2026-01-03T12:00:00+00:00", "days_left": -12, "renews_itself": false, "renewal_type": "internal", "renewal_type_basis": "guess", "renewal_source": null, "issuer": "vpn.northwind.example", "served_status": null, "role": null, "renewer": null }, "copy": { "title": { "key": "certificates.rules.expired.title", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } }, "detail": { "key": "certificates.rules.expired.detail", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } }, "short": { "key": "certificates.rules.expired.short", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } } }, "fix": { "kind": "route", "label": "certificates.rules.expired.fix", "route": "/certificates/10" }, "dismissible": false, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] }, "health": { "grade": "warning", "letter": null, "issues": [ { "code": "self_signed", "severity": "warning" } ] }, "in_use": false, "tags": [], "check": null, "domain": null }, { "id": 2, "organization_id": 1, "source": "probe", "monitoring_check_id": 2, "domain_id": 3, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "b6b045177e3469ad718546c6233a2b7f0166d10e466deeaa6d16f6244f6654db", "subject": "northwind-app.dev", "issuer": "Let's Encrypt (R11)", "serial": "B4B32EC4", "sans": [ "northwind-app.dev", "*.northwind-app.dev" ], "not_before": "2025-11-07T12:00:00.000000Z", "not_after": "2026-02-05T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "ecdsa", "key_bits": 256, "sig_algo": "ECDSA-SHA256", "trust": "public", "validation": "DV", "is_wildcard": true, "is_multi_san": true, "managed": true, "renewal_source": "Let's Encrypt (R11)", "classification_override": null, "status": "expiring_soon", "superseded_by_id": null, "dismissed_at": null, "deployment_locations": [ { "endpoint": "northwind-app.dev:443", "last_seen": "2026-01-15T11:50:00+00:00", "first_seen": "2026-01-08T12:00:00+00:00" } ], "owner": null, "notes": null, "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": [ { "subject": "northwind-app.dev", "issuer": "Let's Encrypt (R11)", "is_ca": false, "self_signed": false, "not_after": "2026-02-05T12:00:00+00:00", "fingerprint": "b6b045177e3469ad718546c6233a2b7f0166d10e466deeaa6d16f6244f6654db" }, { "subject": "Let's Encrypt (R11)", "issuer": "ISRG Root X1", "is_ca": true, "self_signed": false, "not_after": "2030-01-15T12:00:00+00:00", "fingerprint": "c12c8a7dcb3f10b2cfd6efb6d14e6516f76cb6d3537ffae6a1f804b618d0cf3c" } ], "chain_status": "trusted", "sources": [ { "source": "probe", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": null, "caissuer_url": "http://r11.i.lencr.org/", "no_auto_merge": false, "price_yearly": "0.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "automatic", "renewal_type_basis": "guess", "served_status": "served", "served_checked_at": "2026-01-15T11:50:00.000000Z", "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null, "custom_fields": [], "renewer": null, "findings": [ { "tier": "problem", "code": "renewal_overdue", "severity": "warning", "subject": { "type": "certificate", "id": 2, "name": "northwind-app.dev" }, "certificate_ids": [ 2 ], "addresses": [ "northwind-app.dev:443" ], "attention_key": "certificate_renewal:2", "due_at": "2026-02-05T12:00:00+00:00", "evidence": { "expires_at": "2026-02-05T12:00:00+00:00", "days_left": 21, "renews_itself": true, "renewal_type": "automatic", "renewal_type_basis": "guess", "renewal_source": "Let's Encrypt (R11)", "issuer": "Let's Encrypt (R11)", "served_status": "served", "role": null, "renewer": null, "renews_around_at": "2026-01-06T00:00:00+00:00", "last_seen_at": "2026-01-15T06:00:00+00:00" }, "copy": { "title": { "key": "certificates.rules.renewal_overdue.title", "params": { "renews_at": "2026-01-06T00:00:00+00:00", "expires_at": "2026-02-05T12:00:00+00:00", "n": 9, "name": "northwind-app.dev" } }, "detail": { "key": "certificates.rules.renewal_overdue.detail", "params": { "renews_at": "2026-01-06T00:00:00+00:00", "expires_at": "2026-02-05T12:00:00+00:00", "n": 9, "name": "northwind-app.dev" } }, "short": { "key": "certificates.rules.renewal_overdue.short", "params": { "renews_at": "2026-01-06T00:00:00+00:00", "expires_at": "2026-02-05T12:00:00+00:00", "n": 9, "name": "northwind-app.dev" } } }, "fix": { "kind": "route", "label": "certificates.rules.renewal_overdue.fix", "route": "/certificates/2" }, "dismissible": true, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] } ], "finding": { "tier": "problem", "code": "renewal_overdue", "severity": "warning", "subject": { "type": "certificate", "id": 2, "name": "northwind-app.dev" }, "certificate_ids": [ 2 ], "addresses": [ "northwind-app.dev:443" ], "attention_key": "certificate_renewal:2", "due_at": "2026-02-05T12:00:00+00:00", "evidence": { "expires_at": "2026-02-05T12:00:00+00:00", "days_left": 21, "renews_itself": true, "renewal_type": "automatic", "renewal_type_basis": "guess", "renewal_source": "Let's Encrypt (R11)", "issuer": "Let's Encrypt (R11)", "served_status": "served", "role": null, "renewer": null, "renews_around_at": "2026-01-06T00:00:00+00:00", "last_seen_at": "2026-01-15T06:00:00+00:00" }, "copy": { "title": { "key": "certificates.rules.renewal_overdue.title", "params": { "renews_at": "2026-01-06T00:00:00+00:00", "expires_at": "2026-02-05T12:00:00+00:00", "n": 9, "name": "northwind-app.dev" } }, "detail": { "key": "certificates.rules.renewal_overdue.detail", "params": { "renews_at": "2026-01-06T00:00:00+00:00", "expires_at": "2026-02-05T12:00:00+00:00", "n": 9, "name": "northwind-app.dev" } }, "short": { "key": "certificates.rules.renewal_overdue.short", "params": { "renews_at": "2026-01-06T00:00:00+00:00", "expires_at": "2026-02-05T12:00:00+00:00", "n": 9, "name": "northwind-app.dev" } } }, "fix": { "kind": "route", "label": "certificates.rules.renewal_overdue.fix", "route": "/certificates/2" }, "dismissible": true, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] }, "health": { "grade": "good", "letter": "A", "issues": [] }, "in_use": true, "tags": [ { "id": 6, "name": "Northwind Platform", "color": "#14b8a6", "pivot": { "taggable_type": "App\\Models\\SslCertificate", "taggable_id": 2, "tag_id": 6 } } ], "check": { "id": 2, "name": "App — northwind-app.dev", "target": "https://northwind-app.dev", "interval_minutes": 0 }, "domain": { "id": 3, "name": "northwind-app", "tld": "dev", "full_name": "northwind-app.dev", "archivable": true, "dns_host": null, "management": "tracked", "sync_halt": null } } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "source": "probe", "monitoring_check_id": 1, "domain_id": 1, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9", "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "serial": "2395BA42", "sans": [ "northwind.com", "www.northwind.com" ], "not_before": "2025-12-30T12:00:00.000000Z", "not_after": "2026-03-30T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "rsa", "key_bits": 2048, "sig_algo": "SHA256-RSA", "trust": "public", "validation": "DV", "is_wildcard": false, "is_multi_san": true, "managed": true, "renewal_source": "Let's Encrypt (R3)", "classification_override": null, "status": "valid", "superseded_by_id": null, "dismissed_at": null, "deployment_locations": [ { "endpoint": "northwind.com:443", "last_seen": "2026-01-15T11:50:00+00:00", "first_seen": "2026-01-08T12:00:00+00:00" } ], "owner": null, "notes": null, "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": [ { "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "is_ca": false, "self_signed": false, "not_after": "2026-03-30T12:00:00+00:00", "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9" }, { "subject": "Let's Encrypt (R3)", "issuer": "ISRG Root X1", "is_ca": true, "self_signed": false, "not_after": "2030-01-15T12:00:00+00:00", "fingerprint": "e04ca19ed66485fb479283c98fbfb4cda1ab67de1965304902bec3f6a55a2c8e" } ], "chain_status": "trusted", "sources": [ { "source": "probe", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": "ok", "caissuer_url": "http://r3.i.lencr.org/", "no_auto_merge": false, "price_yearly": "0.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "automatic", "renewal_type_basis": "guess", "served_status": "served", "served_checked_at": "2026-01-15T11:50:00.000000Z", "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null, "health": { "grade": "good", "letter": "A", "issues": [] }, "in_use": true, "tags": [ { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\SslCertificate", "taggable_id": 1, "tag_id": 5 } } ], "check": { "id": 1, "name": "Marketing site", "target": "https://northwind.com", "interval_minutes": 0 }, "domain": { "id": 1, "name": "northwind", "tld": "com", "full_name": "northwind.com", "archivable": true, "dns_host": null, "management": "tracked", "sync_halt": null }, "cloud_server": null, "provider_credential": null, "superseded_by": null, "owner_user": null, "owner_candidates": [ { "id": 1, "name": "Alex Rivera" }, { "id": 3, "name": "Priya Raghunathan" } ], "bundle_available": false, "whereabouts": { "role": "current", "current_certificate": null, "renewer": null, "served_on": [ { "endpoint_id": 1, "host": "northwind.com", "port": 443, "as": "edge", "proxied": true, "last_checked_at": "2026-01-15T11:50:00+00:00", "last_check_source": "scan", "zone": { "id": 1, "name": "northwind.com", "domain_id": 1 }, "dns_record": { "id": 1, "type": "A", "name": "@", "value": "198.51.100.10" }, "cloud_server": { "id": 1, "name": "web-01" }, "monitor": { "id": 1, "name": "Marketing site" }, "renewer": null } ], "lifecycle": { "previous": null, "next": null, "replaced_at": null, "renewals": 0, "lead_days": null, "expected_renewal_at": "2026-02-28T12:00:00+00:00" }, "rollout": null }, "findings": [] } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/certificates/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"owner":"Platform team","notes":"Renewed automatically by the load balancer."}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "source": "probe", "monitoring_check_id": 1, "domain_id": 1, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9", "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "serial": "2395BA42", "sans": [ "northwind.com", "www.northwind.com" ], "not_before": "2025-12-30T12:00:00.000000Z", "not_after": "2026-03-30T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "rsa", "key_bits": 2048, "sig_algo": "SHA256-RSA", "trust": "public", "validation": "DV", "is_wildcard": false, "is_multi_san": true, "managed": true, "renewal_source": "Let's Encrypt (R3)", "classification_override": null, "status": "valid", "superseded_by_id": null, "dismissed_at": null, "deployment_locations": [ { "endpoint": "northwind.com:443", "last_seen": "2026-01-15T11:50:00+00:00", "first_seen": "2026-01-08T12:00:00+00:00" } ], "owner": "Platform team", "notes": "Renewed automatically by the load balancer.", "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": [ { "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "is_ca": false, "self_signed": false, "not_after": "2026-03-30T12:00:00+00:00", "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9" }, { "subject": "Let's Encrypt (R3)", "issuer": "ISRG Root X1", "is_ca": true, "self_signed": false, "not_after": "2030-01-15T12:00:00+00:00", "fingerprint": "e04ca19ed66485fb479283c98fbfb4cda1ab67de1965304902bec3f6a55a2c8e" } ], "chain_status": "trusted", "sources": [ { "source": "probe", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": "ok", "caissuer_url": "http://r3.i.lencr.org/", "no_auto_merge": false, "price_yearly": "0.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "automatic", "renewal_type_basis": "guess", "served_status": "served", "served_checked_at": "2026-01-15T11:50:00.000000Z", "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null, "tags": [ { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\SslCertificate", "taggable_id": 1, "tag_id": 5 } } ], "owner_user": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/1/bundle" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/1/caa-fix" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/certificates/1/dismiss" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "source": "probe", "monitoring_check_id": 1, "domain_id": 1, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9", "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "serial": "2395BA42", "sans": [ "northwind.com", "www.northwind.com" ], "not_before": "2025-12-30T12:00:00.000000Z", "not_after": "2026-03-30T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "rsa", "key_bits": 2048, "sig_algo": "SHA256-RSA", "trust": "public", "validation": "DV", "is_wildcard": false, "is_multi_san": true, "managed": true, "renewal_source": "Let's Encrypt (R3)", "classification_override": null, "status": "valid", "superseded_by_id": null, "dismissed_at": "2026-01-15T12:00:00.000000Z", "deployment_locations": [ { "endpoint": "northwind.com:443", "last_seen": "2026-01-15T11:50:00+00:00", "first_seen": "2026-01-08T12:00:00+00:00" } ], "owner": null, "notes": null, "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": [ { "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "is_ca": false, "self_signed": false, "not_after": "2026-03-30T12:00:00+00:00", "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9" }, { "subject": "Let's Encrypt (R3)", "issuer": "ISRG Root X1", "is_ca": true, "self_signed": false, "not_after": "2030-01-15T12:00:00+00:00", "fingerprint": "e04ca19ed66485fb479283c98fbfb4cda1ab67de1965304902bec3f6a55a2c8e" } ], "chain_status": "trusted", "sources": [ { "source": "probe", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": "ok", "caissuer_url": "http://r3.i.lencr.org/", "no_auto_merge": false, "price_yearly": "0.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "automatic", "renewal_type_basis": "guess", "served_status": "served", "served_checked_at": "2026-01-15T11:50:00.000000Z", "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null, "tags": [ { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\SslCertificate", "taggable_id": 1, "tag_id": 5 } } ] } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/certificates/1/pricing" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"price_yearly":59,"currency":"EUR"}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "source": "probe", "monitoring_check_id": 1, "domain_id": 1, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9", "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "serial": "2395BA42", "sans": [ "northwind.com", "www.northwind.com" ], "not_before": "2025-12-30T12:00:00.000000Z", "not_after": "2026-03-30T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "rsa", "key_bits": 2048, "sig_algo": "SHA256-RSA", "trust": "public", "validation": "DV", "is_wildcard": false, "is_multi_san": true, "managed": true, "renewal_source": "Let's Encrypt (R3)", "classification_override": null, "status": "valid", "superseded_by_id": null, "dismissed_at": null, "deployment_locations": [ { "endpoint": "northwind.com:443", "last_seen": "2026-01-15T11:50:00+00:00", "first_seen": "2026-01-08T12:00:00+00:00" } ], "owner": null, "notes": null, "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": [ { "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "is_ca": false, "self_signed": false, "not_after": "2026-03-30T12:00:00+00:00", "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9" }, { "subject": "Let's Encrypt (R3)", "issuer": "ISRG Root X1", "is_ca": true, "self_signed": false, "not_after": "2030-01-15T12:00:00+00:00", "fingerprint": "e04ca19ed66485fb479283c98fbfb4cda1ab67de1965304902bec3f6a55a2c8e" } ], "chain_status": "trusted", "sources": [ { "source": "probe", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": "ok", "caissuer_url": "http://r3.i.lencr.org/", "no_auto_merge": false, "price_yearly": "59.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "automatic", "renewal_type_basis": "guess", "served_status": "served", "served_checked_at": "2026-01-15T11:50:00.000000Z", "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/1/timeline" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "events": [ { "type": "issued", "at": "2025-12-30T12:00:00+00:00", "fingerprint": "6f6f72db3001" } ], "generations": 1, "markers": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/coverage" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "domain_id": 11, "domain": "northwind.cloud", "status": "covered", "certificate": { "id": 6, "subject": "*.northwind.cloud", "not_after": "2026-03-17T12:00:00.000000Z", "status": "valid", "source": "hetzner" } }, { "domain_id": 1, "domain": "northwind.com", "status": "covered", "certificate": { "id": 8, "subject": "cdn.northwind.com", "not_after": "2026-11-11T12:00:00.000000Z", "status": "valid", "source": "cloudflare" } } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/findings" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "findings": [ { "tier": "problem", "code": "expired", "severity": "critical", "subject": { "type": "certificate", "id": 10, "name": "vpn.northwind.example" }, "certificate_ids": [ 10 ], "addresses": [], "attention_key": "certificate:10", "due_at": "2026-01-03T12:00:00+00:00", "evidence": { "expires_at": "2026-01-03T12:00:00+00:00", "days_left": -12, "renews_itself": false, "renewal_type": "internal", "renewal_type_basis": "guess", "renewal_source": null, "issuer": "vpn.northwind.example", "served_status": null, "role": null, "renewer": null }, "copy": { "title": { "key": "certificates.rules.expired.title", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } }, "detail": { "key": "certificates.rules.expired.detail", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } }, "short": { "key": "certificates.rules.expired.short", "params": { "expires_at": "2026-01-03T12:00:00+00:00", "name": "vpn.northwind.example" } } }, "fix": { "kind": "route", "label": "certificates.rules.expired.fix", "route": "/certificates/10" }, "dismissible": false, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] }, { "tier": "problem", "code": "domain_expires_first", "severity": "warning", "subject": { "type": "certificate", "id": 12, "name": "northwind.shop" }, "certificate_ids": [ 12 ], "addresses": [ "northwind.shop:443" ], "attention_key": "domain:10", "due_at": "2026-01-26T00:00:00+00:00", "evidence": { "expires_at": "2026-03-17T12:00:00+00:00", "days_left": 61, "renews_itself": true, "renewal_type": "automatic", "renewal_type_basis": "guess", "renewal_source": "Let's Encrypt (R11)", "issuer": "Let's Encrypt (R11)", "served_status": "served", "role": null, "renewer": null, "domain_id": 10, "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "domain_auto_renew": false }, "copy": { "title": { "key": "certificates.rules.domain_expires_first.title", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } }, "detail": { "key": "certificates.rules.domain_expires_first.detail", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } }, "short": { "key": "certificates.rules.domain_expires_first.short", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } } }, "fix": { "kind": "route", "label": "certificates.rules.domain_expires_first.fix", "route": "/domains/10" }, "dismissible": true, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] } ], "counts": { "problem": 6, "recommendation": 6, "info": 0 } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/fixes/domains" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "domains": [], "room": null, "allowed": true } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/fixes/done" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "lines": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/fixes/monitors" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "addresses": [ { "address": "archive.northwind.com:443", "host": "archive.northwind.com", "port": 443, "certificates": [ { "id": 18, "name": "archive.northwind.com" } ], "monitor": { "name": "archive.northwind.com", "type": "ssl", "target": "archive.northwind.com", "interval_seconds": 3600 }, "unsupported": null }, { "address": "billing.northwind.nl:443", "host": "billing.northwind.nl", "port": 443, "certificates": [ { "id": 14, "name": "billing.northwind.nl" } ], "monitor": { "name": "billing.northwind.nl", "type": "ssl", "target": "billing.northwind.nl", "interval_seconds": 3600 }, "unsupported": null } ], "room": null, "allowed": true } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/certificates/overview" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "summary": { "state": "needs_you", "addresses_needing_you": 5, "other_problems": 1, "first_problem": { "endpoint_id": 7 }, "todo": [ { "endpoint_id": 7, "host": "northwind.shop", "port": 443, "address": "northwind.shop:443", "finding": { "tier": "problem", "code": "domain_expires_first", "severity": "warning", "subject": { "type": "certificate", "id": 12, "name": "northwind.shop" }, "certificate_ids": [ 12 ], "addresses": [ "northwind.shop:443" ], "attention_key": "domain:10", "due_at": "2026-01-26T00:00:00+00:00", "evidence": { "expires_at": "2026-03-17T12:00:00+00:00", "days_left": 61, "renews_itself": true, "renewal_type": "automatic", "renewal_type_basis": "guess", "renewal_source": "Let's Encrypt (R11)", "issuer": "Let's Encrypt (R11)", "served_status": "served", "role": null, "renewer": null, "domain_id": 10, "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "domain_auto_renew": false }, "copy": { "title": { "key": "certificates.rules.domain_expires_first.title", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } }, "detail": { "key": "certificates.rules.domain_expires_first.detail", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } }, "short": { "key": "certificates.rules.domain_expires_first.short", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } } }, "fix": { "kind": "route", "label": "certificates.rules.domain_expires_first.fix", "route": "/domains/10" }, "dismissible": true, "advisor": null, "decision": null, "automation": null, "sources": [], "also": [] }, "attention_keys": [ "domain:10" ] } ], "decided": [], "addresses": 12, "domains": 5, "renew_automatically": 8, "monitored": 5, "recommendations": 6, "watched": 1, "next_renewal": { "host": "staging.northwind-app.dev", "more": 0, "at": "2026-01-18T00:00:00+00:00", "who": "automatic" } }, "timeline": [ { "certificate_id": 16, "subject": "northwind-mail.com", "issuer": "Sectigo RSA Organization Validation Secure Server CA", "expires_at": "2026-02-02T12:00:00+00:00", "renews_at": null, "who": "you", "endpoint_ids": [ 11 ], "hosts": [ "mx1.northwind-mail.com" ], "listed": true } ], "needs_you": [ { "kind": "problem", "at": "2026-01-26T00:00:00+00:00", "now": false, "severity": "warning", "endpoint_id": 7, "hosts": [ "northwind.shop" ], "reason": { "key": "certificates.rules.domain_expires_first.short", "params": { "domain": "northwind.shop", "domain_expires_at": "2026-01-26T00:00:00+00:00", "expires_at": "2026-03-17T12:00:00+00:00", "name": "northwind.shop" } }, "who": null } ], "groups": [ { "key": "domain:northwind-mail.com", "domain_id": 16, "name": "northwind-mail.com", "in_domains": true, "rows": [ { "domain_id": 16, "endpoint_id": 11, "host": "mx1.northwind-mail.com", "port": 993, "address": "mx1.northwind-mail.com:993", "status": "problem", "severity": "warning", "reason": { "key": "certificates.rules.rollout_incomplete.short", "params": { "address": "mx1.northwind-mail.com:993", "name": "northwind-mail.com", "done": 1, "total": 2, "expires_at": "2026-02-02T12:00:00+00:00", "server": "mail-01" } }, "check_note": null, "certificate": { "id": 16, "subject": "northwind-mail.com", "issuer": "Sectigo RSA Organization Validation Secure Server CA", "not_after": "2026-02-02T12:00:00+00:00", "status": "superseded", "role": null }, "origin_certificate": null, "served_by": { "kind": "server", "provider": "transip", "provider_label": "TransIP", "cloud_server": { "id": 14, "name": "mail-01" }, "resolved_ips": [ "198.51.100.166" ], "edge_network": null, "network": null, "display": { "kind": "server", "name": "mail-01", "ip": "198.51.100.166" }, "dns_record": { "id": 53, "type": "A", "name": "mx1", "value": "198.51.100.166", "zone": { "id": 9, "name": "northwind-mail.com" } } }, "renewal": { "type": "manual_paid", "source": null, "renews_itself": false, "actor": "you" }, "ownership": { "is": "yours", "basis": "domain", "override": null }, "monitor": null, "last_checked_at": "2026-01-15T11:50:00+00:00", "last_check_source": "scan", "last_attempt_at": "2026-01-15T11:50:00+00:00", "failing": null, "findings": [ { "tier": "problem", "code": "rollout_incomplete", "severity": "warning", "subject": { "type": "address", "id": 11, "name": "mx1.northwind-mail.com:993" }, "certificate_ids": [ 16 ], "addresses": [ "mx1.northwind-mail.com:993" ], "attention_key": "certificate_rollout:11", "due_at": "2026-02-02T12:00:00+00:00", "evidence": { "endpoint_id": 11, "serves_certificate_id": 16, "successor_id": 15, "expires_at": "2026-02-02T12:00:00+00:00", "done": 1, "total": 2, "last_checked_at": "2026-01-15T11:50:00+00:00" }, "copy": { "title": { "key": "certificates.rules.rollout_incomplete.title", "params": { "address": "mx1.northwind-mail.com:993", "name": "northwind-mail.com", "done": 1, "total": 2, "expires_at": "2026-02-02T12:00:00+00:00" } }, "detail": { "key": "certificates.rules.rollout_incomplete.detailServer", "params": { "address": "mx1.northwind-mail.com:993", "name": "northwind-mail.com", "done": 1, "total": 2, "expires_at": "2026-02-02T12:00:00+00:00", "server": "mail-01" }, "count": 2 }, "short": { "key": "certificates.rules.rollout_incomplete.short", "params": { "address": "mx1.northwind-mail.com:993", "name": "northwind-mail.com", "done": 1, "total": 2, "expires_at": "2026-02-02T12:00:00+00:00", "server": "mail-01" } } }, "fix": { "kind": "action", "label": "certificates.rules.rollout_incomplete.fix", "action": "certificate.scan", "method": "POST", "endpoint": "/organizations/1/certificates/scan", "body": { "host": "mx1.northwind-mail.com", "port": 993 } }, "dismissible": true, "advisor": null, "decision": null, "automation": { "template": "cert_rollout_not_live_alert", "action": "send_notification", "provider": null, "connected": true, "conditions": [], "title": { "key": "certificates.automate.cert_rollout_not_live_alert", "params": { "days": 0 } } }, "sources": [ { "source": "check", "tone": "bad", "copy": { "key": "certificates.evidence.check.oldCertificate", "params": [] } } ], "also": [] } ], "set_aside": false } ], "count": 2, "problems": 1, "next_expiry": "2026-02-02T12:00:00+00:00" } ], "watched": [ { "endpoint_id": 13, "host": "status.supplier.example", "port": 443, "address": "status.supplier.example:443", "domain_id": null, "status": "ok", "severity": null, "reason": null, "check_note": null, "certificate": { "id": 19, "subject": "status.supplier.example", "issuer": "Let's Encrypt (R3)", "not_after": "2026-03-28T12:00:00+00:00", "status": "valid", "role": null }, "origin_certificate": null, "served_by": { "kind": "address", "provider": null, "provider_label": null, "cloud_server": null, "resolved_ips": [ "203.0.113.210" ], "edge_network": null, "network": null, "display": { "kind": "ip", "name": "203.0.113.210", "ip": "203.0.113.210" }, "dns_record": null }, "renewal": { "type": "automatic", "source": "Let's Encrypt (R3)", "renews_itself": true, "actor": "automatic" }, "ownership": { "is": "watched", "basis": "none", "override": null }, "monitor": { "id": 13, "name": "Supplier status", "status": "up", "last_checked_at": "2026-01-15T11:58:00+00:00" }, "last_checked_at": "2026-01-15T11:50:00+00:00", "last_check_source": "scan", "last_attempt_at": "2026-01-15T11:50:00+00:00", "failing": null, "findings": [] } ], "recommendations": [ { "tier": "recommendation", "code": "chain_incomplete", "severity": "warning", "subject": { "type": "certificate", "id": 4, "name": "docs.northwind.com" }, "certificate_ids": [ 4 ], "addresses": [ "docs.northwind.com:443" ], "attention_key": null, "due_at": null, "evidence": { "expires_at": "2026-03-08T12:00:00+00:00", "days_left": 52, "renews_itself": true, "renewal_type": "automatic", "renewal_type_basis": "guess", "renewal_source": "Let's Encrypt (R11)", "issuer": "Let's Encrypt (R11)", "served_status": "served", "role": null, "renewer": null, "chain_status": "incomplete" }, "copy": { "title": { "key": "certificates.rules.chain_incomplete.title", "params": { "name": "docs.northwind.com" } }, "detail": { "key": "certificates.rules.chain_incomplete.detail", "params": { "name": "docs.northwind.com" } }, "short": { "key": "certificates.rules.chain_incomplete.short", "params": { "name": "docs.northwind.com" } } }, "fix": { "kind": "route", "label": "certificates.rules.chain_incomplete.fix", "route": "/certificates/4" }, "dismissible": true, "advisor": { "resource_type": "certificate", "resource_id": "4", "check_id": "chain" }, "decision": null, "automation": null, "sources": [], "also": [] } ], "recommendation_groups": [ { "code": "chain_incomplete", "severity": "warning", "items": [ { "tier": "recommendation", "code": "chain_incomplete", "severity": "warning", "subject": { "type": "certificate", "id": 4, "name": "docs.northwind.com" }, "certificate_ids": [ 4 ], "addresses": [ "docs.northwind.com:443" ], "attention_key": null, "due_at": null, "evidence": { "expires_at": "2026-03-08T12:00:00+00:00", "days_left": 52, "renews_itself": true, "renewal_type": "automatic", "renewal_type_basis": "guess", "renewal_source": "Let's Encrypt (R11)", "issuer": "Let's Encrypt (R11)", "served_status": "served", "role": null, "renewer": null, "chain_status": "incomplete" }, "copy": { "title": { "key": "certificates.rules.chain_incomplete.title", "params": { "name": "docs.northwind.com" } }, "detail": { "key": "certificates.rules.chain_incomplete.detail", "params": { "name": "docs.northwind.com" } }, "short": { "key": "certificates.rules.chain_incomplete.short", "params": { "name": "docs.northwind.com" } } }, "fix": { "kind": "route", "label": "certificates.rules.chain_incomplete.fix", "route": "/certificates/4" }, "dismissible": true, "advisor": { "resource_type": "certificate", "resource_id": "4", "check_id": "chain" }, "decision": null, "automation": null, "sources": [], "also": [] } ], "count": 1, "copy": { "title": { "key": "certificates.overview.recGroups.chain_incomplete.title", "params": { "n": 1 } }, "detail": { "key": "certificates.overview.recGroups.chain_incomplete.detail", "params": { "n": 1 } } }, "fix": { "kind": "route", "label": "certificates.rules.chain_incomplete.fix", "route": "/certificates/4" }, "dismiss": [ { "resource_type": "certificate", "resource_id": "4", "check_id": "chain" } ] } ], "dismissed_recommendations": [], "tidied": { "replaced": 2, "not_served": 0, "provider": 0, "merged": 1, "dismissed": 0, "untracked": 0 }, "untracked": [], "inventory": [ { "id": 10, "subject": "vpn.northwind.example", "issuer": "vpn.northwind.example", "source": "manual", "sources": [ "manual" ], "not_after": "2026-01-03T12:00:00+00:00", "status": "expired", "role": "not_seen", "hosts": [], "superseded_by_id": null } ], "owner_candidates": [ { "id": 1, "name": "Alex Rivera" } ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/certificates/owner" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"certificate_ids":[1],"user_id":1}' ``` **Response** · 200 ```json { "assigned": 1, "owner": { "id": 1, "name": "Alex Rivera" } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-firewalls" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 6, "organization_id": 1, "provider": "digitalocean", "provider_firewall_id": "fw-6", "name": "legacy-vpn", "rules": [ { "port": "1194", "protocol": "udp", "direction": "in", "source_ips": [ "0.0.0.0/0" ], "description": "OpenVPN" } ], "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 9, "applied_to_count": 0, "applied_server_ids": [], "delete_protection": false, "capabilities": { "native_delete_protection": false, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": false, "snapshots": true, "backups": true, "isos": false, "rescue": false, "placement_groups": false, "public_network_toggle": false, "scheduled_backups": true, "private_networks": true, "private_network_attach": false, "network_join_on_create": true, "network_attach_ip_choice": false, "private_network_unfiltered": false, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": false, "network_routes": false, "network_rename": true, "network_ip_range_extendable": false, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": false, "volume_native_delete_protection": false, "network_native_delete_protection": false, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": false, "rdns_address_list": false, "reverse_dns": false, "snapshot_description": false, "snapshot_protection": false }, "sync_halt": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [], "dynamic_ip_targets": [] }, { "id": 4, "organization_id": 1, "provider": "digitalocean", "provider_firewall_id": "fw-4", "name": "staging", "rules": [ { "port": "443", "protocol": "tcp", "direction": "in", "source_ips": [ "0.0.0.0/0" ], "description": "HTTPS" }, { "port": "22", "protocol": "tcp", "direction": "in", "source_ips": [ "203.0.113.0/24" ], "description": "SSH from the office" } ], "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 9, "applied_to_count": 2, "applied_server_ids": [ "109", "110" ], "delete_protection": false, "capabilities": { "native_delete_protection": false, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": false, "snapshots": true, "backups": true, "isos": false, "rescue": false, "placement_groups": false, "public_network_toggle": false, "scheduled_backups": true, "private_networks": true, "private_network_attach": false, "network_join_on_create": true, "network_attach_ip_choice": false, "private_network_unfiltered": false, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": false, "network_routes": false, "network_rename": true, "network_ip_range_extendable": false, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": false, "volume_native_delete_protection": false, "network_native_delete_protection": false, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": false, "rdns_address_list": false, "reverse_dns": false, "snapshot_description": false, "snapshot_protection": false }, "sync_halt": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [], "dynamic_ip_targets": [] } ], "first_page_url": "http://localhost/api/organizations/1/cloud-firewalls?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/cloud-firewalls?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/cloud-firewalls?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/cloud-firewalls", "per_page": 20, "prev_page_url": null, "to": 6, "total": 6 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-firewalls/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_firewall_id": "fw-1", "name": "web-tier", "rules": [ { "port": "443", "protocol": "tcp", "direction": "in", "source_ips": [ "0.0.0.0/0", "::/0" ], "description": "HTTPS" }, { "port": "80", "protocol": "tcp", "direction": "in", "source_ips": [ "0.0.0.0/0", "::/0" ], "description": "HTTP" } ], "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "applied_to_count": 4, "applied_server_ids": [ "100", "101" ], "delete_protection": false, "sync_halt": null, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "firewall_protocols": [ "tcp", "udp" ], "tags": [], "dynamic_ip_targets": [], "untracked_sources": [], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-firewalls/1/drift" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-load-balancers" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 3, "organization_id": 1, "provider": "digitalocean", "provider_lb_id": "lb-3", "name": "staging-lb", "status": "running", "load_balancer_type": "lb-small", "ipv4": "203.0.113.60", "ipv6": "2001:db8::60", "datacenter": "ams3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 9, "algorithm": "round_robin", "services": [ { "protocol": "https", "listen_port": 443, "destination_port": 443 } ], "targets": [ { "type": "server", "server_id": 10 } ], "price_monthly": "12.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "sync_halt": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] }, { "id": 2, "organization_id": 1, "provider": "hetzner", "provider_lb_id": "lb-2", "name": "api-lb", "status": "running", "load_balancer_type": "lb21", "ipv4": "203.0.113.51", "ipv6": "2001:db8::51", "datacenter": "fsn1-dc14", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "algorithm": "least_connections", "services": [ { "protocol": "https", "listen_port": 443, "destination_port": 443 } ], "targets": [ { "type": "server", "server_id": 3 }, { "type": "server", "server_id": 6 } ], "price_monthly": "19.90", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "sync_halt": null, "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] } ], "first_page_url": "http://localhost/api/organizations/1/cloud-load-balancers?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/cloud-load-balancers?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/cloud-load-balancers?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/cloud-load-balancers", "per_page": 25, "prev_page_url": null, "to": 3, "total": 3, "meta": { "counts": { "total": 3, "running": 3 }, "integrations": [ { "id": 9, "provider": "digitalocean", "label": "DigitalOcean — Staging" }, { "id": 1, "provider": "hetzner", "label": "Hetzner — Production" } ], "tags": [] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-load-balancers/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_lb_id": "lb-1", "name": "web-lb", "status": "running", "load_balancer_type": "lb11", "ipv4": "203.0.113.50", "ipv6": "2001:db8::50", "datacenter": "fsn1-dc14", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "algorithm": "round_robin", "services": [ { "protocol": "https", "listen_port": 443, "destination_port": 443 } ], "targets": [ { "type": "server", "server_id": 1 }, { "type": "server", "server_id": 2 } ], "price_monthly": "5.39", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "sync_halt": null, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-networks" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": 1, "organization_id": 1, "provider_credential_id": 1, "provider": "hetzner", "provider_network_id": "net-1", "name": "private-backbone", "ip_range": "10.0.0.0/16", "network_zone": "eu-central", "subnets_count": 2, "routes_count": 0, "servers_count": 6, "protection": { "delete": false }, "labels": [], "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subnets": [ { "type": "cloud", "gateway": "10.0.0.1", "ip_range": "10.0.1.0/24", "network_zone": "eu-central" }, { "type": "cloud", "gateway": "10.0.0.1", "ip_range": "10.0.2.0/24", "network_zone": "eu-central" } ], "routes": [], "servers": [ "100", "101" ], "delete_protection": false, "sync_halt": null, "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] }, { "id": 3, "organization_id": 1, "provider_credential_id": 9, "provider": "digitalocean", "provider_network_id": "net-3", "name": "staging-vpc", "ip_range": "10.10.0.0/20", "network_zone": "ams3", "subnets_count": 1, "routes_count": 0, "servers_count": 2, "protection": { "delete": false }, "labels": [], "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subnets": [ { "type": "cloud", "ip_range": "10.10.0.0/20", "network_zone": "ams3" } ], "routes": [], "servers": [ "109", "110" ], "delete_protection": false, "sync_halt": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-networks/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider_credential_id": 1, "provider": "hetzner", "provider_network_id": "net-1", "name": "private-backbone", "ip_range": "10.0.0.0/16", "network_zone": "eu-central", "subnets_count": 2, "routes_count": 0, "servers_count": 6, "protection": { "delete": false }, "labels": [], "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subnets": [ { "type": "cloud", "gateway": "10.0.0.1", "ip_range": "10.0.1.0/24", "network_zone": "eu-central" }, { "type": "cloud", "gateway": "10.0.0.1", "ip_range": "10.0.2.0/24", "network_zone": "eu-central" } ], "routes": [], "servers": [ "100", "101" ], "delete_protection": false, "sync_halt": null, "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [], "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-primary-ips" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": "ip_1", "name": "web-01-ipv4", "ip": "198.51.100.10", "type": "ipv4", "server_id": 1, "server_name": "web-01", "last_server_name": "web-01", "unattached": false, "dns_ptr": [ { "ip": "198.51.100.10", "dns_ptr": "web-01.northwind.cloud" } ], "datacenter": "nbg1-dc3", "location_city": "Nuremberg", "location_country": "de", "protection": { "delete": false }, "auto_delete": false, "blocked": false, "price_monthly": 0.6, "price_currency": "eur", "price_source": "api", "cloud_ip_id": 1, "credential_id": 1, "credential_label": "Hetzner — Production", "provider": "hetzner", "source": "provider", "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true } }, { "id": "ip_2", "name": "web-02-ipv4", "ip": "198.51.100.11", "type": "ipv4", "server_id": 2, "server_name": "web-02", "last_server_name": "web-02", "unattached": false, "dns_ptr": [ { "ip": "198.51.100.11", "dns_ptr": "web-02.northwind.cloud" } ], "datacenter": "nbg1-dc3", "location_city": "Nuremberg", "location_country": "de", "protection": { "delete": false }, "auto_delete": false, "blocked": false, "price_monthly": 0.6, "price_currency": "eur", "price_source": "api", "cloud_ip_id": 2, "credential_id": 1, "credential_label": "Hetzner — Production", "provider": "hetzner", "source": "provider", "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true } } ], "server_derived_credentials": [ { "id": 5, "label": "TransIP — Amsterdam", "provider": "transip" }, { "id": 8, "label": "OVHcloud — Beauharnois", "provider": "ovh" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 13, "organization_id": 1, "provider": "digitalocean", "provider_server_id": "112", "name": "analytics-01", "status": "stopped", "server_type": "c-4", "image": "ubuntu-24-04-x64", "ipv4": "192.0.2.80", "ipv6": null, "datacenter": "nyc3", "provisioned_at": "2025-07-25T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 50, "price_monthly": "84.00", "price_hourly": "0.1151", "location_city": "New York", "location_country": "US", "included_traffic": 6597069766656, "outgoing_traffic": 131941395333, "incoming_traffic": 65970697667, "ipv4_dns_ptr": "analytics-01.northwind.cloud", "firewall_enabled": false }, "provider_credential_id": 9, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": false, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "provider", "agent_health": null, "monitoring_enabled": false, "monitoring_enabled_at": null, "volumes_count": 0, "agent_last_seen_at": null, "agent_tokens_count": 0, "custom_fields": { "1": "Data" }, "capabilities": { "native_delete_protection": false, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": false, "snapshots": true, "backups": true, "isos": false, "rescue": false, "placement_groups": false, "public_network_toggle": false, "scheduled_backups": true, "private_networks": true, "private_network_attach": false, "network_join_on_create": true, "network_attach_ip_choice": false, "private_network_unfiltered": false, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": false, "network_routes": false, "network_rename": true, "network_ip_range_extendable": false, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": false, "volume_native_delete_protection": false, "network_native_delete_protection": false, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": false, "rdns_address_list": false, "reverse_dns": false, "snapshot_description": false, "snapshot_protection": false }, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 50, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 50 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "stopped", "sync_halt": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [ { "id": 2, "name": "Staging", "color": "#f59e0b", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 13, "tag_id": 2 } } ] }, { "id": 12, "organization_id": 1, "provider": "digitalocean", "provider_server_id": "111", "name": "queue-01", "status": "running", "server_type": "s-4vcpu-8gb", "image": "ubuntu-24-04-x64", "ipv4": "192.0.2.40", "ipv6": "2001:db8:3:d0::a22:1/64", "datacenter": "fra1", "provisioned_at": "2025-08-06T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "48.00", "price_hourly": "0.0658", "location_city": "Frankfurt", "location_country": "DE", "included_traffic": 5497558138880, "outgoing_traffic": 1044536046387, "incoming_traffic": 384829069722, "ipv4_dns_ptr": "queue-01.northwind.cloud", "firewall_enabled": false }, "provider_credential_id": 9, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": false, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "agent_health": null, "monitoring_enabled": true, "monitoring_enabled_at": null, "volumes_count": 0, "agent_last_seen_at": null, "agent_tokens_count": 0, "custom_fields": { "1": "Platform" }, "capabilities": { "native_delete_protection": false, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": false, "snapshots": true, "backups": true, "isos": false, "rescue": false, "placement_groups": false, "public_network_toggle": false, "scheduled_backups": true, "private_networks": true, "private_network_attach": false, "network_join_on_create": true, "network_attach_ip_choice": false, "private_network_unfiltered": false, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": false, "network_routes": false, "network_rename": true, "network_ip_range_extendable": false, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": false, "volume_native_delete_protection": false, "network_native_delete_protection": false, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": false, "rdns_address_list": false, "reverse_dns": false, "snapshot_description": false, "snapshot_protection": false }, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [ { "id": 1, "name": "Production", "color": "#ef4444", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 12, "tag_id": 1 } } ] } ], "first_page_url": "http://localhost/api/organizations/1/cloud-servers?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/cloud-servers?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/cloud-servers?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/cloud-servers", "per_page": 25, "prev_page_url": null, "to": 14, "total": 14, "meta": { "locked_ids": [], "counts": { "total": 14, "running": 12, "untracked": 0, "self_managed": 0 }, "integrations": [ { "id": 9, "provider": "digitalocean", "label": "DigitalOcean — Staging", "capabilities": { "native_delete_protection": false, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": false, "snapshots": true, "backups": true, "isos": false, "rescue": false, "placement_groups": false, "public_network_toggle": false, "scheduled_backups": true, "private_networks": true, "private_network_attach": false, "network_join_on_create": true, "network_attach_ip_choice": false, "private_network_unfiltered": false, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": false, "network_routes": false, "network_rename": true, "network_ip_range_extendable": false, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": false, "volume_native_delete_protection": false, "network_native_delete_protection": false, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": false, "rdns_address_list": false, "reverse_dns": false, "snapshot_description": false, "snapshot_protection": false } }, { "id": 1, "provider": "hetzner", "label": "Hetzner — Production", "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true } } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6" }, { "id": 6, "name": "Northwind Platform", "color": "#14b8a6" } ], "custom_fields": [ { "id": 1, "key": "cost_centre", "label": "Cost centre", "type": "select", "options": [ "Platform", "Marketing" ] } ] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_server_id": "100", "name": "web-01", "status": "running", "server_type": "cpx31", "image": "ubuntu-24.04", "ipv4": "198.51.100.10", "ipv6": "2001:db8:1c1e:5a10::/64", "datacenter": "nbg1-dc3", "provisioned_at": "2025-12-16T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "15.90", "price_hourly": "0.0218", "location_city": "Nuremberg", "location_country": "DE", "included_traffic": 21990232555520, "outgoing_traffic": 6816972092211, "incoming_traffic": 1979120929997, "ipv4_dns_ptr": "web-01.northwind.cloud", "firewall_enabled": false, "backup_window": "22-02" }, "provider_credential_id": 1, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": true, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "agent_health": null, "monitoring_enabled": true, "monitoring_enabled_at": null, "volumes_count": 1, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "volumes": [ { "id": 3, "organization_id": 1, "cloud_server_id": 1, "provider": "hetzner", "provider_volume_id": "vol-3", "name": "uploads", "size_gb": 250, "status": "attached", "datacenter": "nbg1-dc3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "price_monthly": "12.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 5 } } ], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "cost": { "base": 15.9, "currency": "EUR", "source": "api", "extras": [ { "key": "backups", "amount": 3.18, "source": "computed", "own": true }, { "key": "volume", "label": "uploads", "amount": 12, "source": "api", "own": false } ], "total": 31.75 }, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "capability_blockers": [], "rename_refusal": null, "agent_silent_after_seconds": 300, "agent_refusal": null, "uptime_seconds": 3542400 } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/cloud-servers/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"office-nas-01"}' ``` **Response** · 200 ```json { "id": 15, "organization_id": 1, "provider": "self_managed", "provider_server_id": null, "name": "office-nas-01", "status": "running", "server_type": null, "image": null, "ipv4": "192.0.2.40", "ipv6": null, "datacenter": null, "provisioned_at": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": null, "provider_credential_id": null, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": false, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "provider", "agent_health": null, "monitoring_enabled": false, "monitoring_enabled_at": null, "volumes_count": 0, "hardware": { "vcpus": null, "ram_gb": null, "disk_gb": null, "plan": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "volumes": [], "tags": [], "provider_credential": null, "cost": { "base": null, "currency": "EUR", "source": "api", "extras": [], "total": null }, "capabilities": [], "capability_blockers": [], "rename_refusal": null, "agent_silent_after_seconds": 300, "agent_refusal": null, "uptime_seconds": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/addons" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/address-references" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "addresses": [ "198.51.100.10", "2001:db8:1c1e:5a10::/64" ], "dns_records": [ { "zone_id": 1, "zone_name": "northwind.com", "record_id": 1, "name": "northwind.com", "fqdn": "northwind.com", "type": "A", "value": "198.51.100.10", "writable": false, "aliases": [ { "zone_id": 1, "record_id": 3, "fqdn": "api.northwind.com" } ] }, { "zone_id": 1, "zone_name": "northwind.com", "record_id": 2, "name": "www", "fqdn": "www.northwind.com", "type": "A", "value": "198.51.100.10", "writable": false, "aliases": [] } ], "firewall_rules": [], "monitors": [], "total": 21, "move_targets": [ { "id": 13, "name": "analytics-01", "ipv4": "192.0.2.80", "ipv6": null, "ipv6_basis": null }, { "id": 3, "name": "api-01", "ipv4": "198.51.100.20", "ipv6": "2001:db8:1c1e:5a20::1", "ipv6_basis": "default" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/agent-release" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "version": null, "published_at": null, "install_sh_sha256": null, "install_ps1_sha256": null, "repo": "InfraNest-Infrastructure-Organized/infranest-agent", "install_sh_url": "https://get.infranest.io/agent.sh", "install_ps1_url": "https://get.infranest.io/agent.ps1", "checksums_url": "https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases/latest/download/SHA256SUMS", "releases_url": "https://github.com/InfraNest-Infrastructure-Organized/infranest-agent/releases", "ingest_url": "http://localhost" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/agent-snapshot" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "container_names": [], "mounts": [ { "mount_point": "/", "device": "/dev/sda1", "used_bytes": 58411555225, "total_bytes": 171798691840, "used_percent": 34, "inodes_percent": null, "collected_at": "2026-01-15T12:00:00.000000Z", "usage": null, "scan": null, "forecast": { "days_left": 61, "percent_per_day": 1.08, "fit": 0.99, "from_percent": 34 } } ], "processes": [], "services": [], "services_summary": { "watched": 0, "active": 0, "failed": 0, "ignored": 0 }, "ignored_units": [], "containers": null, "collected_at": "2026-01-15T12:00:00.000000Z", "metrics_source": "agent", "uptime_seconds": 3542400, "agent_health": null, "agent_status": "unknown", "agent_latest_version": null, "has_token": false, "alerts_quiet_until": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/agent-tokens" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/cloud-servers/1/alert-rule-overrides" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"key":"cpu_percent","threshold":85}' ``` **Response** · 201 — Created ```json { "id": 2, "organization_id": 1, "server_id": 1, "metric": "cpu_percent", "operator": ">", "threshold": 85, "duration_minutes": 15, "is_active": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "alert_rule_default_id": 1, "kind": "metric" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/alert-rules" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "key": "cpu_percent", "group": "struggling", "kind": "metric", "metric": "cpu_percent", "agent_only": false, "duration_unit": "minutes", "duration_bounds": { "min": 1, "max": 1440 }, "recommended": { "operator": ">", "threshold": 90, "duration_minutes": 10 }, "origin": "inherited", "configured": true, "default_active": true, "is_active": true, "operator": ">", "threshold": 85, "duration_minutes": 15, "default_id": 1, "override_id": null, "inherited_threshold": null, "inherited_duration_minutes": null, "is_breaching": false, "advisory": false, "in_breach_since": null, "subject": null }, { "key": "memory_percent", "group": "struggling", "kind": "metric", "metric": "memory_percent", "agent_only": true, "duration_unit": "minutes", "duration_bounds": { "min": 1, "max": 1440 }, "recommended": { "operator": ">", "threshold": 90, "duration_minutes": 10 }, "origin": "unconfigured", "configured": false, "default_active": false, "is_active": false, "operator": ">", "threshold": 90, "duration_minutes": 10, "default_id": null, "override_id": null, "inherited_threshold": null, "inherited_duration_minutes": null, "is_breaching": false, "advisory": false, "in_breach_since": null, "subject": null } ], "legacy": [], "min_duration_minutes": 1 } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/cloud-servers/1/alert-rules/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"threshold":85}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "server_id": 1, "metric": "cpu_percent", "operator": ">", "threshold": 85, "duration_minutes": 10, "is_active": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "alert_rule_default_id": null, "kind": "metric" } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/cloud-servers/1/alert-rules/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Deleted." } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/attention" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "uptime_seconds": 3542400, "alerts_quiet_until": null, "silence": null, "trend": { "metric": "disk_used_percent", "mount_point": "/", "current": 34, "per_day": 1.08, "days_left": 61, "threshold": null, "also_moving": 0, "window_days": 7 }, "others_ok": true, "certificates": [] } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/cloud-servers/1/backup-pricing" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"backup_price_monthly":1.58}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_server_id": "100", "name": "web-01", "status": "running", "server_type": "cpx31", "image": "ubuntu-24.04", "ipv4": "198.51.100.10", "ipv6": "2001:db8:1c1e:5a10::/64", "datacenter": "nbg1-dc3", "provisioned_at": "2025-12-16T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "15.90", "price_hourly": "0.0218", "location_city": "Nuremberg", "location_country": "DE", "included_traffic": 21990232555520, "outgoing_traffic": 6816972092211, "incoming_traffic": 1979120929997, "ipv4_dns_ptr": "web-01.northwind.cloud", "firewall_enabled": false, "backup_window": "22-02" }, "provider_credential_id": 1, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": "1.58", "delete_protection": true, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "agent_health": null, "monitoring_enabled": true, "monitoring_enabled_at": null, "volumes_count": 1, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "volumes": [ { "id": 3, "organization_id": 1, "cloud_server_id": 1, "provider": "hetzner", "provider_volume_id": "vol-3", "name": "uploads", "size_gb": 250, "status": "attached", "datacenter": "nbg1-dc3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "price_monthly": "12.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 5 } } ], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "cost": { "base": 15.9, "currency": "EUR", "source": "api", "extras": [ { "key": "backups", "amount": 1.58, "source": "manual", "own": true }, { "key": "volume", "label": "uploads", "amount": 12, "source": "api", "own": false } ], "total": 30.15 }, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "capability_blockers": [], "rename_refusal": null, "agent_silent_after_seconds": 300, "agent_refusal": null, "uptime_seconds": 3542400 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/backups" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "images": [ { "id": 90000101, "type": "backup", "status": "available", "description": "web-01 backup", "created": "2026-01-14T22:06:00+00:00", "disk_size": 160, "image_size": 17.84, "protection": { "delete": false }, "bound_to": 100 }, { "id": 90000102, "type": "backup", "status": "available", "description": "web-01 backup", "created": "2026-01-13T22:06:00+00:00", "disk_size": 160, "image_size": 17.8, "protection": { "delete": false }, "bound_to": 100 } ] } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/cloud-servers/1/container-names" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"container_id":"3f2a9c1b7d4e","display_name":"web"}' ``` **Response** · 200 ```json { "container_names": [ { "container_id": "3f2a9c1b7d4e", "display_name": "web" } ] } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/cloud-servers/1/container-names" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "container_names": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/firewall" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cloud-servers/1/ignored-units" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"unit":"snapd.service"}' ``` **Response** · 201 — Created ```json { "ignored_units": [ { "unit": "snapd.service", "ignored_at": "2026-01-15T12:00:00+00:00", "ignored_by": "Alex Rivera" } ] } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/cloud-servers/1/ignored-units" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "ignored_units": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/images" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/isos" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/metric-series" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "range": "h24", "window": { "from": "2026-01-14T12:00:00Z", "to": "2026-01-15T12:00:00Z" }, "source": "agent", "resolution": "raw", "series": { "cpu_percent": [ [ 1768392000, 24.25 ], [ 1768392300, 23.23 ] ], "memory_percent": [ [ 1768392000, 62.8 ], [ 1768392300, 62.43 ] ], "worst_mount_percent": [ [ 1768392000, 33 ], [ 1768392300, 33 ] ], "load_1": [ [ 1768392000, 0.97 ], [ 1768392300, 0.93 ] ] }, "pagination": { "page": 1, "per_page": 10000, "total": 289, "last_page": 1 }, "thresholds": { "cpu_percent": { "operator": ">", "threshold": 85, "duration_minutes": 15 }, "memory_percent": null, "worst_mount_percent": null, "load_1": null }, "facts": { "vcpus": 4, "worst_mount": { "mount_point": "/", "used_bytes": 58411555225, "total_bytes": 171798691840, "days_left": 61 } } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/metrics" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "metrics": { "start": "2026-01-15T11:00:00+00:00", "end": "2026-01-15T12:00:00+00:00", "step": 60, "time_series": { "cpu": { "values": [ [ 1768474800, "22.12" ], [ 1768475100, "23.11" ] ] }, "network.0.bandwidth.in": { "values": [ [ 1768474800, "16381032" ], [ 1768475100, "18508096" ] ] }, "network.0.bandwidth.out": { "values": [ [ 1768474800, "38222409" ], [ 1768475100, "43185557" ] ] }, "disk.0.bandwidth.read": { "values": [ [ 1768474800, "5460344" ], [ 1768475100, "6169365" ] ] }, "disk.0.bandwidth.write": { "values": [ [ 1768474800, "8190516" ], [ 1768475100, "9254048" ] ] } } } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cloud-servers/1/monitoring" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "monitoring_enabled": true, "monitoring_enabled_at": null, "usage": 11, "limit": null } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/cloud-servers/1/monitoring" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "monitoring_enabled": false, "monitoring_enabled_at": null, "usage": 10, "limit": null } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/cloud-servers/1/pricing" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"price_monthly":7.9,"currency":"EUR"}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_server_id": "100", "name": "web-01", "status": "running", "server_type": "cpx31", "image": "ubuntu-24.04", "ipv4": "198.51.100.10", "ipv6": "2001:db8:1c1e:5a10::/64", "datacenter": "nbg1-dc3", "provisioned_at": "2025-12-16T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "15.90", "price_hourly": "0.0218", "location_city": "Nuremberg", "location_country": "DE", "included_traffic": 21990232555520, "outgoing_traffic": 6816972092211, "incoming_traffic": 1979120929997, "ipv4_dns_ptr": "web-01.northwind.cloud", "firewall_enabled": false, "backup_window": "22-02" }, "provider_credential_id": 1, "price_monthly": "7.90", "price_source": "manual", "price_currency": null, "backup_price_override": null, "delete_protection": true, "untracked_at": null, "price_amount": "7.9000", "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "agent_health": null, "monitoring_enabled": true, "monitoring_enabled_at": null, "volumes_count": 1, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "volumes": [ { "id": 3, "organization_id": 1, "cloud_server_id": 1, "provider": "hetzner", "provider_volume_id": "vol-3", "name": "uploads", "size_gb": 250, "status": "attached", "datacenter": "nbg1-dc3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "price_monthly": "12.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 5 } } ], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "cost": { "base": 7.9, "currency": "EUR", "source": "manual", "extras": [ { "key": "backups", "amount": 1.58, "source": "computed", "own": true }, { "key": "volume", "label": "uploads", "amount": 12, "source": "api", "own": false } ], "total": 22.15 }, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "capability_blockers": [], "rename_refusal": null, "agent_silent_after_seconds": 300, "agent_refusal": null, "uptime_seconds": 3542400 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/1/provider-actions" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cloud-servers/1/reset-pricing" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_server_id": "100", "name": "web-01", "status": "running", "server_type": "cpx31", "image": "ubuntu-24.04", "ipv4": "198.51.100.10", "ipv6": "2001:db8:1c1e:5a10::/64", "datacenter": "nbg1-dc3", "provisioned_at": "2025-12-16T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "15.90", "price_hourly": "0.0218", "location_city": "Nuremberg", "location_country": "DE", "included_traffic": 21990232555520, "outgoing_traffic": 6816972092211, "incoming_traffic": 1979120929997, "ipv4_dns_ptr": "web-01.northwind.cloud", "firewall_enabled": false, "backup_window": "22-02" }, "provider_credential_id": 1, "price_monthly": "15.90", "price_source": "api", "price_currency": "EUR", "backup_price_override": null, "delete_protection": true, "untracked_at": null, "price_amount": "15.9000", "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "agent_health": null, "monitoring_enabled": true, "monitoring_enabled_at": null, "volumes_count": 1, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "volumes": [ { "id": 3, "organization_id": 1, "cloud_server_id": 1, "provider": "hetzner", "provider_volume_id": "vol-3", "name": "uploads", "size_gb": 250, "status": "attached", "datacenter": "nbg1-dc3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "price_monthly": "12.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 5 } } ], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "cost": { "base": 15.9, "currency": "EUR", "source": "api", "extras": [ { "key": "backups", "amount": 3.18, "source": "computed", "own": true }, { "key": "volume", "label": "uploads", "amount": 12, "source": "api", "own": false } ], "total": 31.75 }, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "capability_blockers": [], "rename_refusal": null, "agent_silent_after_seconds": 300, "agent_refusal": null, "uptime_seconds": 3542400 } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cloud-servers/1/snooze" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"minutes":60}' ``` **Response** · 201 — Created ```json { "maintenance_window_id": 5, "until": "2026-01-15T13:00:00+00:00" } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/cloud-servers/1/snooze" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "ended": 0, "alerts_quiet_until": null } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cloud-servers/1/untrack" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Server is no longer tracked." } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cloud-servers/1/retrack" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider": "hetzner", "provider_server_id": "100", "name": "web-01", "status": "running", "server_type": "cpx31", "image": "ubuntu-24.04", "ipv4": "198.51.100.10", "ipv6": "2001:db8:1c1e:5a10::/64", "datacenter": "nbg1-dc3", "provisioned_at": "2025-12-16T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "15.90", "price_hourly": "0.0218", "location_city": "Nuremberg", "location_country": "DE", "included_traffic": 21990232555520, "outgoing_traffic": 6816972092211, "incoming_traffic": 1979120929997, "ipv4_dns_ptr": "web-01.northwind.cloud", "firewall_enabled": false, "backup_window": "22-02" }, "provider_credential_id": 1, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": true, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "agent_health": null, "monitoring_enabled": true, "monitoring_enabled_at": null, "volumes_count": 1, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "volumes": [ { "id": 3, "organization_id": 1, "cloud_server_id": 1, "provider": "hetzner", "provider_volume_id": "vol-3", "name": "uploads", "size_gb": 250, "status": "attached", "datacenter": "nbg1-dc3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "price_monthly": "12.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 3 } }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 1, "tag_id": 5 } } ], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "cost": { "base": 15.9, "currency": "EUR", "source": "api", "extras": [ { "key": "backups", "amount": 3.18, "source": "computed", "own": true }, { "key": "volume", "label": "uploads", "amount": 12, "source": "api", "own": false } ], "total": 31.75 }, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "capability_blockers": [], "rename_refusal": null, "agent_silent_after_seconds": 300, "agent_refusal": null, "uptime_seconds": 3542400 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-servers/metrics-overview" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 12, "organization_id": 1, "provider": "digitalocean", "provider_server_id": "111", "name": "queue-01", "status": "running", "server_type": "s-4vcpu-8gb", "image": "ubuntu-24-04-x64", "ipv4": "192.0.2.40", "ipv6": "2001:db8:3:d0::a22:1/64", "datacenter": "fra1", "provisioned_at": "2025-08-06T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "price_monthly": "48.00", "price_hourly": "0.0658", "location_city": "Frankfurt", "location_country": "DE", "included_traffic": 5497558138880, "outgoing_traffic": 1044536046387, "incoming_traffic": 384829069722, "ipv4_dns_ptr": "queue-01.northwind.cloud", "firewall_enabled": false }, "provider_credential_id": 9, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": false, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "agent", "monitoring_enabled": true, "monitoring_enabled_at": null, "breached_rules": 0, "cpu_percent": 64.03, "network_in_bps": 14121908, "network_out_bps": 10591431, "memory_percent": 67.71, "worst_mount_percent": 55, "load_1": 2.56, "load_5": 2.49, "load_15": 2.42, "collected_at": "2026-01-13 12:05:00", "agent_last_seen_at": null, "agent_tokens_count": 0, "silence": null, "active_rules": 1, "in_breach": false, "coverage": "agent", "provider_metrics": true, "worst_mount_point": "/", "disk_forecast": { "mount_point": "/", "days_left": 39, "percent_per_day": 1.08, "fit": 0.99, "from_percent": 57 }, "load_24h": [ 2.28, 2.11 ], "agent_version": null, "agent_status": "unknown", "agent_refusal": null, "hardware": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160, "plan": { "vcpus": 4, "ram_gb": 8, "disk_gb": 160 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "tags": [ { "id": 1, "name": "Production", "color": "#ef4444", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 12, "tag_id": 1 } } ] }, { "id": 10, "organization_id": 1, "provider": "digitalocean", "provider_server_id": "109", "name": "staging-web-01", "status": "running", "server_type": "s-2vcpu-4gb", "image": "ubuntu-24-04-x64", "ipv4": "192.0.2.10", "ipv6": "2001:db8:800:c1::a10:1/64", "datacenter": "ams3", "provisioned_at": "2025-08-30T12:00:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "meta": { "vcpus": 2, "ram_gb": 4, "disk_gb": 80, "price_monthly": "24.00", "price_hourly": "0.0329", "location_city": "Amsterdam", "location_country": "NL", "included_traffic": 4398046511104, "outgoing_traffic": 483785116221, "incoming_traffic": 219902325555, "ipv4_dns_ptr": "staging-web-01.northwind.cloud", "firewall_enabled": false }, "provider_credential_id": 9, "price_monthly": null, "price_source": "api", "price_currency": null, "backup_price_override": null, "delete_protection": false, "untracked_at": null, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "metrics_source": "provider", "monitoring_enabled": true, "monitoring_enabled_at": null, "breached_rules": 0, "cpu_percent": 8.67, "network_in_bps": 3530477, "network_out_bps": 7060954, "memory_percent": null, "worst_mount_percent": null, "load_1": null, "load_5": null, "load_15": null, "collected_at": "2026-01-13 12:05:00", "agent_last_seen_at": null, "agent_tokens_count": 0, "silence": null, "active_rules": 1, "in_breach": false, "coverage": "provider", "provider_metrics": true, "worst_mount_point": null, "disk_forecast": null, "load_24h": null, "agent_version": null, "agent_status": "unknown", "agent_refusal": null, "hardware": { "vcpus": 2, "ram_gb": 4, "disk_gb": 80, "plan": { "vcpus": 2, "ram_gb": 4, "disk_gb": 80 }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": "running", "sync_halt": null, "tags": [ { "id": 2, "name": "Staging", "color": "#f59e0b", "pivot": { "taggable_type": "App\\Models\\CloudServer", "taggable_id": 10, "tag_id": 2 } } ] } ], "first_page_url": "http://localhost/api/organizations/1/cloud-servers/metrics-overview?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/cloud-servers/metrics-overview?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/cloud-servers/metrics-overview?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/cloud-servers/metrics-overview", "per_page": 25, "prev_page_url": null, "to": 14, "total": 14, "meta": { "counts": { "total": 14, "breaching": 0, "noagent": 9, "notreporting": 4, "ok": 10, "norules": 0, "notmonitored": 3, "monitored": 11, "avgCpu": 29 }, "agent_silent_after_seconds": 300, "counted_at": "2026-01-15T12:00:00.000000Z", "integrations": [ { "id": 9, "provider": "digitalocean", "label": "DigitalOcean — Staging" }, { "id": 1, "provider": "hetzner", "label": "Hetzner — Production" } ], "tags": [ { "id": 3, "name": "Customer-facing", "color": "#3b82f6" }, { "id": 6, "name": "Northwind Platform", "color": "#14b8a6" } ] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-snapshots" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 3, "organization_id": 1, "provider_credential_id": null, "cloud_server_id": 1, "provider": "hetzner", "provider_snapshot_id": "snap-302", "name": "web-01 golden image", "description": "Base image the web tier is rebuilt from.", "status": "available", "disk_size_gb": 80, "image_size_gb": 6.2, "source_server_name": "web-01", "protection_delete": true, "created_at": "2025-12-12T12:00:00.000000Z", "updated_at": "2025-12-12T12:00:00.000000Z", "deleted_at": null, "price_monthly": "0.07", "price_amount": null, "price_currency": "EUR", "price_source": "api", "billing_interval": "monthly", "interval_count": 1, "capabilities": [], "provider_credential": null, "server": { "id": 1, "name": "web-01", "ipv4": "198.51.100.10", "status": "running", "hardware": { "vcpus": null, "ram_gb": null, "disk_gb": null, "plan": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": null, "sync_halt": null } }, { "id": 2, "organization_id": 1, "provider_credential_id": null, "cloud_server_id": 4, "provider": "hetzner", "provider_snapshot_id": "snap-301", "name": "db-01 nightly", "description": null, "status": "available", "disk_size_gb": 40, "image_size_gb": 11.1, "source_server_name": "db-01", "protection_delete": false, "created_at": "2026-01-14T12:00:00.000000Z", "updated_at": "2026-01-14T12:00:00.000000Z", "deleted_at": null, "price_monthly": "0.13", "price_amount": null, "price_currency": "EUR", "price_source": "api", "billing_interval": "monthly", "interval_count": 1, "capabilities": [], "provider_credential": null, "server": { "id": 4, "name": "db-01", "ipv4": "198.51.100.30", "status": "running", "hardware": { "vcpus": null, "ram_gb": null, "disk_gb": null, "plan": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": null, "sync_halt": null } } ], "first_page_url": "http://localhost/api/organizations/1/cloud-snapshots?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/cloud-snapshots?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/cloud-snapshots?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/cloud-snapshots", "per_page": 25, "prev_page_url": null, "to": 6, "total": 6, "meta": { "counts": { "total": 6, "available": 6, "creating": 0, "unavailable": 0 }, "integrations": [] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-snapshots/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "provider_credential_id": null, "cloud_server_id": 4, "provider": "hetzner", "provider_snapshot_id": "snap-300", "name": "db-01 before schema migration", "description": "Taken automatically before the 2026-08 migration.", "status": "available", "disk_size_gb": 40, "image_size_gb": 11.4, "source_server_name": "db-01", "protection_delete": true, "created_at": "2026-01-06T12:00:00.000000Z", "updated_at": "2026-01-06T12:00:00.000000Z", "deleted_at": null, "price_monthly": "0.14", "price_amount": null, "price_currency": "EUR", "price_source": "api", "billing_interval": "monthly", "interval_count": 1, "provider_credential": null, "server": { "id": 4, "name": "db-01", "ipv4": "198.51.100.30", "status": "running", "hardware": { "vcpus": null, "ram_gb": null, "disk_gb": null, "plan": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": null, "sync_halt": null } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-volumes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 6, "organization_id": 1, "cloud_server_id": null, "provider": "digitalocean", "provider_volume_id": "vol-6", "name": "analytics-scratch", "size_gb": 300, "status": "available", "datacenter": "nyc3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 9, "price_monthly": "30.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null, "server": null, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] }, { "id": 5, "organization_id": 1, "cloud_server_id": 11, "provider": "digitalocean", "provider_volume_id": "vol-5", "name": "staging-data", "size_gb": 100, "status": "attached", "datacenter": "ams3", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 9, "price_monthly": "10.00", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null, "server": { "id": 11, "name": "staging-api-01", "ipv4": "192.0.2.11", "status": "running", "hardware": { "vcpus": null, "ram_gb": null, "disk_gb": null, "plan": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": null, "sync_halt": null }, "provider_credential": { "id": 9, "organization_id": 1, "provider": "digitalocean", "label": "DigitalOcean — Staging", "enabled": true, "verified_at": "2025-10-15T12:00:00.000000Z", "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "refused_at": null }, "tags": [] } ], "first_page_url": "http://localhost/api/organizations/1/cloud-volumes?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/cloud-volumes?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/cloud-volumes?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/cloud-volumes", "per_page": 25, "prev_page_url": null, "to": 6, "total": 6, "meta": { "counts": { "total": 6, "attached": 4, "unattached": 2 }, "integrations": [ { "id": 9, "provider": "digitalocean", "label": "DigitalOcean — Staging" }, { "id": 1, "provider": "hetzner", "label": "Hetzner — Production" } ], "tags": [] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cloud-volumes/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "cloud_server_id": 4, "provider": "hetzner", "provider_volume_id": "vol-1", "name": "postgres-data", "size_gb": 100, "status": "attached", "datacenter": "hel1-dc2", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "provider_credential_id": 1, "price_monthly": "4.80", "price_source": "api", "price_currency": "eur", "delete_protection": false, "price_amount": null, "billing_interval": "monthly", "interval_count": 1, "native_delete_protection": false, "sync_halt": null, "server": { "id": 4, "name": "db-01", "ipv4": "198.51.100.30", "status": "running", "hardware": { "vcpus": null, "ram_gb": null, "disk_gb": null, "plan": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "machine": { "vcpus": null, "ram_gb": null, "disk_gb": null }, "mismatch": [], "disk_unallocated": false }, "live_status": null, "sync_halt": null }, "tags": [], "provider_credential": { "id": 1, "organization_id": 1, "provider": "hetzner", "label": "Hetzner — Production", "verified_at": "2025-10-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "enabled": true, "enabled_capabilities": null, "disabled_capabilities": null, "error_email_enabled": true, "disabled_operations": null, "alerts_muted_until": null, "spending_capacity": null, "spending_checked_at": null, "scope_check": null, "scope_checked_at": null, "removing_at": null, "last_synced_at": "2026-01-15T11:48:00.000000Z", "reconnect_required_at": null, "account_identity": null, "refused_at": null, "refusal_checked_at": null }, "capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "size_limits": { "min_gb": 10, "max_gb": 10240 } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/connect-requests" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [], "ttl_days": 3 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/endpoints/1/monitor" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "endpoint": { "id": 1, "host": "northwind.com", "port": 443, "proxied": true }, "monitor": { "monitor": { "id": 1, "name": "Marketing site", "type": "http", "enabled": true }, "status": "up", "last_checked_at": "2026-01-15T11:58:00+00:00", "uptime_30d": 100, "response_ms": 179, "chain_status": null, "locations": [ { "probe_id": null, "name": null, "region": null, "country_code": null, "status": "up", "response_ms": 180, "checked_at": "2026-01-15T12:00:00+00:00", "fingerprint": null, "certificate": null } ], "alerts": { "channels": [ { "id": 1, "name": "Ops team — email", "type": "email" }, { "id": 2, "name": "On-call — critical only", "type": "email" } ], "people": [ { "id": 2, "name": "Sam Okoye" }, { "id": 3, "name": "Priya Raghunathan" } ], "reaches_anyone": true }, "findings": [], "summary": { "status": "up", "uptime_30d": 100, "locations": 1, "locations_agree": true } } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/endpoints/1/retrack" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "endpoint_id": 1, "untracked_at": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/firewall-templates" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "builtin": [ { "id": null, "slug": "web-server", "name": "Web Server", "description": "For a public website or app. Opens HTTP (80), HTTPS (443) and HTTP/3 over QUIC (UDP 443) to everyone. Add SSH restricted to your own IP separately for management.", "is_builtin": true, "rules": [ { "description": "HTTP", "direction": "in", "protocol": "tcp", "port": "80", "ips": [ "0.0.0.0/0", "::/0" ] }, { "description": "HTTPS", "direction": "in", "protocol": "tcp", "port": "443", "ips": [ "0.0.0.0/0", "::/0" ] } ] }, { "id": null, "slug": "mail-server", "name": "Mail Server", "description": "For a self-hosted mail server. Opens SMTP (25), submission (587), SMTPS (465) for delivery and sending, plus IMAP/IMAPS (143/993) and POP3/POP3S (110/995) for clients. Open to everyone.", "is_builtin": true, "rules": [ { "description": "SMTP", "direction": "in", "protocol": "tcp", "port": "25", "ips": [ "0.0.0.0/0", "::/0" ] }, { "description": "Submission", "direction": "in", "protocol": "tcp", "port": "587", "ips": [ "0.0.0.0/0", "::/0" ] } ] } ], "custom": [ { "id": 1, "organization_id": 1, "name": "Web server (80/443)", "description": "Allow HTTP and HTTPS from anywhere, plus SSH from the office network.", "slug": null, "is_builtin": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "rules": [ { "id": 1, "firewall_template_id": 1, "description": "HTTP", "direction": "in", "protocol": "tcp", "port": "80", "ips": [ "0.0.0.0/0", "::/0" ], "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" }, { "id": 2, "firewall_template_id": 1, "description": "HTTPS", "direction": "in", "protocol": "tcp", "port": "443", "ips": [ "0.0.0.0/0", "::/0" ], "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } ] } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/firewall-templates/1/preview/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "rules": [ { "description": "HTTP", "direction": "in", "protocol": "tcp", "port": "80", "source_ips": [ "0.0.0.0/0", "::/0" ], "destination_ips": [] }, { "description": "HTTPS", "direction": "in", "protocol": "tcp", "port": "443", "source_ips": [ "0.0.0.0/0", "::/0" ], "destination_ips": [] } ], "current_count": 3 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/attention-summary" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "hour": null, "organisation_hour": 10, "next_at": "2026-01-16T10:00:00+00:00", "via": "email", "telegram": true, "receives": true, "available": true, "count": 13, "new": 13, "will_send": true, "items": [ { "title": "northwind-labs.com will not renew itself", "detail": "Expires Jan 24, 2026 and auto-renew is off.", "route": "/domains/14", "severity": "warning", "new": true }, { "title": "northwind.shop will not renew itself", "detail": "Expires Jan 26, 2026 and auto-renew is off.", "route": "/domains/10", "severity": "warning", "new": true } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-events" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [], "links": [], "receives_deploys": true, "manage_path": "/integrations/github" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-events/1/changes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "first": true } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-events/sources" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "repository": "northwind-cloud/app", "environment": "production" }, { "repository": "northwind-cloud/storefront", "environment": "production" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-links" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": 1, "repository": "northwind-cloud/app", "kind": "deployment", "environment": "production", "workflow": null, "branch": null, "target_type": "monitor", "target_id": 2, "target_name": "App — northwind-app.dev", "last_deploy_at": "2026-01-15T11:18:00+00:00", "has_deployments": true, "checking": true }, { "id": 2, "repository": "northwind-cloud/storefront", "kind": "deployment", "environment": "production", "workflow": null, "branch": null, "target_type": "monitor", "target_id": 4, "target_name": "Checkout flow", "last_deploy_at": "2026-01-15T11:17:00+00:00", "has_deployments": true, "checking": true } ], "deploys_connected": true, "source": { "key": "github", "label": "GitHub" } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/deploy-links" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"repository":"northwind-cloud/app","target_type":"server","target_id":1}' ``` **Response** · 201 — Created ```json { "id": 3, "repository": "northwind-cloud/app", "kind": "deployment", "environment": null, "workflow": null, "branch": null, "target_type": "server", "target_id": 1, "target_name": "web-01", "last_deploy_at": "2026-01-15T11:18:00+00:00", "has_deployments": true, "checking": true } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/deploy-links/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "ok": true } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-links/check" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "has_deployments": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-links/targets" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "monitors": [ { "id": 3, "name": "API health" }, { "id": 2, "name": "App — northwind-app.dev" } ], "servers": [ { "id": 13, "name": "analytics-01" }, { "id": 3, "name": "api-01" } ], "tags": [ { "id": 3, "name": "Customer-facing" }, { "id": 4, "name": "Internal" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/deploy-tokens" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "name": "CI — deploy hook", "created_by": 1, "last_used_at": "2026-01-11T12:00:00.000000Z", "monitor_ids": [], "require_signature": true, "created_at": "2026-01-15T12:00:00.000000Z", "creator": { "id": 1, "name": "Alex Rivera", "analytics_id": null } }, { "id": 2, "name": "Staging redeploy", "created_by": 1, "last_used_at": "2025-12-27T12:00:00.000000Z", "monitor_ids": [], "require_signature": false, "created_at": "2026-01-15T12:00:00.000000Z", "creator": { "id": 1, "name": "Alex Rivera", "analytics_id": null } } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/email-dns-monitors" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/email-dns-monitors" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/external-services" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 16, "name": "Anthropic", "status_url": "https://status.anthropic.com", "schema": null, "overall_status": "unknown", "components": null, "is_curated": true, "last_polled_at": null }, { "id": 19, "name": "Atlassian", "status_url": "https://status.atlassian.com", "schema": null, "overall_status": "unknown", "components": null, "is_curated": true, "last_polled_at": null } ] ```

**Request** ```sh curl "https://api.infranest.io/api/monitoring/active-regions" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 3, "organization_id": 1, "name": "API health", "type": "http", "target": "https://api.northwind.com/health", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "alert_channels_count": 0, "uptime_24h": "0.0", "uptime_chart_24h": [ "up", "up" ], "in_maintenance": false, "effective_interval_seconds": 300, "interval_minutes": 5, "tags": [ { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\MonitoringCheck", "taggable_id": 3, "tag_id": 5 } }, { "id": 1, "name": "Production", "color": "#ef4444", "pivot": { "taggable_type": "App\\Models\\MonitoringCheck", "taggable_id": 3, "tag_id": 1 } } ] }, { "id": 2, "organization_id": 1, "name": "App — northwind-app.dev", "type": "http", "target": "https://northwind-app.dev", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "alert_channels_count": 0, "uptime_24h": "0.0", "uptime_chart_24h": [ "up", "up" ], "in_maintenance": false, "effective_interval_seconds": 300, "interval_minutes": 5, "tags": [ { "id": 6, "name": "Northwind Platform", "color": "#14b8a6", "pivot": { "taggable_type": "App\\Models\\MonitoringCheck", "taggable_id": 2, "tag_id": 6 } }, { "id": 1, "name": "Production", "color": "#ef4444", "pivot": { "taggable_type": "App\\Models\\MonitoringCheck", "taggable_id": 2, "tag_id": 1 } } ] } ], "first_page_url": "http://localhost/api/organizations/1/monitoring-checks?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/monitoring-checks?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/monitoring-checks?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/monitoring-checks", "per_page": 25, "prev_page_url": null, "to": 13, "total": 13, "meta": { "locked_ids": [], "counts": { "total": 13, "up": 10, "down": 1, "degraded": 1, "paused": 1, "silenced": 0, "pending": 0 }, "tags": [ { "id": 6, "name": "Northwind Platform", "color": "#14b8a6" }, { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9" } ] } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"Checkout API","type":"http","target":"https://example.com/health","interval":300}' ``` **Response** · 201 — Created ```json { "last_status": "unknown", "enabled": true, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "name": "Checkout API", "type": "http", "target": "https://example.com/health", "organization_id": 1, "server_id": null, "server_link": null, "settings": [], "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 15, "alert_channels_count": 0, "interval_minutes": 0, "tags": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Marketing site", "type": "http", "target": "https://northwind.com", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "results_count": 576, "alert_channels_count": 0, "status_pages": [ { "id": 1, "name": "Northwind Cloud Status", "slug": "northwind", "is_public": true, "display_name": "Website" } ], "recent_statuses": [ "up", "up" ], "recent_results": [ { "status": "up", "checked_at": "2026-01-15T09:35:00Z", "region": null }, { "status": "up", "checked_at": "2026-01-15T09:40:00Z", "region": null } ], "pagerduty_oncall": [], "released_address": null, "effective_interval_seconds": 300, "interval_minutes": 5, "alert_channels": [], "tags": [ { "id": 5, "name": "Northwind Retail", "color": "#0ea5e9", "pivot": { "taggable_type": "App\\Models\\MonitoringCheck", "taggable_id": 1, "tag_id": 5 } }, { "id": 1, "name": "Production", "color": "#ef4444", "pivot": { "taggable_type": "App\\Models\\MonitoringCheck", "taggable_id": 1, "tag_id": 1 } } ], "parent_checks": [], "child_checks": [], "maintenance_windows": [ { "id": 2, "organization_id": 1, "name": "Load balancer certificate rotation", "description": "Replaced the certificate on web-lb and reloaded the listeners.", "starts_at": "2026-01-06T01:00:00.000000Z", "ends_at": "2026-01-06T01:30:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "suppress_alerts": true, "status": "completed", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks": [], "tags": [] }, { "id": 1, "organization_id": 1, "name": "Database cluster upgrade", "description": "Rolling upgrade of the PostgreSQL primary and its replica. Brief API slowdowns are possible; no downtime is expected.", "starts_at": "2026-01-18T02:00:00.000000Z", "ends_at": "2026-01-18T03:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "suppress_alerts": true, "status": "scheduled", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks": [], "tags": [] } ], "latest_ssl_certificate": { "id": 1, "organization_id": 1, "source": "probe", "monitoring_check_id": 1, "domain_id": 1, "cloud_server_id": null, "provider_credential_id": null, "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9", "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "serial": "2395BA42", "sans": [ "northwind.com", "www.northwind.com" ], "not_before": "2025-12-30T12:00:00.000000Z", "not_after": "2026-03-30T12:00:00.000000Z", "purpose": "tls_server", "key_algo": "rsa", "key_bits": 2048, "sig_algo": "SHA256-RSA", "trust": "public", "validation": "DV", "is_wildcard": false, "is_multi_san": true, "managed": true, "renewal_source": "Let's Encrypt (R3)", "classification_override": null, "status": "valid", "superseded_by_id": null, "dismissed_at": null, "deployment_locations": [ { "endpoint": "northwind.com:443", "last_seen": "2026-01-15T11:50:00+00:00", "first_seen": "2026-01-08T12:00:00+00:00" } ], "owner": null, "notes": null, "first_seen_at": "2025-11-16T12:00:00.000000Z", "last_seen_at": "2026-01-15T06:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subject_org": null, "subject_location": null, "chain": [ { "subject": "northwind.com", "issuer": "Let's Encrypt (R3)", "is_ca": false, "self_signed": false, "not_after": "2026-03-30T12:00:00+00:00", "fingerprint": "6f6f72db300125c26f8b2c866124ffb57e60a201177144ed5e5b6711eba24cb9" }, { "subject": "Let's Encrypt (R3)", "issuer": "ISRG Root X1", "is_ca": true, "self_signed": false, "not_after": "2030-01-15T12:00:00+00:00", "fingerprint": "e04ca19ed66485fb479283c98fbfb4cda1ab67de1965304902bec3f6a55a2c8e" } ], "chain_status": "trusted", "sources": [ { "source": "probe", "last_seen": "2026-01-15T06:00:00+00:00", "first_seen": "2025-11-16T12:00:00+00:00" } ], "crl_url": null, "ocsp_url": null, "caa_status": "ok", "caissuer_url": "http://r3.i.lencr.org/", "no_auto_merge": false, "price_yearly": "0.00", "price_source": "manual", "price_currency": "EUR", "billing_interval": "yearly", "interval_count": 1, "renewal_type": "automatic", "renewal_type_basis": "guess", "served_status": "served", "served_checked_at": "2026-01-15T11:50:00.000000Z", "subscription_ends_at": null, "seller": null, "role": null, "ct_finding": null, "owner_user_id": null } } ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/monitoring-checks/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"interval_seconds":300}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Marketing site", "type": "http", "target": "https://northwind.com", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "alert_channels_count": 1, "interval_minutes": 5 } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/monitoring-checks/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/affected" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "provider": null, "resources": [] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/affected" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"resource_type":"","resource_id":16}' ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/monitoring-checks/1/affected/1/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/aggregates" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "monitoring_check_id": 1, "period": "24h", "from": "2026-01-14T12:00:00Z", "to": "2026-01-15T12:00:00Z", "region": null, "uptime_percent": null, "up_percent": 100, "checks": { "total": 288, "up": 288, "degraded": 0, "down": 0 }, "response_time_ms": { "p50": 180, "p95": 288 }, "incidents": { "count": 0, "down_minutes": 0 } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/alerts" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"alert_channel_id":1}' ``` **Response** · 201 — Created ```json { "id": 1, "organization_id": 1, "name": "Ops team — email", "type": "email", "settings": { "email": "ops@northwind.example" }, "enabled": true, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subscriptions": [ "monitoring_down", "monitoring_recovered" ], "is_personal": false, "user_id": null, "format": "html", "last_sent_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "consecutive_failures": 0, "last_failure_at": null, "last_error": null, "last_error_type": null, "broken_since": null, "broken_notified_at": null, "broken_notify_count": 0, "awaiting_confirmation_at": null, "categories": null, "telegram_link_id": null, "telegram_chat_id": null, "slack_installation_id": null, "slack_channel_id": null } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/monitoring-checks/1/alerts/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/clone" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 201 — Created ```json { "organization_id": 1, "name": "Marketing site (copy)", "type": "http", "target": "https://northwind.com", "enabled": false, "settings": [], "deleted_at": null, "flap_threshold": 2, "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": 1, "server_link": "inferred", "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 16, "alert_channels_count": 0, "interval_minutes": 5 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/dependencies" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "parents": [], "children": [] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/dependencies" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"child_check_id":3}' ``` **Response** · 201 — Created ```json { "parent_check_id": 1, "child_check_id": 3, "organization_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 2 } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/monitoring-checks/1/dependencies/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Deleted." } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/incidents" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 2, "source": "monitor", "title": "Brief marketing-site blip", "status": "resolved", "impact": "minor", "started_at": "2026-01-09T11:45:00.000000Z", "resolved_at": "2026-01-09T12:00:00.000000Z", "duration_seconds": 900, "cause": null, "description": null, "external_status": null, "external_url": null, "is_planned": false, "acknowledged_at": null } ] ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/monitoring-checks/1/incidents/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"description":"Caused by an expired upstream certificate.","is_planned":false}' ``` **Response** · 200 ```json { "id": 2, "monitoring_check_id": 1, "started_at": "2026-01-09T11:45:00.000000Z", "resolved_at": "2026-01-09T12:00:00.000000Z", "duration_seconds": 900, "cause": null, "affected_probe_ids": null, "acknowledged_at": null, "acknowledged_by": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "description": "Caused by an expired upstream certificate.", "is_planned": false, "title": "Brief marketing-site blip", "status": "resolved", "impact": "minor", "source": "monitor", "server_id": null, "cloud_server_alert_rule_id": null, "external_status": null, "external_url": null, "alert_rule_state_id": null, "folded_into": null, "unstable_at": null, "unstable_ended_at": null, "outage_count": 1, "down_since": null, "downtime_seconds": 0, "outages": null, "acknowledged_by_name": null } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/pause" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Marketing site", "type": "http", "target": "https://northwind.com", "enabled": false, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "interval_minutes": 5 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/reach" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "state": "ok", "channels": [ { "id": 1, "name": "Ops team — email", "type": "email", "failing": false }, { "id": 2, "name": "On-call — critical only", "type": "email", "failing": false } ], "members": 4, "escalation": { "via": "pagerduty" } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/results" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 1, "monitoring_check_id": 1, "status": "up", "response_time_ms": 180, "status_code": 200, "message": "HTTP 200 — OK", "checked_at": "2026-01-15T12:00:00.000000Z", "meta": null, "probe_id": null, "is_failover": false, "failover_from_region": null, "ssl_fingerprint": null, "ssl_expires_at": null, "scheduled_for": null, "suppressed_by_probe": false, "reason_code": null, "reason_params": null }, { "id": 2, "monitoring_check_id": 1, "status": "up", "response_time_ms": 191, "status_code": 200, "message": "HTTP 200 — OK", "checked_at": "2026-01-15T11:55:00.000000Z", "meta": null, "probe_id": null, "is_failover": false, "failover_from_region": null, "ssl_fingerprint": null, "ssl_expires_at": null, "scheduled_for": null, "suppressed_by_probe": false, "reason_code": null, "reason_params": null } ], "first_page_url": "http://localhost/api/organizations/1/monitoring-checks/1/results?page=1", "from": 1, "last_page": 12, "last_page_url": "http://localhost/api/organizations/1/monitoring-checks/1/results?page=12", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/monitoring-checks/1/results?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": "http://localhost/api/organizations/1/monitoring-checks/1/results?page=2", "path": "http://localhost/api/organizations/1/monitoring-checks/1/results", "per_page": 50, "prev_page_url": null, "to": 50, "total": 576, "window": { "from": null, "to": null, "resolution": "raw" } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/resume" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Marketing site", "type": "http", "target": "https://northwind.com", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "interval_minutes": 5 } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/run" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 202 ```json { "message": "Check queued." } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/monitoring-checks/1/silence" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"duration_minutes":60}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Marketing site", "type": "http", "target": "https://northwind.com", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": "2026-01-15T13:00:00.000000Z", "silenced_by": 1, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "interval_minutes": 5 } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/monitoring-checks/1/silence" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Marketing site", "type": "http", "target": "https://northwind.com", "enabled": true, "settings": [], "last_status": "up", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 200 — OK", "consecutive_failures": 0, "flap_threshold": 2, "last_status_changed_at": "2026-01-14T12:00:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "interval_minutes": 5 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/monitoring-checks/1/stats" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "uptime": { "24h": null, "7d": null, "30d": null }, "chart_data": [ { "time": "2026-01-14T12:00:00+00:00", "avg": 176, "min": 164, "max": 186 }, { "time": "2026-01-14T13:00:00+00:00", "avg": 167, "min": 154, "max": 178 } ], "uptime_chart_data": [ { "time": "2026-01-14T12:00:00+00:00", "up": 12, "total": 12, "degraded": 0, "down_seconds": 0, "status": "up" }, { "time": "2026-01-14T13:00:00+00:00", "up": 12, "total": 12, "degraded": 0, "down_seconds": 0, "status": "up" } ], "period": "24h", "response_time": { "avg": 180, "min": 137, "max": 223 }, "incident_stats": { "24h": { "count": 0, "down_minutes": 0 }, "7d": { "count": 1, "down_minutes": 15 }, "30d": { "count": 1, "down_minutes": 15 } }, "regions": [], "region": null, "chart_by_region": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "generated_at": "2026-01-15T12:00:00Z", "tag": null, "summary": { "monitors": { "total": 13, "up": 10, "down": 1, "degraded": 1, "paused": 1, "unknown": 0 }, "servers": { "total": 14, "running": 12, "agent_not_reporting": 0, "breaching": 0 }, "open_incidents": 1, "active_maintenance": 0 }, "monitors": [ { "id": 3, "name": "API health", "type": "http", "status": "up", "enabled": true, "silenced": false, "last_checked_at": "2026-01-15T11:58:00Z", "uptime_24h": 0 }, { "id": 2, "name": "App — northwind-app.dev", "type": "http", "status": "up", "enabled": true, "silenced": false, "last_checked_at": "2026-01-15T11:58:00Z", "uptime_24h": 0 } ], "servers": [ { "id": 13, "name": "analytics-01", "status": "stopped", "monitoring_enabled": false, "agent_reporting": null, "breaching_alerts": 0 }, { "id": 3, "name": "api-01", "status": "running", "monitoring_enabled": true, "agent_reporting": true, "breaching_alerts": 0 } ], "incidents": [ { "id": 1, "title": "Checkout returning 503", "status": "investigating", "impact": "major", "started_at": "2026-01-15T11:20:00Z", "acknowledged_at": null, "monitoring_check_id": 4, "server_id": null } ], "maintenance": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/uptime-report" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "month": "2025-12", "closed": true, "days_in_month": 31, "checks": [ { "id": 3, "name": "API health", "type": "http", "target": "https://api.northwind.com/health", "uptime_pct": 99.951, "downtime_minutes": 22, "incidents": 1, "longest_outage_minutes": 22, "monitored_minutes": 44640, "days_with_data": 31, "planned_minutes_excluded": 0, "probes": [], "started_monitoring": "2026-01-15" }, { "id": 2, "name": "App — northwind-app.dev", "type": "http", "target": "https://northwind-app.dev", "uptime_pct": 100, "downtime_minutes": 0, "incidents": 0, "longest_outage_minutes": 0, "monitored_minutes": 44640, "days_with_data": 31, "planned_minutes_excluded": 0, "probes": [], "started_monitoring": "2026-01-15" } ], "summary": { "checks": 13, "checks_measured": 12, "worst_uptime_pct": 99.951, "mean_uptime_pct": 99.996, "incidents": 1, "downtime_minutes": 22 }, "findings": [ { "key": "uptimeReport.findings.worst", "params": { "check": "API health", "percent": 99.951, "minutes": 22, "n": 1 }, "tone": "warning" }, { "key": "uptimeReport.findings.unmeasured", "params": { "n": 1, "total": 13 }, "tone": "warning" } ], "generated_at": "2026-01-15T12:00:00+00:00", "months": [ { "month": "2025-02", "closed": true, "checks": 13, "checks_measured": 0, "worst_uptime_pct": null, "mean_uptime_pct": null, "incidents": 0, "downtime_minutes": 0 }, { "month": "2025-03", "closed": true, "checks": 13, "checks_measured": 0, "worst_uptime_pct": null, "mean_uptime_pct": null, "incidents": 0, "downtime_minutes": 0 } ], "applied_filters": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/uptime-report/export" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 — The month's uptime report as CSV. (`text/csv`)

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/incidents" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 2, "monitoring_check_id": 1, "source": "monitor", "title": "Brief marketing-site blip", "status": "resolved", "impact": "minor", "started_at": "2026-01-09T11:45:00.000000Z", "resolved_at": "2026-01-09T12:00:00.000000Z", "duration_seconds": 900, "cause": null, "description": null, "external_status": null, "external_url": null, "is_planned": false, "acknowledged_at": null, "acknowledged_by": null, "check": { "id": 1, "name": "Marketing site", "type": "http", "last_status": "up", "interval_minutes": 0 }, "updates": [ { "id": 5, "monitoring_incident_id": 2, "status": "resolved", "message": "A CDN configuration change was rolled back and the site recovered. No other services were affected.", "user_id": null, "created_at": "2026-01-09T12:00:00.000000Z", "user": null } ] }, { "id": 1, "monitoring_check_id": 4, "source": "monitor", "title": "Checkout returning 503", "status": "investigating", "impact": "major", "started_at": "2026-01-15T11:20:00.000000Z", "resolved_at": null, "duration_seconds": null, "cause": "Upstream payment gateway timeout", "description": null, "external_status": null, "external_url": null, "is_planned": false, "acknowledged_at": null, "acknowledged_by": null, "check": { "id": 4, "name": "Checkout flow", "type": "http", "last_status": "down", "interval_minutes": 0 }, "updates": [ { "id": 3, "monitoring_incident_id": 1, "status": "monitoring", "message": "The failover is live and checkout is succeeding again. Watching error rates before we call this resolved.", "user_id": null, "created_at": "2026-01-15T11:54:00.000000Z", "user": null } ] } ], "first_page_url": "http://localhost/api/organizations/1/incidents?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/incidents?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/incidents?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/incidents", "per_page": 25, "prev_page_url": null, "to": 2, "total": 2, "meta": { "counts": { "total": 2, "open": 1, "acked": 0, "resolved": 1 } } } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/incidents/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"status":"identified","impact":"major"}' ``` **Response** · 200 ```json { "id": 1, "monitoring_check_id": 4, "started_at": "2026-01-15T11:20:00.000000Z", "resolved_at": null, "duration_seconds": null, "cause": "Upstream payment gateway timeout", "affected_probe_ids": null, "acknowledged_at": null, "acknowledged_by": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "description": null, "is_planned": false, "title": "Checkout returning 503", "status": "identified", "impact": "major", "source": "monitor", "server_id": null, "cloud_server_alert_rule_id": null, "external_status": null, "external_url": null, "alert_rule_state_id": null, "folded_into": null, "unstable_at": null, "unstable_ended_at": null, "outage_count": 1, "down_since": null, "downtime_seconds": 0, "outages": null, "acknowledged_by_name": null } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/incidents/1/acknowledge" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "monitoring_check_id": 4, "started_at": "2026-01-15T11:20:00.000000Z", "resolved_at": null, "duration_seconds": null, "cause": "Upstream payment gateway timeout", "affected_probe_ids": null, "acknowledged_at": "2026-01-15T12:00:00.000000Z", "acknowledged_by": { "id": 1, "first_name": null, "last_name": null, "analytics_id": null }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "description": null, "is_planned": false, "title": "Checkout returning 503", "status": "investigating", "impact": "major", "source": "monitor", "server_id": null, "cloud_server_alert_rule_id": null, "external_status": null, "external_url": null, "alert_rule_state_id": null, "folded_into": null, "unstable_at": null, "unstable_ended_at": null, "outage_count": 1, "down_since": null, "downtime_seconds": 0, "outages": null, "acknowledged_by_name": null, "check": { "id": 4, "organization_id": 1, "name": "Checkout flow", "type": "http", "target": "https://northwind.com/checkout", "enabled": true, "settings": [], "last_status": "down", "last_checked_at": "2026-01-15T11:58:00.000000Z", "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "last_message": "HTTP 503 — Service Unavailable", "consecutive_failures": 8, "flap_threshold": 2, "last_status_changed_at": "2026-01-15T11:20:00.000000Z", "consensus_threshold": 1, "preferred_regions": [ "EU" ], "probe_mode": "any", "ip_version": "prefer_ipv4", "slow_response_ms": null, "ssl_check_enabled": true, "ssl_expiry_days": 21, "heartbeat_uuid": null, "last_ping_at": null, "silenced_until": null, "silenced_by": null, "is_suppressed_by_parent": false, "external_service_id": null, "external_component_ids": null, "external_alerts_enabled": false, "region_checked_at": null, "region_consensus_threshold": null, "last_reason_code": null, "last_reason_params": null, "interval_seconds": 300, "badge_enabled": false, "badge_token": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "server_id": null, "server_link": null, "pagerduty_down_severity": "critical", "pagerduty_degraded_severity": "warning", "interval_minutes": 5 } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/incidents/1/notes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"body":"Rolled back release 2026.01.15 — error rate back to normal."}' ``` **Response** · 201 — Created ```json { "id": 1, "body": "Rolled back release 2026.01.15 — error rate back to normal.", "via": "app", "by": "Alex Rivera", "created_at": "2026-01-15T12:00:00+00:00" } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/incidents/1/unacknowledge" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "monitoring_check_id": 4, "started_at": "2026-01-15T11:20:00.000000Z", "resolved_at": null, "duration_seconds": null, "cause": "Upstream payment gateway timeout", "affected_probe_ids": null, "acknowledged_at": null, "acknowledged_by": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "description": null, "is_planned": false, "title": "Checkout returning 503", "status": "investigating", "impact": "major", "source": "monitor", "server_id": null, "cloud_server_alert_rule_id": null, "external_status": null, "external_url": null, "alert_rule_state_id": null, "folded_into": null, "unstable_at": null, "unstable_ended_at": null, "outage_count": 1, "down_since": null, "downtime_seconds": 0, "outages": null, "acknowledged_by_name": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/incidents/1/updates" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "updates": [ { "id": 3, "monitoring_incident_id": 1, "status": "monitoring", "message": "The failover is live and checkout is succeeding again. Watching error rates before we call this resolved.", "user_id": null, "created_at": "2026-01-15T11:54:00.000000Z", "user": null }, { "id": 8, "monitoring_incident_id": 1, "status": "investigating", "message": "The provider has acknowledged an incident on their side. We are holding while they work.", "user_id": 1, "created_at": "2026-01-15T11:51:00.000000Z", "user": { "id": 1, "first_name": null, "last_name": null, "analytics_id": null } } ], "team_notes": [], "notified": [ "email", "slack" ], "deploys": [ { "id": 9, "source": "github", "kind": "deployment", "workflow": null, "repository": "northwind-cloud/storefront", "environment": "production", "state": "success", "sha": "f19e6c7000000000000000000000000000000000", "ref": "main", "actor": "jordan-k", "url": "https://github.com/northwind-cloud/storefront/deployments", "deployed_at": "2026-01-15T11:17:00+00:00" } ], "oncall": [], "pagerduty_notes": [ { "id": 2, "author_name": "Alex Rivera", "content": "Secondary payment route is warmed up — Sam is switching checkout over to it now.", "created_at": "2026-01-15T11:45:00+00:00" }, { "id": 1, "author_name": "Sam Okoye", "content": "Payment gateway status page shows degraded API performance in eu-west. Opening a ticket with them.", "created_at": "2026-01-15T11:26:00+00:00" } ], "tickets": [] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/incidents/1/updates" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"status":"monitoring","message":"A fix is out; we are watching checkout recover."}' ``` **Response** · 201 — Created ```json { "monitoring_incident_id": 1, "status": "monitoring", "message": "A fix is out; we are watching checkout recover.", "user_id": 1, "created_at": "2026-01-15T12:00:00.000000Z", "id": 9, "incident": { "id": 1, "monitoring_check_id": 4, "started_at": "2026-01-15T11:20:00.000000Z", "resolved_at": null, "duration_seconds": null, "cause": "Upstream payment gateway timeout", "affected_probe_ids": null, "acknowledged_at": null, "acknowledged_by": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "description": null, "is_planned": false, "title": "Checkout returning 503", "status": "investigating", "impact": "major", "source": "monitor", "server_id": null, "cloud_server_alert_rule_id": null, "external_status": null, "external_url": null, "alert_rule_state_id": null, "folded_into": null, "unstable_at": null, "unstable_ended_at": null, "outage_count": 1, "down_since": null, "downtime_seconds": 0, "outages": null, "acknowledged_by_name": null }, "user": { "id": 1, "first_name": null, "last_name": null, "analytics_id": null } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/maintenance-windows" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 3, "organization_id": 1, "name": "Nightly backup window", "description": "Alerts are suppressed while backups run.", "starts_at": null, "ends_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "daily", "recurrence_days": null, "start_time": "03:00", "duration_minutes": 45, "suppress_alerts": true, "status": "scheduled", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks_count": 0, "checks": [], "servers": [], "tags": [], "is_active": false, "occurrence_starts_at": "2026-01-16T03:00:00Z", "occurrence_ends_at": "2026-01-16T03:45:00Z", "schedule_timezone": "UTC" }, { "id": 2, "organization_id": 1, "name": "Load balancer certificate rotation", "description": "Replaced the certificate on web-lb and reloaded the listeners.", "starts_at": "2026-01-06T01:00:00.000000Z", "ends_at": "2026-01-06T01:30:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "suppress_alerts": true, "status": "completed", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks_count": 0, "checks": [], "servers": [], "tags": [], "is_active": false, "occurrence_starts_at": null, "occurrence_ends_at": null, "schedule_timezone": "UTC" } ], "first_page_url": "http://localhost/api/organizations/1/maintenance-windows?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/maintenance-windows?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/maintenance-windows?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/maintenance-windows", "per_page": 25, "prev_page_url": null, "to": 3, "total": 3, "meta": { "counts": { "total": 3, "active": 0, "scheduled": 1, "recurring": 1, "completed": 1 }, "tags": [] } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/maintenance-windows" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"Load balancer upgrade","starts_at":"2026-01-17T22:00:00Z","ends_at":"2026-01-17T23:00:00Z","suppress_alerts":true,"check_ids":[1]}' ``` **Response** · 201 — Created ```json { "name": "Load balancer upgrade", "description": null, "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "starts_at": "2026-01-17T22:00:00.000000Z", "ends_at": "2026-01-17T23:00:00.000000Z", "suppress_alerts": true, "organization_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 6, "checks": [ { "id": 1, "name": "Marketing site", "type": "http", "interval_minutes": 0, "pivot": { "maintenance_window_id": 6, "monitoring_check_id": 1 } } ], "servers": [], "tags": [], "is_active": false, "occurrence_starts_at": "2026-01-17T22:00:00Z", "occurrence_ends_at": "2026-01-17T23:00:00Z", "schedule_timezone": "UTC" } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/maintenance-windows/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"description":"Primary database moves to PostgreSQL 17. Expect two minutes of read-only mode."}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Database cluster upgrade", "description": "Primary database moves to PostgreSQL 17. Expect two minutes of read-only mode.", "starts_at": "2026-01-18T02:00:00.000000Z", "ends_at": "2026-01-18T03:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "suppress_alerts": true, "status": "scheduled", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks": [], "servers": [], "tags": [], "is_active": false, "occurrence_starts_at": "2026-01-18T02:00:00Z", "occurrence_ends_at": "2026-01-18T03:00:00Z", "schedule_timezone": "UTC" } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/maintenance-windows/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Deleted." } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/maintenance-windows/1/complete" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 4, "organization_id": 1, "name": "Database upgrade", "description": null, "starts_at": "2026-01-15T11:50:00.000000Z", "ends_at": "2026-01-15T13:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "suppress_alerts": true, "status": "completed", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks": [], "servers": [], "tags": [], "is_active": false, "occurrence_starts_at": null, "occurrence_ends_at": null, "schedule_timezone": "UTC" } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/maintenance-windows/1/verifying" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 4, "organization_id": 1, "name": "Database upgrade", "description": null, "starts_at": "2026-01-15T11:50:00.000000Z", "ends_at": "2026-01-15T13:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "recurrence_type": "none", "recurrence_days": null, "start_time": null, "duration_minutes": null, "suppress_alerts": true, "status": "verifying", "notified_at": null, "source": "manual", "deploy_id": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "created_by": null, "checks": [], "servers": [], "tags": [], "is_active": true, "occurrence_starts_at": "2026-01-15T11:50:00Z", "occurrence_ends_at": "2026-01-15T13:00:00Z", "schedule_timezone": "UTC" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "name": "Northwind Cloud Status", "slug": "northwind", "custom_domain": "status.northwind.example", "is_public": true, "password_hash": null, "description": "Live status of Northwind Cloud services.", "logo_url": null, "show_incident_history": true, "show_uptime_percentage": true, "subscriber_notifications_enabled": true, "theme": "light", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "overall_status": "major_outage", "custom_domain_status": "pending", "allow_indexing": true, "show_group_labels": true, "footer_text": null, "footer_url": null, "show_tags": false, "show_badge_branding": true, "edge_published": false, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "header_image_url": null, "density": "comfortable", "history_days": 90, "show_aggregate_bar": true, "show_maintenance": true, "show_third_party": true, "template": "default", "on_call_note": "Primary: Sam Okoye · +31 6 12 34 56 78 · #northwind-oncall on Slack. Escalation after 15m: Alex Rivera.", "header_style": "band", "accent_color": null, "header_gradient": true, "links": null, "subscriber_reply_to": null, "meta_title": null, "show_name_with_logo": true, "custom_domain_pending_since": null, "components_count": 8, "subscribers_count": 3, "components_up": 6, "down_components": [ "Checkout & payments" ], "degraded_count": 1, "uptime_90d": 100, "edge_publish_eligible": false } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Northwind Cloud Status", "slug": "northwind", "custom_domain": "status.northwind.example", "is_public": true, "password_hash": null, "description": "Live status of Northwind Cloud services.", "logo_url": null, "show_incident_history": true, "show_uptime_percentage": true, "subscriber_notifications_enabled": true, "theme": "light", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "overall_status": "major_outage", "custom_domain_status": "pending", "allow_indexing": true, "show_group_labels": true, "footer_text": null, "footer_url": null, "show_tags": false, "show_badge_branding": true, "edge_published": false, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "header_image_url": null, "density": "comfortable", "history_days": 90, "show_aggregate_bar": true, "show_maintenance": true, "show_third_party": true, "template": "default", "on_call_note": "Primary: Sam Okoye · +31 6 12 34 56 78 · #northwind-oncall on Slack. Escalation after 15m: Alex Rivera.", "header_style": "band", "accent_color": null, "header_gradient": true, "links": null, "subscriber_reply_to": null, "meta_title": null, "show_name_with_logo": true, "custom_domain_pending_since": null, "components_count": 8, "announcements_count": 2, "subscribers_count": 3, "edge_publish_eligible": false, "components": [ { "id": 1, "status_page_id": 1, "monitoring_check_id": 1, "display_name": "Website", "sort_order": 0, "status": "operational", "status_override": false, "show_uptime_bar": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "runbook_url": null, "status_page_component_group_id": 1, "description": null, "affects_overall_status": true, "group_name": "Public", "monitoring_check": { "id": 1, "name": "Marketing site", "type": "http", "interval_minutes": 0 }, "group": { "id": 1, "name": "Public" } }, { "id": 2, "status_page_id": 1, "monitoring_check_id": 2, "display_name": "Web app", "sort_order": 1, "status": "operational", "status_override": false, "show_uptime_bar": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "runbook_url": null, "status_page_component_group_id": 1, "description": null, "affects_overall_status": true, "group_name": "Public", "monitoring_check": { "id": 2, "name": "App — northwind-app.dev", "type": "http", "interval_minutes": 0 }, "group": { "id": 1, "name": "Public" } } ], "link_card_url": "http://localhost/api/status/northwind/card.png?v=66f618c615aff8ba" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/analytics" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "days": 30, "totals": { "views": 0, "unique_visitors": 0, "subscribe_clicks": 0 }, "previous": { "views": 0, "unique_visitors": 0, "subscribe_clicks": 0 }, "change_pct": null, "busiest": null, "series": [ { "d": "2025-12-17", "views": 0, "unique_visitors": 0, "subscribe_clicks": 0 }, { "d": "2025-12-18", "views": 0, "unique_visitors": 0, "subscribe_clicks": 0 } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/announcements" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 2, "status_page_id": 1, "title": "Released: v2.14.0", "body": "Faster search and a clearer billing page.", "show_from": "2026-01-15T09:00:00.000000Z", "show_until": "2026-01-22T12:00:00.000000Z", "created_at": "2026-01-15T09:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "kind": "information" }, { "id": 1, "status_page_id": 1, "title": "Scheduled maintenance this weekend", "body": "We'll be upgrading our database cluster on Saturday 02:00–03:00 UTC. Brief API slowdowns are possible; no downtime is expected.", "show_from": "2026-01-14T12:00:00.000000Z", "show_until": "2026-01-21T12:00:00.000000Z", "created_at": "2026-01-14T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "kind": "information" } ] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/status-pages/1/announcements" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"title":"New status page address","body":"This page now also answers at status.northwind.example."}' ``` **Response** · 201 — Created ```json { "title": "New status page address", "body": "This page now also answers at status.northwind.example.", "status_page_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 3 } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/status-pages/1/announcements/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"title":"Status page has moved","kind":"information"}' ``` **Response** · 200 ```json { "id": 1, "status_page_id": 1, "title": "Status page has moved", "body": "We'll be upgrading our database cluster on Saturday 02:00–03:00 UTC. Brief API slowdowns are possible; no downtime is expected.", "show_from": "2026-01-14T12:00:00.000000Z", "show_until": "2026-01-21T12:00:00.000000Z", "created_at": "2026-01-14T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "kind": "information" } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/status-pages/1/announcements/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Deleted." } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/cname-setup" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "manageable": false, "matched": false, "published": false, "cname_target": "pages.infranest.io" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/component-groups" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "status_page_id": 1, "name": "Public", "sort_order": 0, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "shows_platform_status": false, "components_count": 5 }, { "id": 2, "status_page_id": 1, "name": "Developer", "sort_order": 1, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "shows_platform_status": false, "components_count": 3 } ] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/status-pages/1/component-groups" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"Customer apps"}' ``` **Response** · 201 — Created ```json { "name": "Customer apps", "sort_order": 2, "status_page_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 3 } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/status-pages/1/component-groups/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"Customer-facing apps"}' ``` **Response** · 200 ```json { "id": 1, "status_page_id": 1, "name": "Customer-facing apps", "sort_order": 0, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "shows_platform_status": false } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/status-pages/1/component-groups/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Deleted.", "components_ungrouped": 5 } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/status-pages/1/component-groups/sort" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"order":[2,1]}' ``` **Response** · 200 ```json { "message": "Order updated." } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/components" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "status_page_id": 1, "monitoring_check_id": 1, "display_name": "Website", "sort_order": 0, "status": "operational", "status_override": false, "show_uptime_bar": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "runbook_url": null, "status_page_component_group_id": 1, "description": null, "affects_overall_status": true, "group_name": "Public", "monitoring_check": { "id": 1, "name": "Marketing site", "type": "http", "last_status": "up", "external_service_id": null, "interval_minutes": 0 }, "group": { "id": 1, "name": "Public", "sort_order": 0 }, "uptime_bars": [ { "date": "2025-10-17", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false }, { "date": "2025-10-18", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false } ] }, { "id": 2, "status_page_id": 1, "monitoring_check_id": 2, "display_name": "Web app", "sort_order": 1, "status": "operational", "status_override": false, "show_uptime_bar": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "runbook_url": null, "status_page_component_group_id": 1, "description": null, "affects_overall_status": true, "group_name": "Public", "monitoring_check": { "id": 2, "name": "App — northwind-app.dev", "type": "http", "last_status": "up", "external_service_id": null, "interval_minutes": 0 }, "group": { "id": 1, "name": "Public", "sort_order": 0 }, "uptime_bars": [ { "date": "2025-10-17", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false }, { "date": "2025-10-18", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false } ] } ] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/status-pages/1/components" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"display_name":"Payments API"}' ``` **Response** · 201 — Created ```json { "display_name": "Payments API", "description": null, "status_page_component_group_id": null, "sort_order": 8, "monitoring_check_id": null, "status": "operational", "status_override": false, "show_uptime_bar": true, "affects_overall_status": true, "runbook_url": null, "status_page_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 9, "group_name": null, "monitoring_check": null, "group": null } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/status-pages/1/components/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"display_name":"Checkout","description":"Payments and order confirmation"}' ``` **Response** · 200 ```json { "id": 1, "status_page_id": 1, "monitoring_check_id": 1, "display_name": "Checkout", "sort_order": 0, "status": "operational", "status_override": false, "show_uptime_bar": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "runbook_url": null, "status_page_component_group_id": 1, "description": "Payments and order confirmation", "affects_overall_status": true, "group_name": "Public", "monitoring_check": { "id": 1, "name": "Marketing site", "type": "http", "last_status": "up", "external_service_id": null, "interval_minutes": 0 }, "group": { "id": 1, "name": "Public", "sort_order": 0 } } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/status-pages/1/components/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Deleted." } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/status-pages/1/components/bulk" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"monitoring_check_ids":[1,2,3]}' ``` **Response** · 201 — Created ```json { "created": [], "skipped": [ 1, 2 ] } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/status-pages/1/components/sort" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"order":[8,7,6,5,4,3,2,1]}' ``` **Response** · 200 ```json { "message": "Order updated." } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/internal" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "page": { "id": 1, "name": "Northwind Cloud Status", "slug": "northwind", "logo_url": null, "is_public": true, "on_call_note": "Primary: Sam Okoye · +31 6 12 34 56 78 · #northwind-oncall on Slack. Escalation after 15m: Alex Rivera." }, "metrics": { "overall_status": "major_outage", "monitors_up": 6, "monitors_total": 8, "uptime_30d": 100, "next_maintenance": null }, "groups": [ { "name": "Public", "components": [ { "id": 1, "display_name": "Website", "status": "operational", "monitoring_check_id": 1, "monitor_name": "Marketing site", "runbook_url": null, "last_checked_at": "2026-01-15T11:58:00+00:00", "regions_reporting": null, "regions_total": null, "uptime_bars": [ { "date": "2025-12-16", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false }, { "date": "2025-12-17", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false } ] }, { "id": 2, "display_name": "Web app", "status": "operational", "monitoring_check_id": 2, "monitor_name": "App — northwind-app.dev", "runbook_url": null, "last_checked_at": "2026-01-15T11:58:00+00:00", "regions_reporting": null, "regions_total": null, "uptime_bars": [ { "date": "2025-12-16", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false }, { "date": "2025-12-17", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false } ] } ] }, { "name": "Developer", "components": [ { "id": 6, "display_name": "API", "status": "operational", "monitoring_check_id": 3, "monitor_name": "API health", "runbook_url": "https://wiki.northwind.example/runbooks/api", "last_checked_at": "2026-01-15T11:58:00+00:00", "regions_reporting": null, "regions_total": null, "uptime_bars": [ { "date": "2025-12-16", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false }, { "date": "2025-12-17", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false } ] }, { "id": 7, "display_name": "Search API", "status": "degraded", "monitoring_check_id": 6, "monitor_name": "Search API", "runbook_url": null, "last_checked_at": "2026-01-15T11:58:00+00:00", "regions_reporting": null, "regions_total": null, "uptime_bars": [ { "date": "2025-12-16", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false }, { "date": "2025-12-17", "uptime_pct": 100, "colour": "green", "incidents": [], "imported": false } ] } ] } ], "active_incidents": [ { "id": 1, "monitoring_check_id": 4, "title": "Checkout returning 503", "status": "investigating", "impact": "major", "started_at": "2026-01-15T11:20:00+00:00", "is_planned": false, "public_url": "/status/northwind/incidents/1" } ], "matrix_days": 30 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/other-notices" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "notices": [ { "kind": "incident", "id": 1, "title": "Checkout returning 503", "starts_at": "2026-01-15T11:20:00+00:00", "ends_at": null, "open": true, "href": "/monitoring/incidents" }, { "kind": "incident", "id": 2, "title": "Brief marketing-site blip", "starts_at": "2026-01-09T11:45:00+00:00", "ends_at": "2026-01-09T12:00:00+00:00", "open": false, "href": "/monitoring/incidents" } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/overview" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "setup": { "components": { "count": 8, "linked": 8, "groups": 2 }, "domain": { "hostname": "status.northwind.example", "status": "pending" }, "subscribers": { "enabled": true, "count": 3 }, "is_public": true }, "uptime": { "days": 90, "pct": 100, "bars": [ { "d": "2025-10-17", "p": 100, "c": "green" }, { "d": "2025-10-18", "p": 100, "c": "green" } ] }, "now": { "overall_status": "major_outage", "components_total": 8, "by_status": { "operational": 6, "major_outage": 1, "degraded": 1 }, "incidents": [ { "id": 1, "monitoring_check_id": 4, "title": "Checkout returning 503", "status": "investigating", "impact": "major", "started_at": "2026-01-15T11:20:00+00:00", "is_planned": false, "public_url": "/status/northwind/incidents/1" } ] }, "upcoming": { "maintenance": null, "announcement_ends": { "id": 1, "title": "Scheduled maintenance this weekend", "ends_at": "2026-01-21T12:00:00+00:00" } } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/subscribers" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "total": 3, "confirmed": 3, "pending": 0, "channels": { "email": 3, "slack": 0, "teams": 0, "discord": 0 }, "growth": { "days": 90, "points": [ { "d": "2025-10-18", "total": 0, "confirmed": 0 }, { "d": "2025-10-19", "total": 0, "confirmed": 0 } ] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/status-pages/1/subscribers/list" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": 3, "channel": "email", "label": "oncall@northwind.example", "confirmed_at": "2026-01-10T12:00:00+00:00", "subscribed_at": "2026-01-15T12:00:00+00:00", "undeliverable": null }, { "id": 2, "channel": "email", "label": "sre@northwind.example", "confirmed_at": "2025-12-29T12:00:00+00:00", "subscribed_at": "2026-01-15T12:00:00+00:00", "undeliverable": null } ], "total": 3, "per_page": 25, "current_page": 1, "last_page": 1 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/alert-channels" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "name": "Ops team — email", "type": "email", "settings": { "email": "ops@northwind.example" }, "enabled": true, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subscriptions": [ "monitoring_down", "monitoring_recovered" ], "is_personal": false, "user_id": null, "format": "html", "last_sent_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "consecutive_failures": 0, "last_failure_at": null, "last_error": null, "last_error_type": null, "broken_since": null, "broken_notified_at": null, "broken_notify_count": 0, "awaiting_confirmation_at": null, "categories": null, "telegram_link_id": null, "telegram_chat_id": null, "slack_installation_id": null, "slack_channel_id": null, "checks_count": 0, "missed_alerts_count": 0, "missed_alerts_min_created_at": null, "needs_telegram_link": false }, { "id": 2, "organization_id": 1, "name": "On-call — critical only", "type": "email", "settings": { "email": "oncall@northwind.example", "critical_only": true }, "enabled": true, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subscriptions": [ "monitoring_down", "domain_expiry_critical" ], "is_personal": false, "user_id": null, "format": "html", "last_sent_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "consecutive_failures": 0, "last_failure_at": null, "last_error": null, "last_error_type": null, "broken_since": null, "broken_notified_at": null, "broken_notify_count": 0, "awaiting_confirmation_at": null, "categories": null, "telegram_link_id": null, "telegram_chat_id": null, "slack_installation_id": null, "slack_channel_id": null, "checks_count": 0, "missed_alerts_count": 0, "missed_alerts_min_created_at": null, "needs_telegram_link": false } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/alert-channels/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Ops team — email", "type": "email", "settings": { "email": "ops@northwind.example" }, "enabled": true, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "subscriptions": [ "monitoring_down", "monitoring_recovered" ], "is_personal": false, "user_id": null, "format": "html", "last_sent_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "consecutive_failures": 0, "last_failure_at": null, "last_error": null, "last_error_type": null, "broken_since": null, "broken_notified_at": null, "broken_notify_count": 0, "awaiting_confirmation_at": null, "categories": null, "telegram_link_id": null, "telegram_chat_id": null, "slack_installation_id": null, "slack_channel_id": null, "checks_count": 0, "checks": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/automation-connections" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "provider": "pagerduty", "kind": "oauth", "label": "Northwind on-call", "meta": { "service_name": "Platform — production", "account": "northwind", "auth": "oauth", "region": "us", "authorized_by": { "name": "Alex Rivera", "email": "demo@example.com" }, "webhook_subscription_id": "PD3WHS1" }, "status": "active", "paused": false, "triggers_on": false, "created_at": "2026-01-15T12:00:00+00:00" }, { "id": 2, "provider": "github", "kind": "github_app", "label": "northwind-cloud", "meta": { "installation_id": "20000001", "account": "northwind-cloud" }, "status": "active", "paused": false, "triggers_on": false, "created_at": "2026-01-15T12:00:00+00:00" } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/automations" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "name": "Release published → announce on status page", "trigger_event": "github.release", "conditions": [ { "op": "eq", "field": "action", "value": "published" }, { "op": "eq", "field": "prerelease", "value": "false" } ], "actions": [ { "action": "create_status_announcement", "config": { "body": "{{name}}.", "title": "Released: {{tag}}", "status_page_id": 1 } } ], "enabled": true, "cooldown_seconds": 0, "consecutive_failures": 0, "disabled_reason": null, "last_triggered_at": null, "created_by": 1, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "condition_match": "all", "run_as": "owner", "trigger_kind": "event", "schedule": null, "trigger_events": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "disabled_detail": null, "template_key": null, "tags": [], "runs_30d": 0, "runs_7d": 0, "success_rate": null, "avg_duration_ms": null, "last_status": null, "last_run_at": null, "spark": [ { "total": 0, "failed": 0 }, { "total": 0, "failed": 0 } ] }, { "id": 2, "organization_id": 1, "name": "PR merged to main → run deploy workflow", "trigger_event": "github.pull_request", "conditions": [ { "op": "eq", "field": "merged", "value": "true" }, { "op": "eq", "field": "base_branch", "value": "main" } ], "actions": [ { "action": "require_approval", "config": { "note": "Production deploy" } }, { "action": "github_trigger_workflow", "config": { "ref": "main", "repo": "northwind-cloud/app", "workflow": "deploy.yml", "connection_id": 2 } } ], "enabled": true, "cooldown_seconds": 0, "consecutive_failures": 0, "disabled_reason": null, "last_triggered_at": null, "created_by": 1, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "condition_match": "all", "run_as": "owner", "trigger_kind": "event", "schedule": null, "trigger_events": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "disabled_detail": null, "template_key": null, "tags": [], "runs_30d": 5, "runs_7d": 5, "success_rate": 40, "avg_duration_ms": 3000, "last_status": "awaiting_approval", "last_run_at": "2026-01-15T09:00:00.000000Z", "spark": [ { "total": 1, "failed": 1 }, { "total": 0, "failed": 0 } ] } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/automations/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Release published → announce on status page", "trigger_event": "github.release", "conditions": [ { "op": "eq", "field": "action", "value": "published" }, { "op": "eq", "field": "prerelease", "value": "false" } ], "actions": [ { "action": "create_status_announcement", "config": { "body": "{{name}}.", "title": "Released: {{tag}}", "status_page_id": 1 } } ], "enabled": true, "cooldown_seconds": 0, "consecutive_failures": 0, "disabled_reason": null, "last_triggered_at": null, "created_by": 1, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "condition_match": "all", "run_as": "owner", "trigger_kind": "event", "schedule": null, "trigger_events": null, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "disabled_detail": null, "template_key": null, "tags": [], "runs": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/automations/1/runs" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "details_hidden": false, "current_page": 1, "data": [], "first_page_url": "http://localhost/api/organizations/1/automations/1/runs?page=1", "from": null, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/automations/1/runs?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/automations/1/runs?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/automations/1/runs", "per_page": 25, "prev_page_url": null, "to": null, "total": 0 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/integrations" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "connections": [ { "id": 1, "kind": "provider", "provider": "hetzner", "integration_key": "hetzner", "name": "Hetzner — Production", "categories": [ "cloud", "dns" ], "capabilities": [ "cloud", "dns" ], "counts": { "servers": 6, "zones": 2, "domains": 0, "certs": 1 }, "suspended_capabilities": [], "incident": null, "auth_kind": "api_token", "enabled": true, "status": "connected", "locked": false, "health": { "status": "ok", "success_rate": 100, "total_calls": 97, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" }, "rate_limited": null, "last_activity_at": "2026-01-15T12:00:00Z" }, { "id": 2, "kind": "provider", "provider": "cloudflare", "integration_key": "cloudflare", "name": "Cloudflare DNS", "categories": [ "dns", "domains" ], "capabilities": [ "dns", "registrar" ], "counts": { "servers": 0, "zones": 5, "domains": 0, "certs": 1 }, "suspended_capabilities": [], "incident": null, "auth_kind": "api_token", "enabled": true, "status": "connected", "locked": false, "health": { "status": "ok", "success_rate": 100, "total_calls": 49, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" }, "rate_limited": null, "last_activity_at": "2026-01-15T12:00:00Z" } ], "summary": { "total": 22, "connected": 16, "degraded": 3, "failing": 2, "disabled": 1, "issues": 5, "locked": 0 }, "locks": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/integrations/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "provider": { "key": "hetzner", "label": "Hetzner", "logo": "hetzner", "capabilities": [ "cloud", "dns" ], "categories": [ "cloud", "dns" ], "dns_scope": "any", "features": [ "zone_discovery", "record_ids" ], "environments": [], "oauth": false, "one_click": false, "needs_allowlist": false, "featured": true, "premium": false, "min_plan": null, "max_connections": null, "credentials": [ { "key": "api_token", "label": "integrations.providers.hetzner.apiToken.label", "secret": true, "multiline": false, "help": "integrations.providers.hetzner.apiToken.help", "help_params": { "aws_account_id": "InfraNest's AWS account (set AWS_INFRANEST_ACCOUNT_ID)" }, "placeholder": "LRK9mXv2QpT8sYw4…", "prefill": null, "type": "text", "options": null, "depends_on": null, "show_when": null, "default": null } ], "kind": "provider", "content": null }, "connections": [ { "id": 1, "kind": "provider", "provider": "hetzner", "integration_key": "hetzner", "name": "Hetzner — Production", "categories": [ "cloud", "dns" ], "capabilities": [ "cloud", "dns" ], "counts": { "servers": 6, "zones": 2, "domains": 0, "certs": 1 }, "suspended_capabilities": [], "incident": null, "auth_kind": "api_token", "enabled": true, "status": "connected", "locked": false, "health": { "status": "ok", "success_rate": 100, "total_calls": 97, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" }, "rate_limited": null, "last_activity_at": "2026-01-15T12:00:00Z" } ], "gate": { "locked": false, "reason": null, "premium": false, "min_plan": null, "min_plan_name": null, "current_plan": "pro", "current_plan_name": "Pro", "max_connections": null, "used": 1, "grandfathered": false, "included": false } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/integrations/1/accounts/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "removing": false, "is_oauth": false, "auth_kind": "api_token", "oauth": null, "error_email_enabled": true, "alerts_muted_until": null, "incident": null, "notices": [], "spending": null, "capabilities": [ "cloud", "dns" ], "supported_capabilities": [ "cloud", "dns" ], "cloud_capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "dns_capabilities": { "record_writes": true, "bulk_replace": false, "zone_create": true, "zone_delete": true, "record_proxying": false, "signing": false }, "dns_scope": "any", "cloud_firewall_protocols": [ "tcp", "udp" ], "enabled_capabilities": null, "suspended_capabilities": [], "resource_counts": { "dns": 2, "certificates": 1, "cloud": 6 }, "verified_at": "2025-10-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "fields": [ "api_token" ], "environment": null, "field_values": { "api_token": { "set": true, "secret": true, "display": "••••oken" } }, "context": [], "health": { "status": "ok", "success_rate": 100, "total_calls": 97, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" }, "registrar_operations": null, "scope_check": null, "scope_checked_at": null, "disabled_operations": [], "api_base": "/organizations/1/provider-credentials/1" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/integrations/1/activity" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": 9, "credential_id": 1, "capability": "cloud", "direction": "outbound", "method": "GET", "endpoint": "/v1/servers", "action": "listServers", "success": true, "http_status": 200, "duration_ms": 60, "error_type": null, "error_message": null, "created_at": "2026-01-15T12:00:00.000000Z" }, { "id": 10, "credential_id": 1, "capability": "cloud", "direction": "outbound", "method": "GET", "endpoint": "/v1/volumes", "action": "listVolumes", "success": true, "http_status": 200, "duration_ms": 112, "error_type": null, "error_message": null, "created_at": "2026-01-15T11:57:00.000000Z" } ], "total": 672, "last_page": 34, "meta": { "accounts": [ { "id": 1, "label": "Hetzner — Production", "context": [] } ], "capabilities": [ "cloud" ], "directions": [ "outbound" ], "rate_limit": null } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/integrations/1/activity/export" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 — The integration's activity log as CSV. (`text/csv`)

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/provider-credentials" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "removing": false, "is_oauth": false, "auth_kind": "api_token", "oauth": null, "error_email_enabled": true, "alerts_muted_until": null, "incident": null, "notices": [], "spending": null, "capabilities": [ "cloud", "dns" ], "supported_capabilities": [ "cloud", "dns" ], "cloud_capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "dns_capabilities": { "record_writes": true, "bulk_replace": false, "zone_create": true, "zone_delete": true, "record_proxying": false, "signing": false }, "dns_scope": "any", "cloud_firewall_protocols": [ "tcp", "udp" ], "enabled_capabilities": null, "suspended_capabilities": [], "resource_counts": { "dns": 2, "certificates": 1, "cloud": 6 }, "verified_at": "2025-10-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "fields": [ "api_token" ], "environment": null, "field_values": { "api_token": { "set": true, "secret": true, "display": "••••oken" } }, "context": [], "health": { "status": "ok", "success_rate": 100, "total_calls": 97, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" } }, { "id": 2, "provider": "cloudflare", "label": "Cloudflare DNS", "enabled": true, "removing": false, "is_oauth": false, "auth_kind": "api_token", "oauth": null, "error_email_enabled": true, "alerts_muted_until": null, "incident": null, "notices": [], "spending": null, "capabilities": [ "dns", "registrar" ], "supported_capabilities": [ "dns", "registrar" ], "cloud_capabilities": [], "dns_capabilities": { "record_writes": true, "bulk_replace": false, "zone_create": true, "zone_delete": true, "record_proxying": true, "signing": true }, "dns_scope": "any", "cloud_firewall_protocols": [], "enabled_capabilities": null, "suspended_capabilities": [], "resource_counts": { "dns": 5, "registrar": 0, "certificates": 1 }, "verified_at": "2025-10-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "fields": [ "api_token", "account_id" ], "environment": null, "field_values": { "api_token": { "set": true, "secret": true, "display": "••••oken" }, "account_id": { "set": true, "secret": false, "display": "demoaccount0000000000000000cf01" } }, "context": [], "health": { "status": "ok", "success_rate": 100, "total_calls": 49, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" } } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/provider-credentials/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "provider": "hetzner", "label": "Hetzner — Production", "enabled": true, "removing": false, "is_oauth": false, "auth_kind": "api_token", "oauth": null, "error_email_enabled": true, "alerts_muted_until": null, "incident": null, "notices": [], "spending": null, "capabilities": [ "cloud", "dns" ], "supported_capabilities": [ "cloud", "dns" ], "cloud_capabilities": { "native_delete_protection": true, "server_destroy": true, "server_destroy_is_cancellation": false, "server_create": true, "server_rename": true, "console": true, "snapshots": true, "backups": true, "isos": true, "rescue": true, "placement_groups": true, "public_network_toggle": true, "scheduled_backups": true, "private_networks": true, "private_network_attach": true, "network_join_on_create": false, "network_attach_ip_choice": true, "private_network_unfiltered": true, "floating_ips": true, "networks_creatable": true, "network_cidr": true, "network_subnets": true, "network_routes": true, "network_rename": true, "network_ip_range_extendable": true, "firewalls_creatable": true, "firewall_multi_server": true, "firewall_renamable": true, "firewall_outbound": true, "firewall_ipv6": true, "firewall_dynamic_ip": true, "server_firewall": false, "load_balancers_creatable": true, "load_balancer_rename": true, "load_balancer_algorithm": true, "load_balancer_services": true, "load_balancer_targets": true, "volumes_creatable": true, "volume_resize": true, "volume_rename": true, "volume_native_delete_protection": true, "network_native_delete_protection": true, "user_data": true, "install_flavour": false, "images_per_plan": false, "metrics": true, "metrics_disk_throughput": true, "rdns_subnet": true, "rdns_address_list": false, "reverse_dns": true, "snapshot_description": true, "snapshot_protection": true }, "dns_capabilities": { "record_writes": true, "bulk_replace": false, "zone_create": true, "zone_delete": true, "record_proxying": false, "signing": false }, "dns_scope": "any", "cloud_firewall_protocols": [ "tcp", "udp" ], "enabled_capabilities": null, "suspended_capabilities": [], "resource_counts": { "dns": 2, "certificates": 1, "cloud": 6 }, "verified_at": "2025-10-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "fields": [ "api_token" ], "environment": null, "field_values": { "api_token": { "set": true, "secret": true, "display": "••••oken" } }, "context": [], "health": { "status": "ok", "success_rate": 100, "total_calls": 97, "last_error_at": null, "last_success_at": "2026-01-15T12:00:00Z" }, "registrar_operations": null, "scope_check": null, "scope_checked_at": null, "disabled_operations": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/provider-credentials/1/logs" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 9, "provider": "hetzner", "capability": "cloud", "method": "GET", "endpoint": "/v1/servers", "success": true, "http_status": 200, "duration_ms": 60, "error_type": null, "error_message": null, "provider_request_id": null, "request_summary": null, "response_summary": null, "created_at": "2026-01-15T12:00:00.000000Z" }, { "id": 10, "provider": "hetzner", "capability": "cloud", "method": "GET", "endpoint": "/v1/volumes", "success": true, "http_status": 200, "duration_ms": 112, "error_type": null, "error_message": null, "provider_request_id": null, "request_summary": null, "response_summary": null, "created_at": "2026-01-15T11:57:00.000000Z" } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/provider-credentials/health" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "unhealthy": 2, "total": 10 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/webhook-endpoints/schema" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "schema": { "type": "object", "properties": { "event": { "title": "Event", "type": "string" }, "created_at": { "title": "Created at", "type": "string", "format": "date-time" }, "data": { "type": "object", "properties": { "acknowledged_by": { "title": "Acknowledged by", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "action": { "title": "Action", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "actor": { "title": "Actor", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "agent": { "title": "Agent", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "asn_org": { "title": "ASN org", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assignee": { "title": "Assignee", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "assignees": { "title": "Assignees", "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "auction": { "title": "Auction", "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "author": { "title": "Author", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "base_branch": { "title": "Base branch", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "branch": { "title": "Branch", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "change": { "title": "Change", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "changed_fields": { "title": "Changed fields", "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "check_name": { "title": "Check name", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "comment": { "title": "Comment", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "commits": { "title": "Commits", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "conclusion": { "title": "Conclusion", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "context": { "title": "Context", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "title": "Country code", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created": { "title": "Created", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "creator": { "title": "Creator", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "current_ipv4": { "title": "Current IPv4", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "current_ipv6": { "title": "Current IPv6", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "custom_fields": { "title": "Custom fields", "anyOf": [ { "type": "object" }, { "type": "null" } ] }, "days_left": { "title": "Days left", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "deleted": { "title": "Deleted", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "deleted_in": { "title": "Deleted in", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "deployment_id": { "title": "Deployment ID", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "description": { "title": "Description", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "domain": { "title": "Domain", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "draft": { "title": "Draft", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "drop_eta": { "title": "Drop ETA", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "duration_minutes": { "title": "Duration minutes", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "email": { "title": "Email", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "endpoint": { "title": "Endpoint", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "environment": { "title": "Environment", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "environment_url": { "title": "Environment URL", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "escalation_policy": { "title": "Escalation policy", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "expires_at": { "title": "Expires at", "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "expiry_may_be_stale": { "title": "Expiry may be stale", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "forced": { "title": "Forced", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "head_branch": { "title": "Head branch", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "head_sha": { "title": "Head SHA", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "host": { "title": "Host", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "identifier": { "title": "Identifier", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "incident_title": { "title": "Incident title", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "incident_type": { "title": "Incident type", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "incident_url": { "title": "Incident URL", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ip": { "title": "IP", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ip_version": { "title": "IP version", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "is_hosting": { "title": "Is hosting", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "is_pull_request": { "title": "Is pull request", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "issue_type": { "title": "Issue type", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "issuer": { "title": "Issuer", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "issues": { "title": "Issues", "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "label": { "title": "Label", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "labels": { "title": "Labels", "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "log_url": { "title": "Log URL", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "merged": { "title": "Merged", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "message": { "title": "Message", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "monitor_type": { "title": "Monitor type", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "title": "Name", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "new_nameservers": { "title": "New nameservers", "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "note": { "title": "Note", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "note_trimmed": { "title": "Note trimmed", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "number": { "title": "Number", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "old_nameservers": { "title": "Old nameservers", "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ] }, "owner": { "title": "Owner", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "owner_email": { "title": "Owner email", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "owner_name": { "title": "Owner name", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pd_connection_id": { "title": "PagerDuty connection ID", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "pd_incident_id": { "title": "PagerDuty incident ID", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "prerelease": { "title": "Prerelease", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "previous_state": { "title": "Previous state", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "priority": { "title": "Priority" }, "production_environment": { "title": "Production environment", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "project": { "title": "Project", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider": { "title": "Provider", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pusher": { "title": "Pusher", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "record_action": { "title": "Record action", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "record_name": { "title": "Record name", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "record_type": { "title": "Record type", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "records": { "title": "Records", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "ref": { "title": "Ref", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "ref_type": { "title": "Ref type", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "registrar": { "title": "Registrar", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "repo": { "title": "Repo", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "responder": { "title": "Responder", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "responder_message": { "title": "Responder message", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "responder_state": { "title": "Responder state", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "reviewer": { "title": "Reviewer", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "run_attempt": { "title": "Run attempt", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "run_id": { "title": "Run ID", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "run_number": { "title": "Run number", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "server_name": { "title": "Server name", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "service": { "title": "Service", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "sha": { "title": "SHA", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "size_gb": { "title": "Size GB", "anyOf": [ { "type": "integer" }, { "type": "null" } ] }, "state": { "title": "State", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "title": "Status", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status_page": { "title": "Status page", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subject": { "title": "Subject", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tag": { "title": "Tag", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "title": "Task", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "team": { "title": "Team", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "title": { "title": "Title", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tld": { "title": "TLD", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "transient_environment": { "title": "Transient environment", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "trigger_event": { "title": "Triggering event", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "triggering_actor": { "title": "Triggering actor", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": { "title": "Type", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unused": { "title": "Unused", "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "update_status": { "title": "Update status", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "urgency": { "title": "Urgency", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "url": { "title": "URL", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "via": { "title": "Via", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "workflow": { "title": "Workflow", "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "zone": { "title": "Zone", "anyOf": [ { "type": "string" }, { "type": "null" } ] } } } }, "required": [ "event", "created_at" ] }, "events": [ "domain.registered", "domain.expiring" ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 3, "organization_id": 1, "name": "northwind", "tld": "app", "priority": 5, "status": "available", "auto_register": true, "registrar": null, "consecutive_available_count": 0, "notes": null, "last_checked_at": "2026-01-15T09:00:00.000000Z", "available_since": null, "registered_at": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "next_check_at": "2026-01-15T13:00:00.000000Z", "observed_expires_at": null, "observed_status": null, "drop_eta": null, "date_visibility": null, "score": 88, "score_breakdown": null, "scored_at": "2026-01-15T12:00:00.000000Z", "registrar_preferences": null, "lifecycle_stage": "available", "observed_created_at": null, "contact_id": null, "extended_attributes": null, "catchability": 90, "catchability_signals": { "verdict": "available", "factors": [] }, "dns_signals": null, "observed_registrar": null, "observed_updated_at": null, "observed_nameservers": null, "lifecycle_progress": null, "http_signals": null, "enrichment_signals": null, "burst_until": null, "parallel_race": false, "in_auction": false, "auction": null, "backorder": false, "backorder_credential_id": null, "backorder_status": null, "whois_raw_at": null, "drop_eta_uncertainty_days": null, "lifecycle_source": null, "lifecycle_stage_since": "2026-01-10T12:00:00.000000Z", "published_drop_at": null, "deleted_at_registry": null, "dropping_soon_alerted_at": null, "last_successful_check_at": null, "consecutive_check_errors": 0, "check_failing_alerted_at": null, "funding": null, "funding_alerted_at": null, "full_name": "northwind.app", "drop_score": 5, "tags": [] }, { "id": 13, "organization_id": 1, "name": "northwind-app", "tld": "com", "priority": 5, "status": "failed", "auto_register": true, "registrar": null, "consecutive_available_count": 0, "notes": null, "last_checked_at": "2026-01-15T09:00:00.000000Z", "available_since": null, "registered_at": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "next_check_at": "2026-01-15T13:00:00.000000Z", "observed_expires_at": null, "observed_status": null, "drop_eta": null, "date_visibility": null, "score": 87, "score_breakdown": null, "scored_at": "2026-01-15T12:00:00.000000Z", "registrar_preferences": null, "lifecycle_stage": "active", "observed_created_at": null, "contact_id": null, "extended_attributes": null, "catchability": 30, "catchability_signals": { "verdict": "active", "factors": [] }, "dns_signals": null, "observed_registrar": null, "observed_updated_at": null, "observed_nameservers": null, "lifecycle_progress": null, "http_signals": null, "enrichment_signals": null, "burst_until": null, "parallel_race": false, "in_auction": false, "auction": null, "backorder": false, "backorder_credential_id": null, "backorder_status": null, "whois_raw_at": null, "drop_eta_uncertainty_days": null, "lifecycle_source": null, "lifecycle_stage_since": "2026-01-09T12:00:00.000000Z", "published_drop_at": null, "deleted_at_registry": null, "dropping_soon_alerted_at": null, "last_successful_check_at": null, "consecutive_check_errors": 0, "check_failing_alerted_at": null, "funding": null, "funding_alerted_at": null, "full_name": "northwind-app.com", "drop_score": 5, "tags": [] } ], "first_page_url": "http://localhost/api/organizations/1/watched-domains?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/watched-domains?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/watched-domains?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/watched-domains", "per_page": 25, "prev_page_url": null, "to": 16, "total": 16, "meta": { "counts": { "total": 16, "active": 13, "available": 2, "registered": 1, "failed": 1, "paused": 1, "in_auction": 1, "not_armed": 8 }, "tags": [] } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "northwind-labs", "tld": "com", "priority": 5, "status": "watching", "auto_register": false, "registrar": null, "consecutive_available_count": 0, "notes": null, "last_checked_at": "2026-01-15T09:00:00.000000Z", "available_since": null, "registered_at": null, "deleted_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "next_check_at": "2026-01-15T13:00:00.000000Z", "observed_expires_at": "2025-11-13T12:00:00.000000Z", "observed_status": null, "drop_eta": "2026-01-27T12:00:00.000000Z", "date_visibility": null, "score": 84, "score_breakdown": null, "scored_at": "2026-01-15T12:00:00.000000Z", "registrar_preferences": null, "lifecycle_stage": "redemption", "observed_created_at": null, "contact_id": null, "extended_attributes": null, "catchability": 78, "catchability_signals": { "verdict": "likely", "factors": [] }, "dns_signals": null, "observed_registrar": null, "observed_updated_at": null, "observed_nameservers": null, "lifecycle_progress": null, "http_signals": null, "enrichment_signals": null, "burst_until": null, "parallel_race": false, "in_auction": false, "auction": null, "backorder": false, "backorder_credential_id": null, "backorder_status": null, "whois_raw": null, "whois_raw_at": null, "drop_eta_uncertainty_days": null, "lifecycle_source": null, "lifecycle_stage_since": "2026-01-12T12:00:00.000000Z", "published_drop_at": null, "deleted_at_registry": null, "dropping_soon_alerted_at": null, "last_successful_check_at": null, "consecutive_check_errors": 0, "check_failing_alerted_at": null, "funding": null, "funding_alerted_at": null, "check_logs_count": 0, "registration_logs_count": 0, "full_name": "northwind-labs.com", "drop_score": 5, "tags": [], "drop_stats": { "heuristic": 78, "probability": null, "basis_n": 0, "scope": null, "phase": "redemption", "tld": "com" }, "lifecycle_anchors": { "registered": null, "expired": "2025-11-13T12:00:00+00:00", "redemption": "2025-12-28T12:00:00+00:00", "pending_delete": "2026-01-27T12:00:00+00:00", "drop": "2026-02-01T12:00:00+00:00" }, "measured_samples": null, "release": null, "cadence": [ { "starts_at": null, "every_seconds": 21600 }, { "starts_at": "2026-01-25T12:00:00+00:00", "every_seconds": 3600 } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/1/check-logs" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [], "first_page_url": "http://localhost/api/organizations/1/watched-domains/1/check-logs?page=1", "from": null, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/watched-domains/1/check-logs?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/watched-domains/1/check-logs?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/watched-domains/1/check-logs", "per_page": 100, "prev_page_url": null, "to": null, "total": 0 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/1/registration-logs" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [], "first_page_url": "http://localhost/api/organizations/1/watched-domains/1/registration-logs?page=1", "from": null, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/watched-domains/1/registration-logs?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/watched-domains/1/registration-logs?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/watched-domains/1/registration-logs", "per_page": 50, "prev_page_url": null, "to": null, "total": 0 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/1/whois-changes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 1, "watched_domain_id": 1, "field": "status", "old_value": "clientTransferProhibited", "new_value": "redemptionPeriod", "changed_at": "2026-01-11T12:00:00.000000Z" }, { "id": 2, "watched_domain_id": 1, "field": "expiry", "old_value": "2026-08-14", "new_value": "2026-08-14", "changed_at": "2025-12-20T12:00:00.000000Z" } ], "first_page_url": "http://localhost/api/organizations/1/watched-domains/1/whois-changes?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/watched-domains/1/whois-changes?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/watched-domains/1/whois-changes?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/watched-domains/1/whois-changes", "per_page": 50, "prev_page_url": null, "to": 3, "total": 3 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/held?name=www&tld=%3Ctld%3E" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "domain": { "id": 1, "full_name": "northwind.com", "status": "active", "tenure": "held", "registrar": "Namecheap", "expires_at": "2026-02-02T00:00:00+00:00", "auto_renew": true } } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/registrars" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "registrars": [ { "credential_id": 2, "provider": "cloudflare", "provider_name": "Cloudflare", "provider_label": "Cloudflare DNS", "supports_tld": null, "price": null, "can_race": false }, { "credential_id": 3, "provider": "namecheap", "provider_name": "Namecheap", "provider_label": "Namecheap Registrar", "supports_tld": null, "price": null, "can_race": false } ], "requirements": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/watched-domains/registrars/identities" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "registrars": [ { "credential_id": 2, "provider": "cloudflare", "provider_name": "Cloudflare", "provider_label": "Cloudflare DNS", "can_race": false }, { "credential_id": 3, "provider": "namecheap", "provider_name": "Namecheap", "provider_label": "Namecheap Registrar", "can_race": false } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/whois-servers" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "tld": "dev", "server": "whois.nic.google", "note": "Override for .dev lookups.", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/invitations" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "email": "newcolleague@northwind.example", "invited_by": 1, "accepted_at": null, "expires_at": "2026-01-20T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "org_role_id": 3, "origin": null, "inviter": { "id": 1, "name": "Alex Rivera", "email": "demo@example.com", "analytics_id": null }, "org_role": { "id": 3, "organization_id": null, "name": "Member", "slug": "member", "is_system": true, "permissions": { "dns.read": true, "dns.write": false, "cloud.read": true, "cloud.write": false, "billing.read": false, "domains.read": true, "roles.manage": false, "billing.write": false, "domains.write": false, "domains.delete": false, "members.manage": false, "monitoring.read": true, "monitoring.write": false }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null } } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/members" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 2, "name": "Sam Okoye", "email": "sam@example.com", "email_undeliverable": false, "org_role": { "id": 2, "organization_id": null, "name": "Admin", "slug": "admin", "is_system": true, "permissions": { "dns.read": true, "dns.write": true, "cloud.read": true, "cloud.write": true, "billing.read": true, "domains.read": true, "roles.manage": false, "billing.write": false, "domains.write": true, "domains.delete": false, "members.manage": true, "monitoring.read": true, "monitoring.write": true }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null }, "sso_external": false }, { "id": 3, "name": "Priya Raghunathan", "email": "priya@example.com", "email_undeliverable": false, "org_role": { "id": 3, "organization_id": null, "name": "Member", "slug": "member", "is_system": true, "permissions": { "dns.read": true, "dns.write": false, "cloud.read": true, "cloud.write": false, "billing.read": false, "domains.read": true, "roles.manage": false, "billing.write": false, "domains.write": false, "domains.delete": false, "members.manage": false, "monitoring.read": true, "monitoring.write": false }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null }, "sso_external": false } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "name": "Northwind Cloud", "slug": "northwind-demo", "deleted_at": null, "created_at": "2025-10-17T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "avatar_url": null, "reseller_id": null, "entitlement_overrides": { "api": true, "cloud": true, "api.mcp": true, "domains": null, "servers": null, "api.read": true, "monitors": null, "webhooks": true, "api.write": true, "dns.drift": true, "dns_zones": null, "drop_catch": true, "module.api": true, "module.dns": true, "automations": null, "data_import": true, "dynamic_ips": null, "white_label": true, "certificates": null, "module.cloud": true, "security.sso": true, "status_pages": null, "team_members": null, "cloud.backups": true, "cloud.volumes": true, "custom_fields": true, "dns.templates": true, "organizations": null, "security.scim": true, "api.tokens_max": null, "cloud.networks": true, "cost_reporting": true, "email_branding": true, "module.domains": true, "cloud.firewalls": true, "cloud.providers": "all", "cloud.snapshots": true, "monitor_regions": true, "watched_domains": null, "module.dropcatch": true, "cloud.volumes_max": null, "external_monitors": null, "module.monitoring": true, "monitored_servers": null, "cloud.networks_max": null, "dropcatch.register": true, "module.automations": true, "monitoring.regions": "all", "cloud.firewalls_max": null, "dropcatch.backorder": true, "module.certificates": true, "module.integrations": true, "module.status_pages": true, "status_page_private": true, "cloud.load_balancers": true, "data_export_advanced": true, "domains.registration": true, "monitoring.incidents": true, "security.ip_allowlist": true, "integrations.providers": "all", "monitoring.check_types": "all", "monitoring.maintenance": true, "status_page_whitelabel": true, "dropcatch.parallel_race": true, "automations.action_types": "all", "cloud.load_balancers_max": null, "monitoring.calendar_feed": true, "status_page_custom_domain": true, "automations.premium_actions": true, "integrations.connections_max": null, "integrations.chat_destinations": null }, "stripe_customer_id": null, "require_reauth_destructive": false, "require_reauth_power": false, "dynamic_ip_default_strict": false, "dynamic_ip_default_fail_closed": false, "require_2fa": false, "password_min_length": null, "password_require_symbols": null, "password_max_age_days": null, "entitlement_overrides_meta": null, "base_currency": "EUR", "price_display": "net", "vat_rate": "21.00", "country": null, "is_demo": true, "timezone": null, "sso_required": false, "suspended_at": null, "suspended_reason": null, "ip_allowlist": null, "session_lifetime_days": null, "pagerduty_webhook_token": null, "vat_number": null, "vat_status": null, "vat_trader_name": null, "vat_country": null, "vat_consultation_number": null, "vat_checked_at": null, "billing_email": null, "billing_cc": null, "billing_reference": null, "purge_after": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "purge_reminder_sent_at": null, "alerts_quiet_until": null, "billing_country": null, "trial_used_at": null, "recap_cadence": "monthly", "brand_logo_url": "http://localhost/storage/org-brand-logos/docs-demo-northwind.svg", "brand_accent_color": "#0F766E", "brand_email_from_name": "Northwind Cloud", "acquisition_src": null, "acquisition_plan": null, "acquisition_cadence": null, "acquisition_code": null, "customer_number": "4200017", "size_band": null, "presignup_first_page": null, "presignup_sessions": null, "presignup_days": null, "sso_required_since": null, "is_internal": false, "client_field_id": null, "onboarding_report_sent_at": null, "notification_defaults": null, "api_writes_enabled_at": null, "is_sandbox": false, "referral_code": "northwind-cloud", "acquisition_ref": null, "users_count": 4, "analytics_id": "api.infranest.io-4200017", "pivot": { "user_id": 1, "organization_id": 1, "org_role_id": 1, "sso_external": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "name": "Northwind Cloud", "slug": "northwind-demo", "deleted_at": null, "created_at": "2025-10-17T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "avatar_url": null, "reseller_id": null, "entitlement_overrides": { "api": true, "cloud": true, "api.mcp": true, "domains": null, "servers": null, "api.read": true, "monitors": null, "webhooks": true, "api.write": true, "dns.drift": true, "dns_zones": null, "drop_catch": true, "module.api": true, "module.dns": true, "automations": null, "data_import": true, "dynamic_ips": null, "white_label": true, "certificates": null, "module.cloud": true, "security.sso": true, "status_pages": null, "team_members": null, "cloud.backups": true, "cloud.volumes": true, "custom_fields": true, "dns.templates": true, "organizations": null, "security.scim": true, "api.tokens_max": null, "cloud.networks": true, "cost_reporting": true, "email_branding": true, "module.domains": true, "cloud.firewalls": true, "cloud.providers": "all", "cloud.snapshots": true, "monitor_regions": true, "watched_domains": null, "module.dropcatch": true, "cloud.volumes_max": null, "external_monitors": null, "module.monitoring": true, "monitored_servers": null, "cloud.networks_max": null, "dropcatch.register": true, "module.automations": true, "monitoring.regions": "all", "cloud.firewalls_max": null, "dropcatch.backorder": true, "module.certificates": true, "module.integrations": true, "module.status_pages": true, "status_page_private": true, "cloud.load_balancers": true, "data_export_advanced": true, "domains.registration": true, "monitoring.incidents": true, "security.ip_allowlist": true, "integrations.providers": "all", "monitoring.check_types": "all", "monitoring.maintenance": true, "status_page_whitelabel": true, "dropcatch.parallel_race": true, "automations.action_types": "all", "cloud.load_balancers_max": null, "monitoring.calendar_feed": true, "status_page_custom_domain": true, "automations.premium_actions": true, "integrations.connections_max": null, "integrations.chat_destinations": null }, "stripe_customer_id": null, "require_reauth_destructive": false, "require_reauth_power": false, "dynamic_ip_default_strict": false, "dynamic_ip_default_fail_closed": false, "require_2fa": false, "password_min_length": null, "password_require_symbols": null, "password_max_age_days": null, "entitlement_overrides_meta": null, "base_currency": "EUR", "price_display": "net", "vat_rate": "21.00", "country": null, "is_demo": true, "timezone": null, "sso_required": false, "suspended_at": null, "suspended_reason": null, "ip_allowlist": null, "session_lifetime_days": null, "pagerduty_webhook_token": null, "vat_number": null, "vat_status": null, "vat_trader_name": null, "vat_country": null, "vat_consultation_number": null, "vat_checked_at": null, "billing_email": null, "billing_cc": null, "billing_reference": null, "purge_after": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "purge_reminder_sent_at": null, "alerts_quiet_until": null, "billing_country": null, "trial_used_at": null, "recap_cadence": "monthly", "brand_logo_url": "http://localhost/storage/org-brand-logos/docs-demo-northwind.svg", "brand_accent_color": "#0F766E", "brand_email_from_name": "Northwind Cloud", "acquisition_src": null, "acquisition_plan": null, "acquisition_cadence": null, "acquisition_code": null, "customer_number": "4200017", "size_band": null, "presignup_first_page": null, "presignup_sessions": null, "presignup_days": null, "sso_required_since": null, "is_internal": false, "client_field_id": null, "onboarding_report_sent_at": null, "notification_defaults": null, "api_writes_enabled_at": null, "is_sandbox": false, "referral_code": "northwind-cloud", "acquisition_ref": null, "analytics_id": "api.infranest.io-4200017", "subscription": { "id": 1, "organization_id": 1, "plan_id": 2, "status": "active", "provider": "stripe", "provider_subscription_id": "sub_demo_northwind", "trial_ends_at": null, "current_period_start": "2026-01-01T00:00:00.000000Z", "current_period_end": "2026-02-15T12:00:00.000000Z", "canceled_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "cancel_at_period_end": false, "stripe_price_id": null, "currency": "eur", "trial_reminder_sent_at": null, "renewal_reminder_sent_at": null, "card_expiry_reminder_sent_at": null, "addons": [], "card_on_file": false, "trial_recap_sent_at": null, "trial_last_call_sent_at": null, "trial_first_steps_sent_at": null, "trial_ended_at": null, "trial_reactivation_sent_at": null, "recap_period_start": null, "renewal_recap_sent_for": null, "discount_code": null, "discount_percent": null, "discount_amount_off": null, "discount_duration": null, "discount_starts_at": null, "discount_ends_at": null, "discount_label": null, "plan": { "id": 2, "name": "Pro", "slug": "pro", "description": "For freelancers & solo devs — faster checks, cloud, API and automations.", "limits": { "api": true, "rate": { "manual_sync_per_hour": 30, "domain_checks_per_hour": 100, "monitor_checks_per_hour": 120, "provider_api_per_minute": 300 }, "cloud": true, "api.mcp": true, "domains": 100, "servers": 10, "api.read": true, "monitors": 50, "webhooks": true, "api.write": true, "dns.drift": true, "dns_zones": 100, "drop_catch": true, "automations": 25, "data_import": true, "dynamic_ips": 10, "certificates": 100, "status_pages": 3, "team_members": 3, "cloud.backups": true, "cloud.volumes": true, "dns.templates": true, "organizations": 1, "api.tokens_max": 5, "cloud.firewalls": true, "cloud.snapshots": true, "watched_domains": 50, "cloud.volumes_max": 10, "external_monitors": 5, "dropcatch.register": true, "cloud.firewalls_max": 5, "audit.retention_days": 30, "domains.registration": true, "monitor_min_interval": 60, "monitoring.incidents": true, "monitoring.maintenance": true, "cloud.load_balancers_max": 0, "monitoring.calendar_feed": true, "monitoring.retention_days": 90, "status_page_custom_domain": true, "dns.history_retention_days": 90, "automations.premium_actions": true, "integrations.connections_max": 5 }, "price_monthly": 2250, "price_yearly": 22800, "active": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "is_public": true, "sort_order": 2, "stripe_product_id": null, "stripe_prices": null, "prices": { "eur": { "yearly": 22800, "monthly": 2250 } }, "trial_days": 0, "recommended": false, "name_i18n": null, "description_i18n": null, "badge": null, "tagline_i18n": { "de": "Freelancer & Solo-Entwickler", "en": "Freelancers & solo devs", "fr": "Freelances & développeurs solo", "nl": "Freelancers & solo-ontwikkelaars" }, "highlights_i18n": { "de": [ "Alles in Free", "100 Domains" ], "en": [ "Everything in Free", "100 domains" ], "fr": [ "Tout dans Free", "100 domaines" ], "nl": [ "Alles in Free", "100 domeinen" ] }, "contact_sales": false, "contact_url": null } }, "users": [ { "id": 2, "name": "Sam Okoye", "email": "sam@example.com", "analytics_id": null, "pivot": { "organization_id": 1, "user_id": 2, "org_role_id": 2, "sso_role_managed": false, "sso_external": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } }, { "id": 3, "name": "Priya Raghunathan", "email": "priya@example.com", "analytics_id": null, "pivot": { "organization_id": 1, "user_id": 3, "org_role_id": 3, "sso_role_managed": false, "sso_external": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/roles" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": [ { "id": 2, "organization_id": null, "name": "Admin", "slug": "admin", "is_system": true, "permissions": { "dns.read": true, "dns.write": true, "cloud.read": true, "cloud.write": true, "billing.read": true, "domains.read": true, "roles.manage": false, "billing.write": false, "domains.write": true, "domains.delete": false, "members.manage": true, "monitoring.read": true, "monitoring.write": true }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null }, { "id": 3, "organization_id": null, "name": "Member", "slug": "member", "is_system": true, "permissions": { "dns.read": true, "dns.write": false, "cloud.read": true, "cloud.write": false, "billing.read": false, "domains.read": true, "roles.manage": false, "billing.write": false, "domains.write": false, "domains.delete": false, "members.manage": false, "monitoring.read": true, "monitoring.write": false }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/roles/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "data": { "id": 1, "organization_id": null, "name": "Owner", "slug": "owner", "is_system": true, "permissions": { "dns.read": true, "dns.write": true, "cloud.read": true, "cloud.write": true, "billing.read": true, "domains.read": true, "roles.manage": true, "billing.write": true, "domains.write": true, "domains.delete": true, "members.manage": true, "monitoring.read": true, "monitoring.write": true }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null } } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/sandbox/reset" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/custom-field-values?entity_type=%3Centity_type%3E&entity_id=16" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "custom_field_definition_id": 1, "value": "Platform" }, { "id": 2, "custom_field_definition_id": 2, "value": "Web platform" } ] ```

**Request** ```sh curl -X PUT "https://api.infranest.io/api/organizations/42/custom-field-values" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"entity_type":"server","entity_id":1,"definition_id":1,"value":"Platform"}' ``` **Response** · 200 ```json { "id": 1, "custom_field_definition_id": 1, "value": "Platform" } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/custom-fields" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 1, "organization_id": 1, "entity_types": [ "server", "domain" ], "key": "cost_centre", "label": "Cost centre", "type": "select", "options": [ "Platform", "Marketing" ], "required": false, "sort": 0, "show_on_detail": true, "show_as_column": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null }, { "id": 2, "organization_id": 1, "entity_types": [ "server" ], "key": "owner_team", "label": "Owning team", "type": "text", "options": null, "required": false, "sort": 1, "show_on_detail": true, "show_as_column": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null } ] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/custom-fields" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"entity_types":["server"],"key":"cost_center","label":"Cost center","type":"text"}' ``` **Response** · 201 — Created ```json { "entity_types": [ "server" ], "key": "cost_center", "label": "Cost center", "type": "text", "options": null, "required": false, "sort": 0, "show_on_detail": true, "show_as_column": false, "organization_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 4 } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/custom-fields/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"entity_types":["server","domain"],"key":"cost_centre","label":"Responsible team","type":"select","options":["Platform","Marketing","Data","Internal tools"]}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "entity_types": [ "server", "domain" ], "key": "cost_centre", "label": "Responsible team", "type": "select", "options": [ "Platform", "Marketing" ], "required": false, "sort": 0, "show_on_detail": true, "show_as_column": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/custom-fields/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/tags" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 3, "organization_id": 1, "name": "Customer-facing", "color": "#3b82f6", "uptime_target_pct": null, "is_client": false, "created_at": "2026-01-15T12:00:00.000000Z", "usage_count": 12 }, { "id": 4, "organization_id": 1, "name": "Internal", "color": "#8b5cf6", "uptime_target_pct": null, "is_client": false, "created_at": "2026-01-15T12:00:00.000000Z", "usage_count": 11 } ] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/tags" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"name":"Payments","color":"#3B82F6"}' ``` **Response** · 201 — Created ```json { "name": "Payments", "color": "#3B82F6", "organization_id": 1, "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 7 } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/tags/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"color":"#22C55E","uptime_target_pct":99.9}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "name": "Production", "color": "#22C55E", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "uptime_target_pct": "99.900", "is_client": false } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/tags/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cost-events" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/cost-items?entity_type=%3Centity_type%3E" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/organizations/42/cost-items" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"entity_type":"organization","label":"Uptime SMS credits","amount":9,"currency":"EUR"}' ``` **Response** · 201 — Created ```json { "organization_id": 1, "label": "Uptime SMS credits", "amount": "9.00", "currency": "EUR", "period": "monthly", "updated_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "id": 2 } ```

**Request** ```sh curl -X PATCH "https://api.infranest.io/api/organizations/42/cost-items/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{"label":"Status page SMS credits","amount":15,"currency":"EUR"}' ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "cost_itemable_type": null, "cost_itemable_id": null, "label": "Status page SMS credits", "amount": "15.00", "currency": "EUR", "period": "monthly", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } ```

**Request** ```sh curl -X DELETE "https://api.infranest.io/api/organizations/42/cost-items/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 204 — no content

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/price-changes?entity_type=%3Centity_type%3E&entity_id=16" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 2, "organization_id": 1, "priceable_type": "App\\Models\\Domain", "priceable_id": 1, "label": "northwind.com", "field": "renewal_price", "old_amount": "13.5000", "old_currency": "EUR", "old_interval": "yearly", "old_interval_count": 1, "new_amount": "12.5000", "new_currency": "EUR", "new_interval": "yearly", "new_interval_count": 1, "source": "api", "changed_by_user_id": null, "observed_at": "2025-12-02T12:00:00.000000Z", "effective_from": "2025-12-02T00:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "changed_by": null } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/account-credit" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "credit": [] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/credit-notes" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/invoices" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [ { "id": 6, "number": "INF-2026-0100", "status": "paid", "currency": "eur", "total": 4719, "tax": 819, "paid_at": "2026-01-02T00:00:00.000000Z", "hosted_invoice_url": null, "invoice_pdf": null, "period_start": "2026-01-01T00:00:00.000000Z", "period_end": "2026-01-31T23:59:59.000000Z", "created_at": "2026-01-01T00:00:00.000000Z" }, { "id": 5, "number": "INF-2025-0101", "status": "paid", "currency": "eur", "total": 4719, "tax": 819, "paid_at": "2025-12-02T00:00:00.000000Z", "hosted_invoice_url": null, "invoice_pdf": null, "period_start": "2025-12-01T00:00:00.000000Z", "period_end": "2025-12-31T23:59:59.000000Z", "created_at": "2025-12-01T00:00:00.000000Z" } ] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/referrals" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "enabled": true, "code": "northwind-cloud", "link": "http://localhost/r/northwind-cloud", "can_change": true, "currency": "eur", "stats": { "signed_up": 5, "paying": 3, "rewards_this_year": 2, "max_rewards_per_year": 12, "earned": 12800, "on_its_way": 1, "remaining": 7000 }, "referrals": [ { "id": 4, "name": "Ve•••• Labs", "joined_at": "2026-01-11T12:00:00+00:00", "status": "pending", "void_reason": null, "credited_from": null, "reward_amount": null, "reward_currency": null, "reward_remaining": null }, { "id": 3, "name": "Ha•••• IT", "joined_at": "2025-12-26T12:00:00+00:00", "status": "qualifying", "void_reason": null, "credited_from": "2026-01-28T12:00:00+00:00", "reward_amount": null, "reward_currency": null, "reward_remaining": null } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/subscription" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "id": 1, "organization_id": 1, "plan_id": 2, "status": "active", "provider": "stripe", "provider_subscription_id": "sub_demo_northwind", "trial_ends_at": null, "current_period_start": "2026-01-01T00:00:00.000000Z", "current_period_end": "2026-02-15T12:00:00.000000Z", "canceled_at": null, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "cancel_at_period_end": false, "stripe_price_id": null, "currency": "eur", "trial_reminder_sent_at": null, "renewal_reminder_sent_at": null, "card_expiry_reminder_sent_at": null, "addons": [], "card_on_file": false, "trial_recap_sent_at": null, "trial_last_call_sent_at": null, "trial_first_steps_sent_at": null, "trial_ended_at": null, "trial_reactivation_sent_at": null, "recap_period_start": null, "renewal_recap_sent_for": null, "discount_code": null, "discount_percent": null, "discount_amount_off": null, "discount_duration": null, "discount_starts_at": null, "discount_ends_at": null, "discount_label": null, "plan": { "id": 2, "name": "Pro", "slug": "pro", "description": "For freelancers & solo devs — faster checks, cloud, API and automations.", "limits": { "api": true, "rate": { "manual_sync_per_hour": 30, "domain_checks_per_hour": 100, "monitor_checks_per_hour": 120, "provider_api_per_minute": 300 }, "cloud": true, "api.mcp": true, "domains": 100, "servers": 10, "api.read": true, "monitors": 50, "webhooks": true, "api.write": true, "dns.drift": true, "dns_zones": 100, "drop_catch": true, "automations": 25, "data_import": true, "dynamic_ips": 10, "certificates": 100, "status_pages": 3, "team_members": 3, "cloud.backups": true, "cloud.volumes": true, "dns.templates": true, "organizations": 1, "api.tokens_max": 5, "cloud.firewalls": true, "cloud.snapshots": true, "watched_domains": 50, "cloud.volumes_max": 10, "external_monitors": 5, "dropcatch.register": true, "cloud.firewalls_max": 5, "audit.retention_days": 30, "domains.registration": true, "monitor_min_interval": 60, "monitoring.incidents": true, "monitoring.maintenance": true, "cloud.load_balancers_max": 0, "monitoring.calendar_feed": true, "monitoring.retention_days": 90, "status_page_custom_domain": true, "dns.history_retention_days": 90, "automations.premium_actions": true, "integrations.connections_max": 5 }, "price_monthly": 2250, "price_yearly": 22800, "active": true, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "is_public": true, "sort_order": 2, "stripe_product_id": null, "stripe_prices": null, "prices": { "eur": { "yearly": 22800, "monthly": 2250 } }, "trial_days": 0, "recommended": false, "name_i18n": null, "description_i18n": null, "badge": null, "tagline_i18n": { "de": "Freelancer & Solo-Entwickler", "en": "Freelancers & solo devs", "fr": "Freelances & développeurs solo", "nl": "Freelancers & solo-ontwikkelaars" }, "highlights_i18n": { "de": [ "Alles in Free", "100 Domains" ], "en": [ "Everything in Free", "100 domains" ], "fr": [ "Tout dans Free", "100 domaines" ], "nl": [ "Alles in Free", "100 domeinen" ] }, "contact_sales": false, "contact_url": null }, "effective_plan_id": 2, "effective_plan_slug": "pro", "trial_available": true, "referral_welcome": null, "suggested_promotion_code": null, "discount": null } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/subscription/addons" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json [] ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/audit-logs" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "current_page": 1, "data": [ { "id": 25, "organization_id": 1, "user_id": 1, "action": "status_page_subscribers.viewed", "resource_type": "StatusPage", "resource_id": 1, "meta": { "count": 3, "status_page": "Northwind Cloud Status" }, "ip_address": "127.0.0.1", "user_agent": "Symfony", "created_at": "2026-01-15T12:00:00.000000Z", "impersonator_id": null, "via_token_id": 5, "via_token_name": "api-samples", "user": { "id": 1, "name": "Alex Rivera", "email": "demo@example.com", "analytics_id": null }, "impersonator": null }, { "id": 24, "organization_id": 1, "user_id": 1, "action": "data.exported", "resource_type": null, "resource_id": null, "meta": { "month": "2025-12", "format": "csv", "filters": [], "resource": "uptime-report" }, "ip_address": "127.0.0.1", "user_agent": "Symfony", "created_at": "2026-01-15T12:00:00.000000Z", "impersonator_id": null, "via_token_id": 5, "via_token_name": "api-samples", "user": { "id": 1, "name": "Alex Rivera", "email": "demo@example.com", "analytics_id": null }, "impersonator": null } ], "first_page_url": "http://localhost/api/organizations/1/audit-logs?page=1", "from": 1, "last_page": 1, "last_page_url": "http://localhost/api/organizations/1/audit-logs?page=1", "links": [ { "url": null, "label": "« Previous", "page": null, "active": false }, { "url": "http://localhost/api/organizations/1/audit-logs?page=1", "label": "1", "page": 1, "active": true } ], "next_page_url": null, "path": "http://localhost/api/organizations/1/audit-logs", "per_page": 25, "prev_page_url": null, "to": 24, "total": 24 } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/audit-logs/export" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 — The matching audit log entries as CSV. (`text/csv`)

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/export" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "resources": [ { "key": "domains", "label": "Domains", "locked": false }, { "key": "contacts", "label": "Contacts", "locked": false } ], "formats": [ { "key": "csv", "locked": false }, { "key": "json", "locked": false } ] } ```

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/export/1" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 — The resource as CSV (the default), JSON or XML, as `format` asks. (`text/csv`, `application/json`, `application/xml`)

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/export/bundle" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 — Every exportable resource, one file each, in a ZIP archive. (`application/zip`)

**Request** ```sh curl "https://api.infranest.io/api/organizations/42/import" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "resources": [ { "key": "contacts", "label": "Contacts", "headers": [ "first_name", "last_name" ] }, { "key": "ssl-certificates", "label": "SSL certificates", "headers": [ "subject", "sans" ] } ], "allowed": true } ```

**Request** ```sh curl -X POST "https://api.infranest.io/api/auth/logout" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "message": "Logged out successfully." } ```

**Request** ```sh curl "https://api.infranest.io/api/auth/me" \ -H "Authorization: Bearer $INFRANEST_TOKEN" \ -H "Accept: application/json" ``` **Response** · 200 ```json { "user": { "id": 1, "name": "Alex Rivera", "email": "demo@example.com", "email_verified_at": "2026-01-15T12:00:00.000000Z", "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "is_super_admin": false, "blocked_at": null, "block_reason": null, "locked_until": null, "notification_preferences": { "quiet_hours": { "from": "22:00", "to": "07:00", "tz": "Europe/Amsterdam" } }, "two_factor_confirmed_at": null, "first_name": null, "last_name": null, "language": "en", "avatar_url": "http://localhost/storage/avatars/docs-demo-alex.svg", "dashboard_layout": null, "platform_role": "user", "email_format": "html", "onboarding": null, "password_changed_at": "2026-01-15T12:00:00.000000Z", "pending_email": null, "pending_email_sent_at": null, "terms_accepted_at": null, "terms_version": null, "marketing_consent_at": null, "timezone": null, "time_format": "auto", "force_password_reset": false, "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null, "anonymized_at": null, "analytics_opt_out": false, "open_on_dashboard_id": null, "default_organization_id": null, "analytics_id": "api.infranest.io-4200017", "organizations": [ { "id": 1, "name": "Northwind Cloud", "slug": "northwind-demo", "country": null, "avatar_url": null, "base_currency": "EUR", "timezone": null, "price_display": "net", "vat_rate": "21.00", "require_reauth_destructive": false, "require_reauth_power": false, "require_2fa": false, "password_min_length": null, "password_require_symbols": null, "password_max_age_days": null, "dynamic_ip_default_strict": false, "dynamic_ip_default_fail_closed": false, "recap_cadence": "monthly", "sso_required": false, "sso_required_since": null, "is_demo": true, "is_sandbox": false, "users_count": 4, "org_role": { "id": 1, "organization_id": null, "name": "Owner", "slug": "owner", "is_system": true, "permissions": { "dns.read": true, "dns.write": true, "cloud.read": true, "cloud.write": true, "billing.read": true, "domains.read": true, "roles.manage": true, "billing.write": true, "domains.write": true, "domains.delete": true, "members.manage": true, "monitoring.read": true, "monitoring.write": true }, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z", "deleted_at": null, "purge_after": null, "purge_reminder_sent_at": null, "deleted_by_id": null, "deleted_by_label": null, "deletion_reason": null }, "sso_admitted": true, "effective_timezone": "UTC", "managed_by": [ "Sam Okoye" ], "analytics_id": null, "pivot": { "user_id": 1, "organization_id": 1, "org_role_id": 1, "sso_external": false, "created_at": "2026-01-15T12:00:00.000000Z", "updated_at": "2026-01-15T12:00:00.000000Z" } } ] }, "unread_notifications": 3, "is_impersonated": false, "is_standing_in": false, "impersonated_by": null, "session_country_code": null, "session_region_code": null, "two_factor_setup_required": false, "password_reset_required": false, "email_verification_required": false, "email_undeliverable": false, "email_security_phrase": null, "has_passkeys": false, "passkey_count": 0, "has_password": true, "sso_only": null, "can_go_passwordless": false, "recovery_codes_left": null, "gravatar_enabled": false, "gravatar_default": "mp", "avatar_sources": [ "google", "github" ], "oauth_avatars": [], "stripe_enabled": false, "stripe_publishable_key": null } ```