Skip to main content
Developers3 min read

Make your first API request

Create a token and read your domains and DNS records.

Create your credential

Sign in to Dashio App, select a Space, and open Developers → Access tokens. A Space owner or admin can create a token with domains:read. Select dns:read separately to list DNS records.

Copy the complete dashio_ secret once into your server's secret manager as DASHIO_API_TOKEN. Keep it out of source code, URLs, browsers, and logs. Each token belongs to one Space; requests need no Space ID. See API tokens and permissions for expiry, MFA, rotation, and revocation.

List your domains

Run from a trusted server or terminal with DASHIO_API_TOKEN configured:

bash
curl --fail-with-body --silent --show-error --max-time 30 \
  'https://app.dashio.net/api/v1/domains?limit=20' \
  --header "Authorization: Bearer $DASHIO_API_TOKEN"

List domains returns 200 with domains and pagination. Domain fields include id, name, status, createdAt, and expiresAt.

For the next page, send pagination.nextCursor as the cursor query parameter. A null cursor ends the list. The default limit is 20; the maximum is 100. Reuse the returned cursor as supplied.

Read DNS records

With dns:read, replace example.com with a domain from your list. Use its lowercase ASCII or punycode name, not its database ID:

bash
curl --fail-with-body --silent --show-error --max-time 30 \
  'https://app.dashio.net/api/v1/domains/example.com/records?limit=20' \
  --header "Authorization: Bearer $DASHIO_API_TOKEN"

List DNS records returns 200 with records and the same pagination structure. Each record has a stable id.

Handle errors

Inspect the HTTP status and data.code. Check the token on 401, the required scope and product access on 403, and the operation's conflict guidance on 409. On 429, honor Retry-After. Keep X-Request-Id for support and keep the token and product data private.

Once your first request works, choose the product operations and scopes for your integration.

Was this helpful?