For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Each DigitalOcean MicroVM serves its container over an authenticated HTTPS endpoint. A request to the endpoint resumes a paused MicroVM when auto-resume is on.

Prerequisites

• A running or paused MicroVM. See How to Create a MicroVM.
• A personal access token with only the microvm:access scope, exported as the DIGITALOCEAN_TOKEN environment variable. Use this token only for endpoint requests.

Find the MicroVM’s Endpoint

A MicroVM’s endpoint has the following form:

https://<your-microvm-id>.<region>.microvm.ondigitalocean.com

You can find the endpoint’s hostname in any of the following places:

• Control Panel: Under Endpoint on the MicroVM’s Overview tab.
• doctl: In the Endpoint column of doctl compute microvm get <your-microvm-id>.
• API: In the response’s urls array, in the entry with default set to true.

The hostname is empty, and the API entry’s status is PENDING, until provisioning finishes. The endpoint is ready when status is ACTIVE.

Send a Request to the HTTP Port

Send the request with your API token in the Authorization header. This example requests the default page of a MicroVM running nginx in MKC1:

curl -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://<your-microvm-id>.mkc1.microvm.ondigitalocean.com"

If the MicroVM is paused and auto-resume is on, the request resumes it and waits until it is running. If auto-resume is off, resume the MicroVM before you send requests.

The endpoint reaches only the HTTP port. Other ports you declare at creation are not reachable during the public preview.