Spaceship DNS Manager

Manage DNS records for domains on spaceship.com via API.

API Details

Base URL: https://spaceship.dev/api/v1

Auth Headers:

• X-Api-Key: from $SPACESHIP_API_KEY
• X-Api-Secret: from $SPACESHIP_API_SECRET

Endpoints

List Records

curl -s "https://spaceship.dev/api/v1/dns/records/{domain}?take=500&skip=0" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" | jq

Create/Update Records

curl -s -X PUT "https://spaceship.dev/api/v1/dns/records/{domain}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"force": true, "items": [RECORDS_JSON]}'

Delete Records

curl -s -X DELETE "https://spaceship.dev/api/v1/dns/records/{domain}" \
  -H "X-Api-Key: $SPACESHIP_API_KEY" \
  -H "X-Api-Secret: $SPACESHIP_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '[RECORDS_TO_DELETE]'

DNS Record Schema

{
  "type": "A|AAAA|CNAME|MX|TXT|NS|SRV|CAA|ALIAS|HTTPS|SVCB|PTR|TLSA",
  "name": "@|subdomain|*.wildcard",
  "ttl": 3600,

  "address": "1.2.3.4",           // A, AAAA
  "cname": "target.com",          // CNAME
  "value": "txt content",         // TXT, CAA
  "exchange": "mail.example.com", // MX
  "preference": 10,               // MX priority
  "nameserver": "ns1.example.com" // NS
}

Workflow

1. List current records to understand existing state
2. Parse user's requested records (from Spaceship UI, Resend, Cloudflare, or plain text)
3. Build PUT request with correct schema
4. Execute and verify

Rate Limits

5 requests per domain per 300 seconds. Batch multiple record changes into single PUT.

Common Examples

Resend/SES email:

[
  {"type": "TXT", "name": "resend._domainkey", "ttl": 3600, "value": "p=MIG..."},
  {"type": "MX", "name": "send", "ttl": 3600, "exchange": "feedback-smtp.us-east-1.amazonses.com", "preference": 10},
  {"type": "TXT", "name": "send", "ttl": 3600, "value": "v=spf1 include:amazonses.com ~all"}
]

Google Workspace:

[
  {"type": "MX", "name": "@", "ttl": 3600, "exchange": "aspmx.l.google.com", "preference": 1},
  {"type": "TXT", "name": "@", "ttl": 3600, "value": "v=spf1 include:_spf.google.com ~all"}
]