{ "info": { "name": "InfraNest API", "description": "The public InfraNest API. Set `token` to an API token (My account → Developer) and `organization_id` to your organization. Docs: https://developers.infranest.io", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.infranest.io" }, { "key": "token", "value": "" }, { "key": "organization_id", "value": "" } ], "item": [ { "name": "Domains", "description": "Domains and contacts as InfraNest knows them. Registrar actions (register, renew, transfer) stay in the app.", "item": [ { "name": "Get registration requirements for an extension", "request": { "method": "GET", "description": "The extra fields a registrar needs to register a domain under `tld` (for example the nexus details some country extensions ask for) and the registration periods it offers. `credential_id` and `tld` are required; `unknown` is true when the registrar could not be asked, in which case it may still refuse.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/registration-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "registration-fields" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Check a domain before transferring it in", "request": { "method": "GET", "description": "Checks the usual reasons an inbound transfer fails for the domain given by `name` and `tld`, before you submit it. Optionally pass `credential_id` for the registrar that would receive it; counts toward your plan’s hourly domain-check limit.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/transfer-preflight", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "transfer-preflight" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List domain findings", "request": { "method": "GET", "description": "Advisor findings across all your domains, most urgent first, with one finding per cause naming every domain it affects.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domain-findings", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domain-findings" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get the domains overview", "request": { "method": "GET", "description": "A summary of your domains: what needs your attention, what the next year of renewals costs in your base currency, and how the portfolio is protected.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/overview", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "overview" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Plan a settings change across domains", "request": { "method": "GET", "description": "For each domain in `ids` (up to 500), who would carry out turning `setting` on or off (`value`, default true). Changes nothing; each setting is changed through its own endpoint.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/settings-plan", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "settings-plan" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Plan email protection across domains", "request": { "method": "GET", "description": "For each domain in `ids` (up to 200), the email protection plan for `mode` (`protect` or `no_mail`) and its `route`: `here`, `elsewhere` (records to copy to your DNS host), `reconnect`, `unchanged`, `refused` or `none` (no zone held). Changes nothing; apply it through each zone’s email protection endpoint.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/email-protection-plan", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "email-protection-plan" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Plan CAA protection across domains", "request": { "method": "GET", "description": "For each domain in `ids` (up to 200), the CAA plan and its `route`, as for the email protection plan. Changes nothing; apply it through each zone’s CAA protection endpoint, which checks the zone’s certificates first.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/caa-protection-plan", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "caa-protection-plan" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Track a domain by name", "request": { "method": "POST", "description": "Adds a domain held at a registrar InfraNest is not connected to; its registrar, dates, status and nameservers are read from the public registry, now and daily. Only `name` is accepted; it counts toward your plan’s domain limit, and a domain already in your organization is refused with 422.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/track", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "track" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"northwind-studio.com\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List domains", "request": { "method": "GET", "description": "Your domains, paginated with `page` and `per_page` (up to 200), each with its tags, advisor issue count and who hosts its website and mail. Filter with `search`, `credential`, `tag`, `active`, `expiring_soon`, `autorenew_off`, `website`, `mail` or `archived` (archived domains are left out unless asked for). Registration orders that failed are not domains you hold and are left out too; pass `include_failed=1` to list them, and `meta.counts.failed` says how many there are. Sort with `sort` (`domain`, `registrar`, `expires`) and `dir`.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a domain", "request": { "method": "GET", "description": "One domain with its full details. A domain over your plan’s domain limit is locked and cannot be opened; stale renewal pricing is refreshed in the background.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "id", "value": "" } ] } } }, { "name": "Update a domain", "request": { "method": "PUT", "description": "Updates what InfraNest keeps for the domain: `notes`, `serves_website`, `expected_issuers`, `nameservers`, `registrar_contacts`, pricing and `tag_ids`. Registration data such as the expiry date and auto-renew is not accepted here; returns the domain’s full details.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"notes\": \"Main brand domain. Renew three years ahead.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Archive a domain", "request": { "method": "POST", "description": "Takes the domain out of your working list while keeping it, its costs and its links; it keeps syncing and stops counting toward your plan’s domain limit. Refused with 422 while the domain is still active at a connected registrar.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/archive", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "archive" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Unarchive a domain", "request": { "method": "POST", "description": "Brings an archived domain back into your working list, where it counts toward your plan’s domain limit again. A domain that is not archived is returned unchanged.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/unarchive", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "unarchive" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "List a domain’s contacts", "request": { "method": "GET", "description": "The contacts assigned to the domain, each with its role in `pivot.type`.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/contacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "contacts" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Assign a contact to a domain", "request": { "method": "POST", "description": "Assigns one of your contacts (`contact_id`) to the domain as `registrant`, `admin`, `tech` or `billing`, replacing whoever held that role. Recorded in InfraNest only; nothing is sent to the registrar.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/contacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "contacts" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"contact_id\": 1,\n \"type\": \"admin\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remove a contact from a domain", "request": { "method": "DELETE", "description": "Unassigns the contact from the domain in every role it held. The contact itself is kept.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/contacts/:contact_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "contacts", ":contact_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" }, { "key": "contact_id", "value": "" } ] } } }, { "name": "Get a domain’s registrar pricing", "request": { "method": "GET", "description": "The registrar’s current prices for the domain’s extension, asked live. Answers 404 when no registrar connection is linked; `pricing` is null when the registrar does not allow price lookups with your key.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/pricing", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "pricing" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "List a domain’s running registrar actions", "request": { "method": "GET", "description": "The action currently running at the registrar for this domain, where the registrar reports one; `can_retry` says whether it can be retried. An empty list when no registrar is linked or the registrar does not offer this.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/actions", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "actions" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Check a domain’s nameservers", "request": { "method": "GET", "description": "Checks each of the domain’s nameservers now: whether it answers on port 53 and is authoritative, whether the nameservers agree with each other, and whether DNSSEC validates. Empty when the domain has no nameservers; the result is kept for the advisor.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/ns-health", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "ns-health" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Get how a domain is set up", "request": { "method": "GET", "description": "Who hosts the domain’s DNS and whether its nameservers answer, its mail provider, and the servers, certificates, monitors and status pages behind its addresses. Based on the DNS zone InfraNest holds; a domain whose DNS is hosted elsewhere gets no website or email details.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/setup", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "setup" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Get a domain’s registry record", "request": { "method": "GET", "description": "What the registry itself says about the domain: its status codes, created and updated dates, the source (RDAP or WHOIS) and an excerpt of the raw answer.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/registry-record", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "registry-record" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Get a domain’s advisor findings", "request": { "method": "GET", "description": "The current advisor findings for one domain, taking into account what its registrar supports.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/advisor", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "advisor" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Get a domain’s registrar capabilities", "request": { "method": "GET", "description": "Which registrar operations are available for this domain, given what its registrar and extension support, with a `reason` when something is unavailable.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/capabilities", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "capabilities" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Look up a domain’s WHOIS", "request": { "method": "GET", "description": "A live WHOIS lookup for the domain. Answers 422 with a message when the lookup fails.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/whois", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "whois" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Get a domain’s audit history", "request": { "method": "GET", "description": "The 50 most recent audit-log entries for the domain and its manual cost items, newest first.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/history", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "history" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "Get a domain’s transfer code", "request": { "method": "GET", "description": "Fetches the domain’s EPP (auth) code live from its registrar; InfraNest never stores it. Needs write access; answers 404 when no registrar is linked or the registrar cannot provide the code.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/:domain_id/epp-code", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", ":domain_id", "epp-code" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "domain_id", "value": "" } ] } } }, { "name": "List contacts", "request": { "method": "GET", "description": "Your organization’s contacts, paginated with `page` and `per_page` (up to 200), with their tags. Filter with `search` or `tag`, and sort with `sort` (`name`, `company`, `email`, `city`, `country`) and `dir`.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/contacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "contacts" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a contact", "request": { "method": "POST", "description": "Creates a contact you can assign to domains as registrant, admin, tech or billing contact, optionally tagged with `tag_ids`.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/contacts", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "contacts" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"first_name\": \"Ada\",\n \"last_name\": \"Brandt\",\n \"email\": \"ada@northwind.example\",\n \"country\": \"DE\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get a contact", "request": { "method": "GET", "description": "One contact with the domains it is assigned to.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "contacts", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "id", "value": "" } ] } } }, { "name": "Update a contact", "request": { "method": "PUT", "description": "Updates the contact and, when `tag_ids` is sent, its tags. Recorded in InfraNest only; nothing is sent to a registrar.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "contacts", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"company\": \"Northwind Cloud GmbH\",\n \"city\": \"Köln\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a contact", "request": { "method": "DELETE", "description": "Deletes the contact from your organization.\n\nScope: `domains.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/contacts/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "contacts", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "id", "value": "" } ] } } }, { "name": "List registrar moves", "request": { "method": "GET", "description": "The 200 most recent moves of domains to another registrar you have connected, newest first, each with its domain, source and target connection, and current state.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/domains/registrar-moves", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "domains", "registrar-moves" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "DNS", "description": "Zones and records at your DNS providers, templates and dynamic IP sources. Record changes are recorded in the zone history and can be undone.", "item": [ { "name": "Plan moving records to another server", "request": { "method": "GET", "description": "Shows what moving A/AAAA records from one server to another would change: each record with its new value, the records left out and why, and the monitors that would follow. Send `from_server_id` or `record_ids`, and optionally `to_server_id`; changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns/address-move", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns", "address-move" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Sync a zone from its provider", "request": { "method": "POST", "description": "Queues a fresh import of the zone’s records from its DNS provider and answers with `queued: true`. Refused with 422 for a zone with no linked provider connection; manual syncs are limited per hour by your plan.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/sync", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "sync" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Download a zone as a BIND file", "request": { "method": "GET", "description": "Returns the zone’s records as a BIND master file, in plain text, as an attachment named after the zone. The export is recorded in your audit log.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/zone-file", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "zone-file" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Get a zone’s audit history", "request": { "method": "GET", "description": "The 50 most recent audit-log entries for the zone and its records, deleted records included, newest first.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/history", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "history" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "List a zone’s recorded changes", "request": { "method": "GET", "description": "The zone’s record changes from its last 50 operations, newest first, grouped by the operation that made each batch, each with whether it can still be undone or restored to. Also returns a merged timeline and how many days of changes your plan keeps.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/changes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "changes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Preview restoring a zone to an earlier point", "request": { "method": "GET", "description": "Shows what putting every record back the way it was just after the batch `batch_id` (required) would change. Changes nothing; answers 404 when that batch is not in the zone’s history.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/restore-preview", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "restore-preview" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Undo a DNS change", "request": { "method": "POST", "description": "Undoes one recorded change (`change_id`) or every change in a batch (`batch_id`), even across zones, pushing each one to the DNS provider. A change whose record has changed since, or that a dynamic IP keeps up to date, is skipped with its reason; answers 404 when nothing matches.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-changes/undo", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-changes", "undo" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List outside changes to a zone", "request": { "method": "GET", "description": "Records changed at the DNS provider outside InfraNest that nobody has decided on yet, newest first, each with what the record was and is now. `writable` says whether your earlier value can be put back for this zone.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/outside-changes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "outside-changes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "List leftover records in a zone", "request": { "method": "GET", "description": "Records the zone appears to have outgrown, such as old verification codes, addresses that stopped answering and duplicates, each with its reason and evidence. `writable` is false when InfraNest cannot change records in this zone.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/leftovers", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "leftovers" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Compare stored records with live DNS", "request": { "method": "GET", "description": "Records whose stored value differs from what public resolvers last answered, each with both values, the likely cause and whether taking the live value is offered. Also returns the zone’s delegation state; changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/live-mismatch", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "live-mismatch" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Check whether an address left your fleet", "request": { "method": "GET", "description": "Says whether the `address` query parameter (required) belongs to one of your servers, or is an address one of your servers held and released. A record cannot be pointed at a released address.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/released-address", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "released-address" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Get what a zone’s records point at", "request": { "method": "GET", "description": "For each record in the zone, keyed by record id: what it points at (one of your servers, a recognised service, a connection or a released address) and what uses it, such as monitors, certificates and status pages. Records with neither are left out; `long_ttl` is the TTL above which InfraNest calls a TTL long.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/record-context", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "record-context" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Preview what a record value would point at", "request": { "method": "GET", "description": "Says what a record of the given `type` with the given `value` (both required) would point at, before you save it. `points_at` is null when nothing is recognised.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/points-at", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "points-at" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Set a record’s label", "request": { "method": "PUT", "description": "Sets or clears a note on what the record is for (`label`, up to 120 characters; empty or null clears it). Kept in InfraNest only and never written to the DNS provider; a labelled record is never proposed as a leftover.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records/:record_id/label", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records", ":record_id", "label" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" }, { "key": "record_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"label\": \"Main website\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List server addresses for records", "request": { "method": "GET", "description": "Your servers that have an address, each with the IPv4 and IPv6 address an A or AAAA record should hold to reach it. Where a server holds a whole IPv6 block, `basis` says how the address was chosen.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/server-addresses", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "server-addresses" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "List DNS zones", "request": { "method": "GET", "description": "Your DNS zones, paginated with `page` and `per_page` (up to 200), each with its provider, record count, tags and delegation state. Filter with `search`, `credential`, `tag` or `status` (`active`, `stale`, `drift` for records changed at the provider, or `security`) and sort with `sort` (`zone`, `provider`, `records`, `synced`) and `dir`; `meta.counts` holds the totals.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a DNS zone", "request": { "method": "GET", "description": "One zone with all its records, its provider connection, whether record changes can be pushed to the provider, its delegation and DNSSEC details, and findings such as records pointing at released addresses. Opening it may queue fresh nameserver and live-DNS checks in the background.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "List records in a zone", "request": { "method": "GET", "description": "Every record in the zone, ordered by type and name, with the dynamic IP source that keeps it up to date, if any. Filter by record type with `type`.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Create a record", "request": { "method": "POST", "description": "Creates a record in the zone and pushes it to the DNS provider; `dry_run=1` returns the change without making it. Refused with 422 when the zone is read-only or an A/AAAA value is an address your fleet released, and with 409 when an apex CAA record would block a certificate’s renewal, unless `confirm_caa_impact` is sent.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"A\",\n \"name\": \"api\",\n \"value\": \"192.0.2.20\",\n \"ttl\": 3600\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get a record", "request": { "method": "GET", "description": "One record in the zone. Answers 404 when the record belongs to another zone.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records/:record_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records", ":record_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" }, { "key": "record_id", "value": "" } ] } } }, { "name": "Update a record", "request": { "method": "PUT", "description": "Changes the record and pushes the change to the DNS provider; `dry_run=1` returns the change without making it. Refused with 422 when the zone is read-only or a new A/AAAA value is an address your fleet released, and with 409 when an apex CAA change would block a certificate’s renewal, unless `confirm_caa_impact` is sent.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records/:record_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records", ":record_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" }, { "key": "record_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"type\": \"A\",\n \"name\": \"www\",\n \"value\": \"192.0.2.11\",\n \"ttl\": 3600\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a record", "request": { "method": "DELETE", "description": "Deletes the record at the DNS provider first, then in InfraNest; if the provider refuses, the record is kept and 502 is returned. Supports `dry_run=1`, and `confirm_caa_impact=1` after a 409 for an apex CAA record whose removal would block a certificate’s renewal.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records/:record_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records", ":record_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" }, { "key": "record_id", "value": "" } ] } } }, { "name": "List dynamic IP sources", "request": { "method": "GET", "description": "Your dynamic IP sources (connections whose address changes, such as a home or office line), ordered by label, each with its tags and the DNS records and firewalls it keeps up to date.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dynamic-ips", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dynamic-ips" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List servers a dynamic IP can follow", "request": { "method": "GET", "description": "Your servers with an InfraNest agent, which a dynamic IP source can take its address from, most recent agent check-in first.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dynamic-ips/agent-servers", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dynamic-ips", "agent-servers" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a dynamic IP source", "request": { "method": "GET", "description": "One source with its targets, its 20 most recent address events and the server agent it follows, if any. The update token is never included; `can_reveal` says whether it can be shown again.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dynamic-ips/:dynamicIp_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dynamic-ips", ":dynamicIp_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dynamicIp_id", "value": "" } ] } } }, { "name": "Get a dynamic IP source’s history", "request": { "method": "GET", "description": "Address changes, what each one updated or failed to update, and changes to the source’s settings, newest first. Drawn from your audit log, so it ages out with your plan’s audit retention.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dynamic-ips/:dynamicIp_id/history", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dynamic-ips", ":dynamicIp_id", "history" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dynamicIp_id", "value": "" } ] } } }, { "name": "Get the DNS overview", "request": { "method": "GET", "description": "A summary across all your DNS zones: what needs your attention, grouped by cause, the recent changes, where your DNS is hosted and what is worth tidying up. Changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns/overview", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns", "overview" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Search records across all zones", "request": { "method": "GET", "description": "Finds DNS records in any of your zones that match the `q` query parameter, by name, value or address, grouped by zone with the reason each one matched. A query shorter than two characters returns nothing with `too_short` set; at most 100 records are returned, with `truncated` set when there were more.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns/search", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns", "search" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List DNS host moves", "request": { "method": "GET", "description": "The 200 most recent moves of a domain’s DNS to another DNS host, newest first, each with its domain, target connection, current `state` and timestamps.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns/moves", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns", "moves" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Check a zone’s live DNS security", "request": { "method": "GET", "description": "Resolves the zone’s SPF, DMARC, DKIM, MX, CAA, MTA-STS, BIMI, NS, address and DNSSEC answers from public DNS right now, with findings judged by the same rules as the stored-record advisor. Reflects what the internet answers, not what InfraNest stores.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/security-check", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "security-check" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Get a zone’s advisor findings", "request": { "method": "GET", "description": "Findings about the zone’s stored records, such as missing or weak email protection, with the snapshot those findings were judged from. Changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/advisor", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "advisor" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Preview email protection for a zone", "request": { "method": "GET", "description": "Shows each email record (such as SPF and DMARC) as it is and as it would be, or why a change is refused. `mode` is required: `protect` for a domain that receives mail, `no_mail` for one that sends none; `live=1` also checks against public DNS. Changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/email-protection", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "email-protection" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Preview CAA protection for a zone", "request": { "method": "GET", "description": "Shows the CAA records that would be added, each of the zone’s certificates and whether it stays renewable, or why a change is refused. `live=1` also checks each record against public DNS. Changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/caa-protection", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "caa-protection" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Get a zone’s DNSSEC status", "request": { "method": "GET", "description": "Reads the zone’s DNSSEC state from its DNS provider, including the DS details to add at your registrar when signing is waiting on that step. `status` is null when the provider cannot sign the zone or its state could not be read.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dnssec", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dnssec" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" } ] } } }, { "name": "Check a record’s propagation", "request": { "method": "GET", "description": "Asks public DNS resolvers for the record and reports, per resolver, whether its stored value is live yet; `tier=fast` uses only the quicker resolvers. With `landing=1` it instead reports whether the record’s latest change (or the one in `change_id`) has taken effect, and `landing` is null when nothing changed recently.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-zones/:dnsZone_id/dns-records/:record_id/propagation", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-zones", ":dnsZone_id", "dns-records", ":record_id", "propagation" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "dnsZone_id", "value": "" }, { "key": "record_id", "value": "" } ] } } }, { "name": "List DNS templates", "request": { "method": "GET", "description": "The built-in DNS templates followed by your organization’s custom templates, each with its records, plus the TTL values a template can use.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-templates", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-templates" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Preview applying a template", "request": { "method": "GET", "description": "Shows each of the template’s records for the zone with its status (such as `add`, `overwrite` or `unchanged`), the existing value it would replace and the TTL the zone will actually get. `templateKey` is a built-in template’s slug or a custom template’s id; changes nothing.\n\nScope: `dns.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-templates/:templateKey/preview/:zone_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-templates", ":templateKey", "preview", ":zone_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "templateKey", "value": "" }, { "key": "zone_id", "value": "" } ] } } }, { "name": "Apply a template to a zone", "request": { "method": "POST", "description": "Creates or updates the template’s records in the zone and pushes each change to the DNS provider; with `overwrite=false`, records that already exist with the same type and name are left alone. `dry_run=1` returns the changes without making any. A CAA record that would block a certificate’s renewal is refused with 409 unless `confirm_caa_impact` is sent.\n\nScope: `dns.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/dns-templates/:templateKey/apply/:zone_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "dns-templates", ":templateKey", "apply", ":zone_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "templateKey", "value": "" }, { "key": "zone_id", "value": "" } ] } } } ] }, { "name": "Certificates", "description": "TLS certificates InfraNest tracks or issues, and when they expire.", "item": [ { "name": "Preview domains to add from certificates", "request": { "method": "GET", "description": "The domain names your certificates use that InfraNest does not track yet, where each is registered as far as is known, and the certificates that use it. Also says how many more domains your plan allows; nothing is changed.\n\nScope: `domains.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/fixes/domains", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "fixes", "domains" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List certificates", "request": { "method": "GET", "description": "Every TLS certificate in the organization, expired and expiring first, each with its health, findings and who renews it. Narrow it with `domain_id` or `monitoring_check_id`; the list is not paginated.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get certificate coverage per domain", "request": { "method": "GET", "description": "For each of your domains, whether a certificate covers it (`covered`, `expiring`, `expired` or `uncovered`) and the best certificate that does. Superseded and dismissed certificates are left out.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/coverage", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "coverage" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List certificate findings", "request": { "method": "GET", "description": "Everything InfraNest found about your certificates that may need attention, from problems to recommendations, with counts per tier.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/findings", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "findings" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get the certificate overview", "request": { "method": "GET", "description": "An address-by-address view of the certificates your visitors actually receive, grouped by domain, with a summary, what needs you, the renewals due in the next 90 days and recommendations. Also lists the members who can be made a certificate’s owner.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/overview", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "overview" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Assign an owner to certificates", "request": { "method": "POST", "description": "Makes the member given in `user_id` the owner of each certificate in `certificate_ids` (up to 200). Refused when that person is not a member of the organization.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/owner", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "owner" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"certificate_ids\": [\n 1\n ],\n \"user_id\": 1\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Preview monitors to add for certificates", "request": { "method": "GET", "description": "The addresses InfraNest suggests watching with an SSL monitor, the monitor each would get and the certificates involved. Also says how many more monitors your plan allows; nothing is changed.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/fixes/monitors", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "fixes", "monitors" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List certificate fixes already applied", "request": { "method": "GET", "description": "The certificate recommendations already acted on, newest first: monitors and domains added from a recommendation and CAA records added to unblock a renewal, with who did it and when.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/fixes/done", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", "fixes", "done" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a certificate", "request": { "method": "GET", "description": "One certificate with its domain, server, monitor, owner and tags, where it is served and its place in the renewal series. Also includes its findings and whether its files can be fetched from the provider.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] } } }, { "name": "Update a certificate", "request": { "method": "PATCH", "description": "Changes InfraNest’s record of the certificate: owner, notes, subscription end date, seller, tags and any corrections to how it is classified (purpose, trust, validation, managed, renewal type). Only the fields you send change; `owner_user_id` must be a member of the organization.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"owner\": \"Platform team\",\n \"notes\": \"Renewed automatically by the load balancer.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get a certificate’s files from the provider", "request": { "method": "GET", "description": "Asks the provider the certificate came from for its files and returns the files; each fetch is recorded in your audit log. Requires write access, and is refused when the certificate did not come from a connected provider that can hand files back or is not linked to a domain.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id/bundle", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id", "bundle" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] } } }, { "name": "Get a certificate’s timeline", "request": { "method": "GET", "description": "The certificate’s history across its renewals: when it was issued, renewed and expired, plus the changes recorded in your audit log. For certificates you renew and pay for yourself, it also marks the day to order the renewal and when the subscription ends.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id/timeline", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id", "timeline" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] } } }, { "name": "Set a certificate’s price", "request": { "method": "PUT", "description": "Sets the yearly price InfraNest counts for this certificate, with optional currency and billing interval. Send an empty price to go back to the provider’s figure.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id/pricing", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id", "pricing" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"price_yearly\": 59,\n \"currency\": \"EUR\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Dismiss or restore a certificate", "request": { "method": "POST", "description": "Sets the certificate aside so it no longer counts towards domain coverage. Send `dismissed: false` to restore it.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id/dismiss", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id", "dismiss" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] } } }, { "name": "Preview the CAA fix for a certificate", "request": { "method": "GET", "description": "The exact CAA record that would let this certificate’s authority issue it again, the DNS zone it would go in, the CAA records already there and any other certificate it would block. Refused when the certificate’s CAA policy does not block its renewal; nothing is changed.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/certificates/:sslCertificate_id/caa-fix", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "certificates", ":sslCertificate_id", "caa-fix" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "sslCertificate_id", "value": "" } ] } } } ] }, { "name": "Servers and cloud", "description": "Servers, volumes, networks, firewalls and load balancers. Provider actions stay in the app; tokens edit InfraNest's own records and alerting.", "item": [ { "name": "List servers", "request": { "method": "GET", "description": "Every server InfraNest tracks in the organization, a page at a time, with its provider, status, addresses and tags. Filter with `search`, `status`, `running`, `datacenter`, `tag`, `credential`, `provider` or `tracking=untracked`, and sort with `sort` and `dir`; self-managed machines are counted in `meta` but not listed.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a server", "request": { "method": "GET", "description": "One server with its volumes, tags, cost breakdown and what its provider lets InfraNest do with it. Also says whether it can be renamed and whether its monitoring agent’s readings are being refused.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Update a server", "request": { "method": "PUT", "description": "Changes a server’s name, city, country or tags; only the fields you send change. A new name is sent to the cloud provider first and refused when the provider cannot rename servers, while the provider’s own facts (addresses, type, status) can only be edited on a self-managed server.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"office-nas-01\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Stop tracking a server", "request": { "method": "POST", "description": "Hides the server from every list, cost and alert in InfraNest without touching it at the provider, where it keeps running. It no longer counts towards your plan, and tracking it again restores its history.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/untrack", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "untrack" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Get what refers to a server’s addresses", "request": { "method": "GET", "description": "The DNS records, firewall rules and monitors that name this server’s IPv4 or IPv6 address, with a total. Also lists the other servers a DNS record could be moved to, which is useful before deleting the server.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/address-references", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "address-references" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Set a server’s price", "request": { "method": "PUT", "description": "Sets a manual price for the server in InfraNest, with optional currency and billing interval. A manual price is no longer overwritten by the provider’s price at each sync; nothing changes at the provider.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/pricing", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "pricing" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"price_monthly\": 7.9,\n \"currency\": \"EUR\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Reset a server’s price", "request": { "method": "POST", "description": "Drops the manual price and goes back to the price last synced from the provider. Returns the server with its updated cost breakdown.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/reset-pricing", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "reset-pricing" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Set a server’s backup price", "request": { "method": "PUT", "description": "Overrides the monthly backup cost InfraNest counts for this server with `backup_price_monthly`, net of tax. Send `null` to go back to the provider’s price; the server’s base price is not affected.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/backup-pricing", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "backup-pricing" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"backup_price_monthly\": 1.58\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get a server’s provider metrics", "request": { "method": "GET", "description": "CPU, disk and network figures asked live from the cloud provider. Pick the figures with `types` (default `cpu,disk,network`) and set the window with `start`, `end` and `step` in seconds (default: the last hour at 60 seconds); refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/metrics", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "metrics" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List a server’s provider actions", "request": { "method": "GET", "description": "The recent actions the cloud provider reports for this server, asked live. Empty when the provider account’s access does not cover it; refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/provider-actions", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "provider-actions" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Get a server’s own firewall", "request": { "method": "GET", "description": "The firewall attached to this server, read live from the cloud provider. Refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/firewall", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "firewall" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List a server’s backups", "request": { "method": "GET", "description": "The backups the cloud provider holds for this server, asked live. Empty when the provider account’s access does not cover it; refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/backups", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "backups" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List a server’s add-ons", "request": { "method": "GET", "description": "The add-ons the cloud provider reports for this server, asked live. Empty when the provider account’s access does not cover it; refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/addons", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "addons" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List images available to a server", "request": { "method": "GET", "description": "The operating system images the cloud provider offers for this server, under `images`. Empty when the provider account’s access does not cover the catalogue; refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/images", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "images" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List ISOs available to a server", "request": { "method": "GET", "description": "The ISO images the cloud provider offers for this server’s type, under `isos`. Refused when the server has no linked provider account.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/isos", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "isos" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Track a server again", "request": { "method": "POST", "description": "Brings an untracked server back into lists, costs and alerts, with its history, tags and alert rules intact. It counts towards your plan again, so it is refused when you have reached your server limit.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:serverId/retrack", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":serverId", "retrack" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "serverId", "value": "" } ] } } }, { "name": "List volumes", "request": { "method": "GET", "description": "Every storage volume InfraNest tracks in the organization, a page at a time, with the server it is attached to. Filter with `search`, `attached`, `unattached`, `server_id`, `status`, `tag` or `credential`, and sort with `sort` and `dir`.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-volumes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-volumes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a volume", "request": { "method": "GET", "description": "One volume with its server, tags, what its provider allows and the provider’s size limits where known.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-volumes/:cloudVolume_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-volumes", ":cloudVolume_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudVolume_id", "value": "" } ] } } }, { "name": "List firewalls", "request": { "method": "GET", "description": "Every cloud firewall InfraNest tracks in the organization, a page at a time (`per_page`, default 20), ordered by account and name. Each includes the entries a Dynamic IP keeps up to date in it.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-firewalls", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-firewalls" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a firewall", "request": { "method": "GET", "description": "One firewall with its rules, tags, Dynamic IP entries, what its provider allows and the protocols it accepts.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-firewalls/:cloudFirewall_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-firewalls", ":cloudFirewall_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudFirewall_id", "value": "" } ] } } }, { "name": "Check a firewall for drift", "request": { "method": "GET", "description": "Compares the firewall’s rules in InfraNest with the rules live at the cloud provider and returns `drifted` with the provider’s rules. When the provider cannot be asked, `drifted` is false and `provider_rules` is null.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-firewalls/:cloudFirewall_id/drift", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-firewalls", ":cloudFirewall_id", "drift" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudFirewall_id", "value": "" } ] } } }, { "name": "List firewall templates", "request": { "method": "GET", "description": "The built-in firewall templates and the custom templates your organization has saved, with their rules.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/firewall-templates", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "firewall-templates" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Preview a firewall template", "request": { "method": "GET", "description": "The rules a template would add to the given firewall, alongside how many rules the firewall has now. `templateKey` is a built-in template’s slug or a custom template’s id; nothing is changed.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/firewall-templates/:templateKey/preview/:cloudFirewall_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "firewall-templates", ":templateKey", "preview", ":cloudFirewall_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "templateKey", "value": "" }, { "key": "cloudFirewall_id", "value": "" } ] } } }, { "name": "List load balancers", "request": { "method": "GET", "description": "Every load balancer InfraNest tracks in the organization, a page at a time. Filter with `search`, `running`, `status`, `datacenter`, `tag` or `credential`, and sort with `sort` and `dir`.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-load-balancers", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-load-balancers" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a load balancer", "request": { "method": "GET", "description": "One load balancer with its tags and what its provider allows.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-load-balancers/:cloudLoadBalancer_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-load-balancers", ":cloudLoadBalancer_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudLoadBalancer_id", "value": "" } ] } } }, { "name": "List IP addresses", "request": { "method": "GET", "description": "The IP addresses across your cloud accounts, with the server each is attached to. Where a provider cannot list addresses directly, the list is built from your servers and misses unattached addresses; those accounts are named in `server_derived_credentials`.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-primary-ips", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-primary-ips" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List networks", "request": { "method": "GET", "description": "Every private network InfraNest tracks in the organization, ordered by name, with its tags. Not paginated.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-networks", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-networks" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a network", "request": { "method": "GET", "description": "One private network with its tags and what its provider allows.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-networks/:cloudNetwork_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-networks", ":cloudNetwork_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudNetwork_id", "value": "" } ] } } }, { "name": "List snapshots", "request": { "method": "GET", "description": "Every server snapshot InfraNest tracks in the organization, a page at a time, with the server it belongs to. Filter with `server_id`, `status`, `credential` or `search`, and sort with `sort` and `dir`.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-snapshots", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-snapshots" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a snapshot", "request": { "method": "GET", "description": "One snapshot with the server it was taken from.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-snapshots/:cloudSnapshot_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-snapshots", ":cloudSnapshot_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudSnapshot_id", "value": "" } ] } } }, { "name": "List servers with their latest metrics", "request": { "method": "GET", "description": "Every server in the organization with its latest CPU, memory, disk, load and network readings, its alert-rule counts and whether it is breaching, a page at a time. Monitored servers come first; filter with `search`, `credential`, `tag` or `status` (for example `breaching`, `norules`, `notreporting`, `monitored`).\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/metrics-overview", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", "metrics-overview" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a server’s stored metric series", "request": { "method": "GET", "description": "Time series InfraNest has stored for this server, as `[unix seconds, value]` pairs, oldest first, with the alert threshold that applies to each metric. Pick a comma-separated `metrics` list, then either a fixed `range` (`live`, `h1`, `h12`, `h24`, `d7`, `d30`; default `h24`) or your own window with `from` and `to` (ISO 8601) and optionally `resolution`: `raw` for every sample (kept for 48 hours, at most 48 hours per request) or `hour` for hourly averages (at most 92 days per request). Without `resolution`, raw samples are used when they still cover the window. A longer range is refused with `range_too_large`. Points are paged with `page` and `per_page` (up to 10,000, the default); `pagination` says how many points the window holds and `window` the range that was applied.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/metric-series", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "metric-series" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Get a server’s agent snapshot", "request": { "method": "GET", "description": "The latest state the monitoring agent reported from inside the server: disk mounts with forecasts, top processes, watched services, containers and ignored units. Also includes the agent’s own health, version status and whether alerts are currently quiet.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/agent-snapshot", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "agent-snapshot" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Name a container", "request": { "method": "PUT", "description": "Gives one of the server’s reported containers a display name in InfraNest, identified by `container_id`. Returns the server’s full list of saved container names; each server has a cap on saved names.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/container-names", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "container-names" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"container_id\": \"3f2a9c1b7d4e\",\n \"display_name\": \"web\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remove a container name", "request": { "method": "DELETE", "description": "Removes the display name saved for the container given in `container_id`. Returns the server’s remaining saved container names.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/container-names", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "container-names" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"container_id\": \"3f2a9c1b7d4e\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get what needs attention on a server", "request": { "method": "GET", "description": "A short summary of the server: its uptime, whether alerts are quiet and until when, and the metric trend closest to crossing its alert threshold. Fields are null when there is nothing to say.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/attention", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "attention" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Snooze a server’s alerts", "request": { "method": "POST", "description": "Silences the server’s alerts for `minutes` (5 to 1440) by creating a short maintenance window, and returns when it ends. Refused when your plan does not include maintenance windows.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/snooze", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "snooze" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"minutes\": 60\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "End a server’s snooze", "request": { "method": "DELETE", "description": "Ends a snooze before it runs out. Scheduled maintenance windows are left alone, so the response says whether anything was ended and until when alerts are still quiet.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/snooze", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "snooze" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Ignore a failed service", "request": { "method": "POST", "description": "Stops a failed system service, named in `unit`, from raising alerts on this server, without silencing other service failures. Any name is accepted; returns the server’s list of ignored units.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/ignored-units", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "ignored-units" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"unit\": \"snapd.service\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Stop ignoring a failed service", "request": { "method": "DELETE", "description": "Lets the service named in `unit` raise alerts again on this server; if it is still failed, it counts from now. Returns the remaining ignored units.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/ignored-units", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "ignored-units" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"unit\": \"snapd.service\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Turn on monitoring for a server", "request": { "method": "POST", "description": "Starts monitoring the server in InfraNest and returns how many monitored servers your plan allows and uses. Refused when you have reached that limit; repeating it on a monitored server changes nothing.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/monitoring", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "monitoring" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Turn off monitoring for a server", "request": { "method": "DELETE", "description": "Stops monitoring the server and frees its place in your plan’s monitored-server count. The server itself is not affected.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/monitoring", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "monitoring" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Get the latest monitoring agent release", "request": { "method": "GET", "description": "The current release of the InfraNest monitoring agent with its checksums, the install script URLs and the address the agent should report to. The answer is the same for every server.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/agent-release", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "agent-release" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List a server’s agent tokens", "request": { "method": "GET", "description": "The tokens the monitoring agent on this server can report with, newest first, with who created each and when it was last used. The token values themselves are never returned.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/agent-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "agent-tokens" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "List a server’s alert rules", "request": { "method": "GET", "description": "Every alert in the catalogue for this server, each marked as inherited from the organization, overridden here or not configured, plus any older standalone rules. With `active=1` it returns only the rules actually being evaluated, as a flat list.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/alert-rules", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "alert-rules" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] } } }, { "name": "Update a server alert rule", "request": { "method": "PATCH", "description": "Changes the `operator`, `threshold`, `duration_minutes` or `is_active` of one of this server’s rules. Changing the operator or threshold clears any breach the rule was tracking; durations outside the allowed range, or shorter than your plan allows, are refused.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/alert-rules/:alertRule_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "alert-rules", ":alertRule_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" }, { "key": "alertRule_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"threshold\": 85\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Reset or delete a server alert rule", "request": { "method": "DELETE", "description": "Removes the rule from this server. For an override, the organization’s default applies again; an older standalone rule is simply deleted.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/alert-rules/:alertRule_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "alert-rules", ":alertRule_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" }, { "key": "alertRule_id", "value": "" } ] } } }, { "name": "Override an alert rule for a server", "request": { "method": "PUT", "description": "Sets this server’s own version of an organization alert, identified by `default_id` or a catalogue `key`, with any of `operator`, `threshold`, `duration_minutes` and `is_active`. Send `is_active: false` to stop watching it on this server only; anything you leave out is copied from the organization default.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cloud-servers/:cloudServer_id/alert-rule-overrides", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cloud-servers", ":cloudServer_id", "alert-rule-overrides" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "cloudServer_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"key\": \"cpu_percent\",\n \"threshold\": 85\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Track an address again", "request": { "method": "POST", "description": "Brings an untracked address back so it is checked and shown again. Its certificates and monitor were never changed.\n\nScope: `cloud.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/endpoints/:endpointId/retrack", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "endpoints", ":endpointId", "retrack" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "endpointId", "value": "" } ] } } }, { "name": "Get an address’s monitor", "request": { "method": "GET", "description": "What the monitor on this address knows: its status, 30-day uptime, response time, the certificate each probe location receives and where its alerts go. `monitor` is null when nothing watches the address.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/endpoints/:endpoint_id/monitor", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "endpoints", ":endpoint_id", "monitor" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "endpoint_id", "value": "" } ] } } }, { "name": "List connect requests", "request": { "method": "GET", "description": "The 20 most recent links you created to ask someone else to connect a provider account, newest first, with who requested each one. Filter with `provider` or `kind`; the response also gives how many days a new link stays valid.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/connect-requests", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "connect-requests" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Monitoring", "description": "Monitors, their results and uptime, and deploy markers.", "item": [ { "name": "List monitors", "request": { "method": "GET", "description": "A paginated list of your monitors with their type, target, interval, current status, 24-hour uptime and a 24-hour status chart, plus status counts in `meta`. Filter with `search`, `type`, `kind` (`own` or `external`), `status`, `enabled` and `tag`, and sort with `sort` and `dir`; pass `all=true` for a plain unpaginated list of every monitor.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a monitor", "request": { "method": "POST", "description": "Creates a monitor and queues its first check. Pass `external_service_id` instead of a target to watch a third-party status page; a heartbeat monitor gets its own ping URL as its target. Refused when the monitor count, interval, check type or regions are beyond your plan.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Checkout API\",\n \"type\": \"http\",\n \"target\": \"https://example.com/health\",\n \"interval\": 300\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get a monitor", "request": { "method": "GET", "description": "One monitor with its settings, alert channels, tags, dependencies, maintenance windows, the status pages it appears on, its 30 most recent results and the interval it actually runs at under your plan.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Update a monitor", "request": { "method": "PUT", "description": "Changes only the fields you send; keys inside `settings` are merged rather than replaced. Refused when a new interval, check type or set of regions is beyond your plan.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"interval_seconds\": 300\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a monitor", "request": { "method": "DELETE", "description": "Permanently deletes the monitor. A monitor locked because it is over your plan’s limit cannot be deleted this way.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "List a monitor’s check results", "request": { "method": "GET", "description": "The monitor’s check results, newest first. With `resolution=raw` (the default) each result is one check by one probe, filterable by `status`; individual results are kept for 3 days. With `resolution=hour` or `day` each row sums one hour or one day across probes: checks by outcome (`checks_up`, `checks_degraded` for slow checks, `checks_down` for failures), `up_percent` and the p50 and p95 response times, reaching back as far as your plan keeps history. Set the window with `from` and `to` (ISO 8601; default: everything kept for raw, the last 24 hours for hours, the last 30 days for days), narrow it to one probe `region`, and page with `page` and `per_page` (up to 500, default 50). A range longer than the resolution allows — 3 days raw, 31 days by hour, 366 days by day — is refused with `range_too_large`. `window` repeats the range that was applied.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/results", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "results" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Attach an alert channel to a monitor", "request": { "method": "POST", "description": "Sends this monitor’s alerts to the alert channel in `alert_channel_id`, which must belong to your organization. Refused if the channel is already attached.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/alerts", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "alerts" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"alert_channel_id\": 1\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Detach an alert channel from a monitor", "request": { "method": "DELETE", "description": "Stops sending this monitor’s alerts to the channel. A monitor with no channels left keeps running, but no channel receives its alerts.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/alerts/:alertChannel_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "alerts", ":alertChannel_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" }, { "key": "alertChannel_id", "value": "" } ] } } }, { "name": "Run a monitor now", "request": { "method": "POST", "description": "Queues an immediate check of the monitor and answers 202 straight away; the result appears in its results once the check has run. Limited by your plan’s hourly allowance of manual checks.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/run", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "run" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Pause a monitor", "request": { "method": "POST", "description": "Stops the monitor from running until you resume it, and returns the updated monitor.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/pause", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "pause" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Resume a monitor", "request": { "method": "POST", "description": "Starts a paused monitor again, queues a check straight away and returns the updated monitor.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/resume", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "resume" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Copy a monitor", "request": { "method": "POST", "description": "Creates a copy named with “(copy)” appended, with the same settings but no history. The copy starts paused, and counts against your plan like any new monitor.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/clone", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "clone" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Get a monitor’s uptime and response-time stats", "request": { "method": "GET", "description": "Uptime for the last 24 hours, 7 days and 30 days, incident counts, response-time figures and chart series for the chosen `period` (`24h`, `7d` or `30d`, default `24h`). Pass `region` to narrow the figures to one probe region; the regions with data are listed in `regions`.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/stats", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "stats" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Get a monitor’s uptime and response times for a period", "request": { "method": "GET", "description": "Totals for one window: `uptime_percent` (the share of the time no confirmed outage covered, the figure the app shows), `up_percent` (the share of checks that came back up), checks by outcome, p50 and p95 response time in milliseconds, and the number and minutes of unplanned incidents. Pick `period` (`24h`, `7d`, `30d` or `90d`, default `24h`) or set `from` and `to` (ISO 8601, at most 366 days apart; longer is refused with `range_too_large`); the window starts on the hour `from` falls in. Pass `region` for one probe region, where `uptime_percent` is the share of checks that were up. Response times over more than one hour or probe are averaged from hourly figures, weighted by the number of checks, so they are close rather than exact. `uptime_percent` is null when nothing was measured.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/aggregates", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "aggregates" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Get who an outage alert would reach", "request": { "method": "GET", "description": "Whether an outage on this monitor would reach anybody right now: `state` is `ok`, `nobody` or `failing`, with the alert channels it would use, how many members get the status email, and whether it would escalate.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/reach", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "reach" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "List a monitor’s incidents", "request": { "method": "GET", "description": "The monitor’s 20 most recent incidents, newest first, with their status, impact, start and end times and duration.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/incidents", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "incidents" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Edit a monitor incident", "request": { "method": "PATCH", "description": "Changes an incident’s `description`, or marks it as planned with `is_planned`, which takes it out of uptime figures and the status page’s incident history. Incidents imported from a third-party status page cannot be edited.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/incidents/:incident_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "incidents", ":incident_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" }, { "key": "incident_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"description\": \"Caused by an expired upstream certificate.\",\n \"is_planned\": false\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Silence a monitor’s alerts", "request": { "method": "POST", "description": "Mutes the monitor’s alerts for `duration_minutes` (1 to 10,080), or until you unsilence it when you leave that out. The monitor keeps running.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/silence", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "silence" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"duration_minutes\": 60\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Unsilence a monitor’s alerts", "request": { "method": "DELETE", "description": "Lifts a silence straight away so the monitor’s alerts are sent again, and returns the updated monitor.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/silence", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "silence" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "List what an external service affects", "request": { "method": "GET", "description": "For a monitor that watches a third-party status page: the DNS zones, domains, monitors and servers of yours that depend on that service. Each has a `source` of `manual` (linked by you) or `auto` (zones and domains at the matching provider, detected by InfraNest).\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/affected", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "affected" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Link a resource to an external service", "request": { "method": "POST", "description": "Records that one of your resources, given by `resource_type` and `resource_id`, depends on the third-party service this monitor watches. Only works on monitors that watch a third-party status page.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/affected", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "affected" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Unlink a resource from an external service", "request": { "method": "DELETE", "description": "Removes a resource you linked to the third-party service this monitor watches. Automatically detected links cannot be removed this way.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/affected/:type/:resourceId", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "affected", ":type", ":resourceId" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" }, { "key": "type", "value": "" }, { "key": "resourceId", "value": "" } ] } } }, { "name": "Get the monthly uptime report", "request": { "method": "GET", "description": "Uptime per monitor for one calendar month, with downtime, incidents, longest outage and the basis of each figure. Pass `month` as `YYYY-MM` (default: the last full month) and `tag` to limit it to monitors with that tag.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/uptime-report", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "uptime-report" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get the current status of everything", "request": { "method": "GET", "description": "Everything in your organization as it stands right now, in one call: every monitor with its `status` (`up`, `down`, `degraded`, `paused` or `unknown`), when it was last checked and its 24-hour uptime; every server with its state, whether its agent is reporting (null when no agent is installed) and how many of its alert rules are breaching; the open incidents; the maintenance windows running now; and counts of each in `summary`. Pass `tag` (a tag ID) to narrow it to monitors and servers with that tag, their incidents, and maintenance that carries the tag or covers them. `servers` is null when the token has no Cloud scope or your role cannot see servers.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Download the monthly uptime report as CSV", "request": { "method": "GET", "description": "The same report as a CSV file, one row per monitor. Takes the same `month` and `tag` parameters, and every download is recorded in your audit log.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/uptime-report/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "uptime-report", "export" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List active probe regions", "request": { "method": "GET", "description": "The regions that currently have at least one active probe, as a sorted list of region names. Use these values when choosing where a monitor runs.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/monitoring/active-regions", "host": [ "{{baseUrl}}" ], "path": [ "api", "monitoring", "active-regions" ], "variable": [] } } }, { "name": "List external services", "request": { "method": "GET", "description": "The third-party services you can watch: the curated catalogue plus any you added yourself. Each comes with its status page address, overall status, components and when it was last polled.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/external-services", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "external-services" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Preview email DNS monitors for a domain", "request": { "method": "GET", "description": "Looks up the MX, SPF and DMARC records the domain in `domain` publishes and returns the DNS monitors that would watch those records. Nothing is created; `resolved` is false when the lookup failed.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/email-dns-monitors", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "email-dns-monitors" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create email DNS monitors for a domain", "request": { "method": "POST", "description": "Creates one DNS monitor for each MX, SPF and DMARC record the domain in `domain` publishes right now, and queues a first check of each. Either every monitor is created or none is: the request is refused when the domain publishes none of those records or the monitors would exceed your plan.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/email-dns-monitors", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "email-dns-monitors" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List a monitor’s dependencies", "request": { "method": "GET", "description": "The monitors this one depends on (`parents`) and the monitors that depend on it (`children`), each with its name, type, target and current status.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/dependencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "dependencies" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] } } }, { "name": "Add a monitor dependency", "request": { "method": "POST", "description": "Pass `parent_check_id` to make this monitor depend on another, or `child_check_id` to make another depend on it. Both monitors must be yours, and a dependency on itself or one that would form a loop is refused.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/dependencies", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "dependencies" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"child_check_id\": 3\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remove a monitor dependency", "request": { "method": "DELETE", "description": "Removes the dependency between the two monitors, in whichever direction it runs.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/monitoring-checks/:monitoringCheck_id/dependencies/:otherCheck_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "monitoring-checks", ":monitoringCheck_id", "dependencies", ":otherCheck_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "monitoringCheck_id", "value": "" }, { "key": "otherCheck_id", "value": "" } ] } } }, { "name": "List deploy links", "request": { "method": "GET", "description": "Your links between a repository and a monitor, server or tag, each with its newest deploy. Pass `monitor` to list only that monitor’s own links; `deploys_connected` says whether anything can report deploys to your organization.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-links", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-links" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a deploy link", "request": { "method": "POST", "description": "Links deploys of a `repository` to a monitor, server or tag (`target_type` and `target_id`). `kind` chooses what counts as a deploy: `deployment` (optionally for one `environment`), `workflow` (a `workflow` file, optionally on one `branch`) or `release`; earlier deploys are imported in the background.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-links", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-links" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"repository\": \"northwind-cloud/app\",\n \"target_type\": \"server\",\n \"target_id\": 1\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List deploy link targets", "request": { "method": "GET", "description": "The monitors, servers and tags a deploy link can point at, by ID and name.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-links/targets", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-links", "targets" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Check whether a repository has deploys", "request": { "method": "GET", "description": "Whether GitHub has any deployment for `repository`, so you can tell before linking one that never deploys. `has_deployments` is null when GitHub could not be asked.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-links/check", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-links", "check" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Delete a deploy link", "request": { "method": "DELETE", "description": "Removes the link, so its deploys no longer appear on that monitor, server or tag.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-links/:deployLink_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-links", ":deployLink_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "deployLink_id", "value": "" } ] } } }, { "name": "List deploys for a monitor or server", "request": { "method": "GET", "description": "The deploys linked to one monitor (`monitor`) or server (`server`) between `from` and `to`; the window defaults to the 24 hours before `to`, which defaults to now. Also lists the repositories linked to it.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-events", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-events" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List repositories that have deployed", "request": { "method": "GET", "description": "Each repository and environment that has already reported a deploy to your organization, up to 500.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-events/sources", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-events", "sources" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get what a deploy changed", "request": { "method": "GET", "description": "The commits and pull requests since the previous successful deploy to the same place. Returns `first: true` when there is no earlier deploy to compare with, and `unavailable: true` when GitHub could not say.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-events/:deployEvent_id/changes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-events", ":deployEvent_id", "changes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "deployEvent_id", "value": "" } ] } } }, { "name": "List deploy tokens", "request": { "method": "GET", "description": "Your deploy tokens, newest first, with their name, creator, the monitors each token applies to, whether a signature is required and when each token was last used. Token secrets are never returned.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/deploy-tokens", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "deploy-tokens" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get your attention summary preview", "request": { "method": "GET", "description": "When your next “needs you” summary for this organization is due, how it is delivered, and a preview of up to 10 items it would contain. `receives` is false when you have turned the summary off, and `available` is false when it cannot be put together right now.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/attention-summary", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "attention-summary" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Incidents", "description": "Incidents: open, update and resolve them.", "item": [ { "name": "List incidents", "request": { "method": "GET", "description": "A paginated list of your monitors’ incidents with their monitor, status, impact, latest update and who acknowledged each one, plus counts in `meta`. `period` is `24h`, `7d` (default), `30d` or `all`; filter with `status` (`open`, `acked` or `resolved`) and `search`, or pass `incident` to fetch a single incident whatever its age.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Update an incident", "request": { "method": "PATCH", "description": "Changes an incident’s `title`, `status`, `impact`, `description` or `is_planned`. Setting `status` to `resolved` resolves an open incident, and any other status reopens a resolved one; incidents imported from a third-party status page cannot be edited.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents/:incident_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents", ":incident_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "incident_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"status\": \"identified\",\n \"impact\": \"major\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Get an incident’s timeline", "request": { "method": "GET", "description": "The incident’s public status updates and internal team notes, plus the alert channels that were notified, deploys shortly before it began, who PagerDuty is paging, notes from PagerDuty and tickets opened for it.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents/:incident_id/updates", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents", ":incident_id", "updates" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "incident_id", "value": "" } ] } } }, { "name": "Post an incident update", "request": { "method": "POST", "description": "Posts a public status update with a `status` and `message`, and moves the incident to that status (`resolved` resolves it). Status page subscribers are notified unless you send `notify_subscribers: false`; incidents imported from a third-party status page cannot be updated.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents/:incident_id/updates", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents", ":incident_id", "updates" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "incident_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"status\": \"monitoring\",\n \"message\": \"A fix is out; we are watching checkout recover.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Acknowledge an incident", "request": { "method": "POST", "description": "Marks the incident as acknowledged by you, so your team knows someone is on it, and returns it with who acknowledged it.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents/:incident_id/acknowledge", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents", ":incident_id", "acknowledge" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "incident_id", "value": "" } ] } } }, { "name": "Remove an incident acknowledgement", "request": { "method": "POST", "description": "Clears the acknowledgement so the incident reads as unhandled again.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents/:incident_id/unacknowledge", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents", ":incident_id", "unacknowledge" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "incident_id", "value": "" } ] } } }, { "name": "Add a team note to an incident", "request": { "method": "POST", "description": "Adds an internal note in `body` for your team. Notes never appear on a status page.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/incidents/:incident_id/notes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "incidents", ":incident_id", "notes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "incident_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"body\": \"Rolled back release 2026.01.15 — error rate back to normal.\"\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Maintenance", "description": "Planned maintenance windows, which pause alerts and show on status pages.", "item": [ { "name": "Update a maintenance window", "request": { "method": "PATCH", "description": "Changes the fields you send. Sending `check_ids` or `server_ids` replaces what the window covers, and an empty list clears it.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/maintenance-windows/:maintenanceWindow_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "maintenance-windows", ":maintenanceWindow_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "maintenanceWindow_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"description\": \"Primary database moves to PostgreSQL 17. Expect two minutes of read-only mode.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a maintenance window", "request": { "method": "DELETE", "description": "Permanently deletes the maintenance window.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/maintenance-windows/:maintenanceWindow_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "maintenance-windows", ":maintenanceWindow_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "maintenanceWindow_id", "value": "" } ] } } }, { "name": "Mark a maintenance window as verifying", "request": { "method": "PATCH", "description": "Moves a window that is in progress to `verifying`, while you check that everything works again. Refused for a window in any other state.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/maintenance-windows/:maintenanceWindow_id/verifying", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "maintenance-windows", ":maintenanceWindow_id", "verifying" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "maintenanceWindow_id", "value": "" } ] } } }, { "name": "Complete a maintenance window", "request": { "method": "PATCH", "description": "Marks a window that is in progress or verifying as completed. Refused for a window in any other state.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/maintenance-windows/:maintenanceWindow_id/complete", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "maintenance-windows", ":maintenanceWindow_id", "complete" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "maintenanceWindow_id", "value": "" } ] } } }, { "name": "List maintenance windows", "request": { "method": "GET", "description": "A paginated list of your maintenance windows with the monitors, servers and tags each window covers, whether each window is in effect and its current or next occurrence, plus counts in `meta`. Filter with `search`, `tag` and `status` (`active`, `scheduled`, `recurring` or `completed`), and sort with `sort` (`schedule`, `name`, `monitors` or `status`) and `dir`.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/maintenance-windows", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "maintenance-windows" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a maintenance window", "request": { "method": "POST", "description": "Schedules maintenance for the monitors in `check_ids` and servers in `server_ids`; a window with no monitors applies to every monitor. A one-time window needs `starts_at` and `ends_at`, a `daily` or `weekly` one needs `start_time` and `duration_minutes`, and alerts are suppressed during it unless `suppress_alerts` is false. Subscribers of the affected status pages are told about the new window.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/maintenance-windows", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "maintenance-windows" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Load balancer upgrade\",\n \"starts_at\": \"2026-01-17T22:00:00Z\",\n \"ends_at\": \"2026-01-17T23:00:00Z\",\n \"suppress_alerts\": true,\n \"check_ids\": [\n 1\n ]\n}", "options": { "raw": { "language": "json" } } } } } ] }, { "name": "Status pages", "description": "Public status pages and what they show.", "item": [ { "name": "List status pages", "request": { "method": "GET", "description": "Every status page in your organization with its component and subscriber counts, how many components are operational or degraded, which are down, and the page’s 90-day uptime.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a status page", "request": { "method": "GET", "description": "One status page with its settings, its components with the monitor and group behind each, and counts of components, announcements and subscribers.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Get the internal view of a status page", "request": { "method": "GET", "description": "The team-only view of the page: each component with its monitor, runbook link, regions reporting and 30 days of uptime, plus active incidents, the next maintenance and the on-call note. These internal fields are never shown on the public page, and this view needs a plan that includes private status pages.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/internal", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "internal" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Get a status page overview", "request": { "method": "GET", "description": "The page at a glance: setup (components, custom domain, subscribers, whether it is public), uptime over the page’s history window, current status with active incidents, and the next maintenance and announcement due to end.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/overview", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "overview" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Get status page traffic", "request": { "method": "GET", "description": "Views, unique visitors and subscribe clicks over the last `days` (7, 30 or 90; default 30), compared with the period before, with the busiest day and a daily series. Counts only; no individual visits are recorded.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/analytics", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "analytics" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "List status page components", "request": { "method": "GET", "description": "The page’s components in display order, each with its group, linked monitor and uptime bars over the page’s history window. A component with no monitor has no bars.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/components", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "components" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Add a component to a status page", "request": { "method": "POST", "description": "Adds a component with a `display_name`, optionally linked to one of your monitors with `monitoring_check_id`. A `group_name` that does not exist yet creates that group, and a `runbook_url` must start with https:// and is only shown internally.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/components", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "components" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"display_name\": \"Payments API\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Add several monitors to a status page", "request": { "method": "POST", "description": "Adds a component for each of up to 50 monitors in `monitoring_check_ids`, named after the monitor and optionally placed in `group_name`. Monitors already on the page are skipped and listed in `skipped`; third-party monitors are added ungrouped and do not affect the page’s overall status.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/components/bulk", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "components", "bulk" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"monitoring_check_ids\": [\n 1,\n 2,\n 3\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update a status page component", "request": { "method": "PATCH", "description": "Changes the fields you send, such as the name, description, linked monitor, status override, group or runbook link. A new `group_name` creates that group.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/components/:component_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "components", ":component_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" }, { "key": "component_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"display_name\": \"Checkout\",\n \"description\": \"Payments and order confirmation\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Remove a component from a status page", "request": { "method": "DELETE", "description": "Deletes the component from the page. The monitor behind it is not affected.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/components/:component_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "components", ":component_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" }, { "key": "component_id", "value": "" } ] } } }, { "name": "Reorder status page components", "request": { "method": "POST", "description": "Sets the display order from `order`, a list of component IDs. Every ID must belong to this page.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/components/sort", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "components", "sort" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"order\": [\n 8,\n 7,\n 6,\n 5,\n 4,\n 3,\n 2,\n 1\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List status page groups", "request": { "method": "GET", "description": "The page’s component groups in display order, each with how many components it holds.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/component-groups", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "component-groups" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Create a status page group", "request": { "method": "POST", "description": "Adds a group with a `name` at the end of the page. Names must be unique within the page.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/component-groups", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "component-groups" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Customer apps\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Reorder status page groups", "request": { "method": "POST", "description": "Sets the display order from `order`, a list of group IDs. Every ID must belong to this page.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/component-groups/sort", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "component-groups", "sort" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"order\": [\n 2,\n 1\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update a status page group", "request": { "method": "PATCH", "description": "Renames the group for every component in it. Setting `shows_platform_status` to true on one group clears it from every other group on the page.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/component-groups/:componentGroup_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "component-groups", ":componentGroup_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" }, { "key": "componentGroup_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Customer-facing apps\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a status page group", "request": { "method": "DELETE", "description": "Removes the group but keeps its components, which become ungrouped. The response says how many were ungrouped.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/component-groups/:componentGroup_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "component-groups", ":componentGroup_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" }, { "key": "componentGroup_id", "value": "" } ] } } }, { "name": "List status page announcements", "request": { "method": "GET", "description": "The announcements you posted on this page, newest first, including ones scheduled for later or no longer shown.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/announcements", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "announcements" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Post a status page announcement", "request": { "method": "POST", "description": "Publishes a notice with a `title` and `body` on the public page. `kind` is `information` or `warning`, and `show_from` and `show_until` limit when it is shown.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/announcements", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "announcements" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"title\": \"New status page address\",\n \"body\": \"This page now also answers at status.northwind.example.\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List incidents and maintenance on a status page", "request": { "method": "GET", "description": "The incidents and maintenance windows that appear on this page automatically from its monitors, from the last 90 days or still open. Read-only; edit each one on the incident or maintenance window itself.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/other-notices", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "other-notices" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Update a status page announcement", "request": { "method": "PATCH", "description": "Changes the announcement’s title, body, kind or display window.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/announcements/:announcement_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "announcements", ":announcement_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" }, { "key": "announcement_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"title\": \"Status page has moved\",\n \"kind\": \"information\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a status page announcement", "request": { "method": "DELETE", "description": "Removes the announcement from the page permanently.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/announcements/:announcement_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "announcements", ":announcement_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" }, { "key": "announcement_id", "value": "" } ] } } }, { "name": "Get status page subscriber counts", "request": { "method": "GET", "description": "How many people subscribe to the page, how many have confirmed or are pending, a count per channel, and a 90-day growth curve. Counts only; use the subscriber list for individual entries.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/subscribers", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "subscribers" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "List status page subscribers", "request": { "method": "GET", "description": "The page’s subscribers, newest first, with their channel, label, confirmation date and whether delivery is failing. Filter with `q` (searches email addresses) and `status` (`confirmed` or `pending`), and page with `per_page` (10 to 100); reading the list is recorded in your audit log, and webhook addresses are never shown in full.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/subscribers/list", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "subscribers", "list" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } }, { "name": "Get custom domain CNAME setup", "request": { "method": "GET", "description": "Whether the page’s custom domain, or the one in `domain`, sits in a DNS zone you manage in InfraNest, whether InfraNest can create the CNAME record there for you, and whether it is already published. Includes the CNAME target to point the domain at.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/status-pages/:statusPage_id/cname-setup", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "status-pages", ":statusPage_id", "cname-setup" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "statusPage_id", "value": "" } ] } } } ] }, { "name": "Alerts and notifications", "description": "Alert channels, alert rules and notification settings. Read only: changing who gets alerted stays in the app.", "item": [ { "name": "List alert destinations", "request": { "method": "GET", "description": "Every place the organization sends alerts, such as email, Slack or Telegram, with how many checks use each and how many alerts it missed while it refused messages. Pass `personal=1` for only your own personal destinations.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/alert-channels", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "alert-channels" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get an alert destination", "request": { "method": "GET", "description": "One alert destination with the checks that send to it.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/alert-channels/:alertChannel_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "alert-channels", ":alertChannel_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "alertChannel_id", "value": "" } ] } } } ] }, { "name": "Automations", "description": "Automations and the connections they use. Read only.", "item": [ { "name": "List automations", "request": { "method": "GET", "description": "Every automation, newest first, with its tags and run statistics: runs in the last 30 and 7 days, success rate, average duration and the last run’s status. Test runs are not counted.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/automations", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "automations" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get an automation", "request": { "method": "GET", "description": "One automation with its trigger, conditions, actions and tags, plus its 20 most recent runs and their steps.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/automations/:automationRule_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "automations", ":automationRule_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "automationRule_id", "value": "" } ] } } }, { "name": "List an automation’s runs", "request": { "method": "GET", "description": "The automation’s run history with each run’s steps, newest first, 25 per page. Filter with `status` and the dates `from` and `to`. Unless you may edit automations, what triggered each run is left out and `details_hidden` is true.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/automations/:automationRule_id/runs", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "automations", ":automationRule_id", "runs" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "automationRule_id", "value": "" } ] } } }, { "name": "List automation connections", "request": { "method": "GET", "description": "The accounts automations can act through, such as GitHub, Jira or PagerDuty, with each one’s status, whether it is paused and whether its triggers can fire.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/automation-connections", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "automation-connections" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Integrations", "description": "Connected providers and messaging apps. Read only: credentials are managed in the app.", "item": [ { "name": "List provider accounts", "request": { "method": "GET", "description": "Every connected cloud, DNS, registrar and certificate account, with its health and how many zones, domains, certificates and servers it holds.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/provider-credentials", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "provider-credentials" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get provider account health", "request": { "method": "GET", "description": "How many enabled provider accounts there are (`total`) and how many are currently degraded or down (`unhealthy`).\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/provider-credentials/health", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "provider-credentials", "health" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a provider account", "request": { "method": "GET", "description": "One connected provider account with its health, how many zones, domains, certificates and servers it holds, the registrar operations it supports and the result of its last permission check. Secrets are never returned.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/provider-credentials/:providerCredential_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "provider-credentials", ":providerCredential_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "providerCredential_id", "value": "" } ] } } }, { "name": "List a provider account’s call log", "request": { "method": "GET", "description": "The most recent 200 calls InfraNest made with this account, newest first. Filter with `status` (`success` or `failure`) and the dates `from` and `to`.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/provider-credentials/:providerCredential_id/logs", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "provider-credentials", ":providerCredential_id", "logs" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "providerCredential_id", "value": "" } ] } } }, { "name": "List connected integrations", "request": { "method": "GET", "description": "Everything the organization has connected — cloud, DNS, registrar and certificate accounts, alert destinations, outbound webhooks, automation connections and calendars — each with its status and health. Also returns summary counts and the integrations your plan does not include (`locks`).\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/integrations", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "integrations" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Export integration activity as CSV", "request": { "method": "GET", "description": "Downloads every call logged for this integration as a CSV file, newest first. Takes the same `status`, `capability`, `direction`, `credential_id` and `search` filters as the activity list.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/integrations/:provider/activity/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "integrations", ":provider", "activity", "export" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "provider", "value": "" } ] } } }, { "name": "List integration activity", "request": { "method": "GET", "description": "The calls made to and received from this integration, newest first, paginated with `per_page` (5 to 100, default 20). Filter with `status` (`success` or `error`), `capability`, `direction`, `credential_id` and `search`; `meta` lists the accounts and filter values available.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/integrations/:provider/activity", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "integrations", ":provider", "activity" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "provider", "value": "" } ] } } }, { "name": "Get an integration account", "request": { "method": "GET", "description": "One connected account of an integration, whatever kind it is, with its status and health. Returns 404 when the account does not exist or does not belong to this integration and organization.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/integrations/:provider/accounts/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "integrations", ":provider", "accounts", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "provider", "value": "" }, { "key": "id", "value": "" } ] } } }, { "name": "Get an integration", "request": { "method": "GET", "description": "What the integration offers, the organization’s connections to it, and whether your plan allows connecting it. Returns 404 for an unknown integration.\n\nScope: `cloud.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/integrations/:provider", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "integrations", ":provider" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "provider", "value": "" } ] } } }, { "name": "Get the outbound webhook JSON Schema", "request": { "method": "GET", "description": "The JSON Schema of the payload InfraNest sends to your webhook endpoints, for tools that type a payload from a schema. Narrow it with `events[]`; with none, it covers every event. `events` lists every event you can name.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/webhook-endpoints/schema", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "webhook-endpoints", "schema" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Drop catch", "description": "Watched domains.", "item": [ { "name": "List registrars available for catching", "request": { "method": "GET", "description": "The connected registrar accounts that can register a caught domain, by name, and whether each may race for it. Makes no calls to the registrars.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/registrars/identities", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", "registrars", "identities" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List registrars for an extension", "request": { "method": "GET", "description": "The connected registrar accounts that can register a caught domain. With `tld`, each says whether it carries that extension and what it charges, and `requirements` lists what the extension asks of a registrant, or null when nothing is on file.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/registrars", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", "registrars" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Check whether you already hold a domain", "request": { "method": "GET", "description": "The domain in your organization matching `name` and `tld` (both required) that you hold or are registering, or null when there is none.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/held", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", "held" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List watched domains", "request": { "method": "GET", "description": "Your watched domains, paginated with `per_page` (default 25, at most 200) and sorted with `sort` and `dir`. Filter with `search`, `tag` and flags such as `active`, `available`, `registered`, `failed`, `paused` and `in_auction`; `meta` carries counts per status.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a watched domain", "request": { "method": "GET", "description": "One watched domain with its stored WHOIS record, lifecycle dates, estimated drop date, the check schedule still ahead and drop statistics for its extension.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/:watchedDomain_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", ":watchedDomain_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "watchedDomain_id", "value": "" } ] } } }, { "name": "List availability checks", "request": { "method": "GET", "description": "Every availability check run on the watched domain, newest first, 100 per page. Filter with `status`.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/:watchedDomain_id/check-logs", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", ":watchedDomain_id", "check-logs" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "watchedDomain_id", "value": "" } ] } } }, { "name": "List registration attempts", "request": { "method": "GET", "description": "Every attempt to register the watched domain, newest first, 50 per page.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/:watchedDomain_id/registration-logs", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", ":watchedDomain_id", "registration-logs" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "watchedDomain_id", "value": "" } ] } } }, { "name": "List WHOIS changes", "request": { "method": "GET", "description": "Changes detected in the watched domain’s WHOIS record, newest first, 50 per page.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/watched-domains/:watchedDomain_id/whois-changes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "watched-domains", ":watchedDomain_id", "whois-changes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "watchedDomain_id", "value": "" } ] } } }, { "name": "List custom WHOIS servers", "request": { "method": "GET", "description": "The WHOIS servers you set per extension to use instead of the default ones, sorted by extension.\n\nScope: `drop-catch.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/whois-servers", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "whois-servers" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Organization and members", "description": "The organizations a token can reach, their members, roles, single sign-on and dashboards. Read only.", "item": [ { "name": "List your organizations", "request": { "method": "GET", "description": "Every organization you are a member of, with your role and its member count. An organization that requires its own single sign-on, which this session has not used, is listed by name only.\n\nScope: `members.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations" ], "variable": [] } } }, { "name": "Get an organization", "request": { "method": "GET", "description": "The organization’s settings, with the name and email address of each member.\n\nScope: `members.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":id" ], "variable": [ { "key": "id", "value": "" } ] } } }, { "name": "List members", "request": { "method": "GET", "description": "Every member of the organization with their role. `email_undeliverable` is true when email to that address can no longer be delivered.\n\nScope: `members.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/members", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "members" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List pending invitations", "request": { "method": "GET", "description": "Invitations that have not been accepted yet, with who sent each one and the role it grants.\n\nScope: `members.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/invitations", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "invitations" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List roles", "request": { "method": "GET", "description": "The built-in roles followed by the organization’s custom roles, each with its permissions.\n\nScope: `members.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/roles", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "roles" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get a role", "request": { "method": "GET", "description": "One role and its permissions. Either a built-in role or one of this organization’s custom roles.\n\nScope: `members.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/roles/:id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "roles", ":id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "id", "value": "" } ] } } }, { "name": "Reset a sandbox", "request": { "method": "POST", "description": "Removes everything in your sandbox organization and restores its sample zones, records, monitors, server and tags. Works only on a sandbox, with its own test token or from the app; any other organization answers 404.", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/sandbox/reset", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "sandbox", "reset" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Tags and custom fields", "description": "Tags and custom fields, which work across every module.", "item": [ { "name": "List custom fields", "request": { "method": "GET", "description": "The organization’s custom field definitions in display order. Pass `entity_type` to list only the fields that apply to that kind of record.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/custom-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "custom-fields" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a custom field", "request": { "method": "POST", "description": "Defines a custom field with `entity_types`, a unique `key`, a `label` and a `type`; select and multi-select fields also need `options`. Requires a plan that includes custom fields.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/custom-fields", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "custom-fields" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"entity_types\": [\n \"server\"\n ],\n \"key\": \"cost_center\",\n \"label\": \"Cost center\",\n \"type\": \"text\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update a custom field", "request": { "method": "PATCH", "description": "Replaces the field’s definition; send the full set of fields, as on create. Requires a plan that includes custom fields.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/custom-fields/:customFieldDefinition_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "custom-fields", ":customFieldDefinition_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "customFieldDefinition_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"entity_types\": [\n \"server\",\n \"domain\"\n ],\n \"key\": \"cost_centre\",\n \"label\": \"Responsible team\",\n \"type\": \"select\",\n \"options\": [\n \"Platform\",\n \"Marketing\",\n \"Data\",\n \"Internal tools\"\n ]\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a custom field", "request": { "method": "DELETE", "description": "Deletes the field definition together with every value stored for it. Requires a plan that includes custom fields.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/custom-fields/:customFieldDefinition_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "custom-fields", ":customFieldDefinition_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "customFieldDefinition_id", "value": "" } ] } } }, { "name": "List custom field values for a record", "request": { "method": "GET", "description": "The custom field values set on one record. `entity_type` and `entity_id` are required; returns 404 when the record is not in this organization.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/custom-field-values", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "custom-field-values" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Set a custom field value", "request": { "method": "PUT", "description": "Sets the `value` of one field (`definition_id`) on one record (`entity_type`, `entity_id`), checked against the field’s type and options. A null value clears it and returns 204. Requires a plan that includes custom fields.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/custom-field-values", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "custom-field-values" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"entity_type\": \"server\",\n \"entity_id\": 1,\n \"definition_id\": 1,\n \"value\": \"Platform\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "List tags", "request": { "method": "GET", "description": "Every tag in the organization, with its colour, whether it names a client, its uptime target and how many resources carry it (`usage_count`).\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "tags" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a tag", "request": { "method": "POST", "description": "Creates a tag from a `name` (up to 50 characters) and a hex `color` such as `#ff8800`; `is_client` is optional. Refused with 422 when a tag with that name already exists.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/tags", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "tags" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Payments\",\n \"color\": \"#3B82F6\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update a tag", "request": { "method": "PATCH", "description": "Changes any of `name`, `color`, `is_client` and `uptime_target_pct` (0 to 100, or null to clear it). Refused with 422 when the new name is already taken.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/tags/:tag_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "tags", ":tag_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "tag_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"color\": \"#22C55E\",\n \"uptime_target_pct\": 99.9\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a tag", "request": { "method": "DELETE", "description": "Deletes the tag and removes it from every resource that carried it. The resources themselves are kept.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/tags/:tag_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "tags", ":tag_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "tag_id", "value": "" } ] } } } ] }, { "name": "Costs", "description": "Cost items, cost changes and provider price changes.", "item": [ { "name": "List cost items", "request": { "method": "GET", "description": "The recurring costs you recorded on one resource. `entity_type` is required, and `entity_id` too unless `entity_type` is `organization`, which lists costs that belong to the whole organization.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cost-items", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cost-items" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Create a cost item", "request": { "method": "POST", "description": "Records a recurring cost with a `label`, `amount`, `currency` and optional `period` (default monthly) on a resource (`entity_type`, `entity_id`), or on the whole organization with `entity_type` `organization`.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cost-items", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cost-items" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] }, "body": { "mode": "raw", "raw": "{\n \"entity_type\": \"organization\",\n \"label\": \"Uptime SMS credits\",\n \"amount\": 9,\n \"currency\": \"EUR\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Update a cost item", "request": { "method": "PATCH", "description": "Changes the cost’s `label`, `amount`, `currency` and `period`. `label`, `amount` and `currency` are required on every update; an omitted `period` resets to monthly.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cost-items/:costItem_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cost-items", ":costItem_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "costItem_id", "value": "" } ] }, "body": { "mode": "raw", "raw": "{\n \"label\": \"Status page SMS credits\",\n \"amount\": 15,\n \"currency\": \"EUR\"\n}", "options": { "raw": { "language": "json" } } } } }, { "name": "Delete a cost item", "request": { "method": "DELETE", "description": "Deletes the recorded cost.\n\nScope: `monitoring.write`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cost-items/:costItem_id", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cost-items", ":costItem_id" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "costItem_id", "value": "" } ] } } }, { "name": "List price changes for a resource", "request": { "method": "GET", "description": "How one resource’s price has changed over time, newest first, up to 100 entries. `entity_type` and `entity_id` are required.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/price-changes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "price-changes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List cost events", "request": { "method": "GET", "description": "Money spent on a date, such as registrations, renewals, transfers and purchases, newest first, up to 500 entries. Narrow with `entity_type`, `entity_id`, `from` and `to`. Requires a plan that includes cost reporting.\n\nScope: `monitoring.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/cost-events", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "cost-events" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Billing", "description": "Subscription, invoices and usage. Read only.", "item": [ { "name": "Get the subscription", "request": { "method": "GET", "description": "The organization’s subscription and plan, the plan whose limits currently apply, whether a free trial is still available and any discount in force. Read-only; returns 404 when there is no subscription.\n\nScope: `billing.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/subscription", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "subscription" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List add-ons", "request": { "method": "GET", "description": "The add-ons on offer with their prices, each marked `owned` when the organization already has it. Read-only.\n\nScope: `billing.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/subscription/addons", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "subscription", "addons" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List invoices", "request": { "method": "GET", "description": "Your most recent 100 invoices, newest first, with their status, totals, billing period and links to view or download each one. Read-only.\n\nScope: `billing.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/invoices", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "invoices" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "List credit notes", "request": { "method": "GET", "description": "Credit notes issued against your invoices, with the invoice each one credits, its amounts (negative, in the currency’s smallest unit), how it was settled and a PDF link. Read-only.\n\nScope: `billing.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/credit-notes", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "credit-notes" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get account credit", "request": { "method": "GET", "description": "Money InfraNest holds for you — for example after a downgrade or a refund — which comes off your next invoice. One balance per currency, in the currency’s smallest unit; empty when you have none. Read-only.\n\nScope: `billing.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/account-credit", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "account-credit" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Get your referrals", "request": { "method": "GET", "description": "Your referral link, what it has earned and how much discount is left, and the workspaces that signed up with it — names partly hidden, with where each referral has got to. `enabled` is false when the referral programme is switched off. Read-only.\n\nScope: `billing.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/referrals", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "referrals" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Audit log", "description": "Every change in the organization, including those made with tokens. Read only.", "item": [ { "name": "List audit log entries", "request": { "method": "GET", "description": "Who changed what in the organization, newest first. Filter with the dates `from` and `to`, `action` (matches part of the name), `resource_type` and `token_id` for changes made through one API token; page with `per_page` (default 25, at most 100) and `page`.\n\nScope: `audit-log.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/audit-logs", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "audit-logs" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Export the audit log as CSV", "request": { "method": "GET", "description": "Downloads every matching entry as a CSV file, with the same filters as the list and no paging. The export is itself recorded in the audit log.\n\nScope: `audit-log.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/audit-logs/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "audit-logs", "export" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Data export", "description": "Export your data as CSV or JSON.", "item": [ { "name": "List exportable data", "request": { "method": "GET", "description": "The kinds of data you can export and the formats available, each marked `locked` when your plan does not include it. CSV is always available; JSON and XML need a plan with advanced export.\n\nScope: `data.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/export", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "export" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Download a full data export", "request": { "method": "GET", "description": "A ZIP file with a CSV and a JSON file for every kind of data your role may read, plus a `manifest.json` that lists what is included.\n\nScope: `data.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/export/bundle", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "export", "bundle" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } }, { "name": "Export one kind of data", "request": { "method": "GET", "description": "Downloads every record of one kind as a file, in `format` `csv` (default), `json` or `xml`; pass `ids[]` to export only those records. Refused when your role may not read that data or your plan does not include the resource or format.\n\nScope: `data.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/export/:resource", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "export", ":resource" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" }, { "key": "resource", "value": "" } ] } } }, { "name": "List importable data", "request": { "method": "GET", "description": "The kinds of data you can import from CSV, with the column headers each expects, and whether your plan allows importing (`allowed`). Requires permission to manage the organization.\n\nScope: `data.read`", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/organizations/:organization_id/import", "host": [ "{{baseUrl}}" ], "path": [ "api", "organizations", ":organization_id", "import" ], "variable": [ { "key": "organization_id", "value": "{{organization_id}}" } ] } } } ] }, { "name": "Account", "description": "Who the token belongs to, and revoking it.", "item": [ { "name": "Revoke the current token", "request": { "method": "POST", "description": "Deletes the token that authenticated this request, so it stops working immediately. Other tokens on your account are not affected.", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/auth/logout", "host": [ "{{baseUrl}}" ], "path": [ "api", "auth", "logout" ], "variable": [] } } }, { "name": "Get the signed-in user", "request": { "method": "GET", "description": "Your user profile, the organizations you belong to with your role in each, and the state of your account security (two-factor, passkeys, password). A token bound to one organization lists only that organization.", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/auth/me", "host": [ "{{baseUrl}}" ], "path": [ "api", "auth", "me" ], "variable": [] } } } ] } ] }