List managed hostnames

Returns the read-only hostnames Spacefast manages for the caller’s Spaces, default hostname first and then alphabetically, with no pagination. Pass teamId to limit the result to one team. Custom domains live on /v1/domains.

GET /v1/managed-domains

Authorization

Authorization Bearer token · header required

Authorization: Bearer <token> with an API key (sfa_ prefix), an OAuth access token, a session token, or a Space machine credential (sfm_ prefix).

or

Authorization OAuth2 access token · header required

OAuth 2.0 with Spacefast scopes. People use the authorization code flow; machines use client credentials.

Scopes: domains:read

Query parameters

• teamId string
  min length 1

Responses

200 Response for status 200

• $schema string
  Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

• data object[] required
  Array of object

• id string required
  Managed hostname row ID (phn_ prefix).

  • source string required
    A hostname Spacefast issued and manages; it cannot be edited or unassigned.
  • managed boolean required
  • deletable boolean required
  • assignable boolean required
  • primary boolean required
    Whether the Space still serves its primary URL on this hostname. False once a custom domain takes over, and false on every row of the managed hostname list.
  • name string required
    Full hostname Spacefast serves the Space on.
  • unicodeName string
  • kind string required
  • publicName string required
    Leftmost label of name, chosen per Space.
  • verification object required
    • status string required
    • requiredRecords object[]
      Records the caller still has to create to prove control and route traffic. Absent once the hostname serves, and while the domain serves no Space.

• Allowed: A, AAAA, CNAME, TXT, ALIAS - name string required
  Record name, relative to the zone. - value string required
  Exact value to set on the record. - ttl integer
  min -9007199254740991 · max 9007199254740991 - purpose string required
  Why the record is needed: verification proves ownership, routing sends traffic to the Space, ssl allows certificate issuance.

• Allowed: verification, routing, ssl - lastCheckedAt string | any
  ISO 8601 timestamp of the last DNS check. Null before the first one. - lastVerifiedAt string | any
  ISO 8601 timestamp when this domain last proved DNS control. Null if it never has.

  • diagnostics object[]
    Stable-coded observations about verification, delegation, and registration state. Absent when there are none.

• code string required
  - severity string required
  Allowed: info, warning, error - message string required
  - path string | any - provider string | any
  - details object | any - fix string | any
  - retryable boolean | any

  • createdAt string required
  • updatedAt string required
  • spaceId string required
    Space served by this hostname (spc_ prefix).
  • spaceSlug string required
    Current slug of that Space.
  • spaceTitle string required
    Current title of that Space.

default Error

Every 4xx and 5xx response is one RFC 9457 problem document served as application/problem+json.

• $schema string
• type string required
• title string required
• status integer required
  min -9007199254740991 · max 9007199254740991
• detail string required
• code string required
• pointer string
• details object
• suggestions string[]
• next string[]
• requestId string required

Try it

cURL

curl -X GET "https://api.spacefast.com/v1/managed-domains" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://api.spacefast.com/v1/managed-domains", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Python

import requests

response = requests.get(
    "https://api.spacefast.com/v1/managed-domains",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

200 default

{
  "$schema": "http://example.com",
  "data": [
    {
      "id": "string",
      "source": "managed_view_fast",
      "managed": true,
      "deletable": false,
      "assignable": false,
      "primary": true,
      "name": "string",
      "unicodeName": "string",
      "kind": "hostname",
      "publicName": "string",
      "verification": {
        "status": "not_required",
        "requiredRecords": [
          {
            "type": "A",
            "name": "string",
            "value": "string",
            "ttl": -9007199254740991,
            "purpose": "verification"
          }
        ],
        "lastCheckedAt": "2019-08-24T14:15:22Z",
        "lastVerifiedAt": "2019-08-24T14:15:22Z",
        "diagnostics": [
          {
            "code": "string",
            "severity": "info",
            "message": "string",
            "path": "string",
            "provider": "infra",
            "details": {
              "property1": null,
              "property2": null
            },
            "fix": "string",
            "retryable": true
          }
        ]
      },
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "spaceId": "string",
      "spaceSlug": "string",
      "spaceTitle": "string"
    }
  ]
}

{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": [
    "string"
  ],
  "next": [
    "string"
  ],
  "requestId": "string"
}