Retry SSL for a domain

Requests certificate issuance again for the hostname and its apex, then returns the per-hostname outcome, fresh diagnostics, and the runtime operation. Fails when the domain is not assigned to a Space. Limited to 6 attempts per hour per domain and 120 per hour per team.

POST /v1/domains/{domainId}/ssl/retry

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:write

Path parameters

domainId string required

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

Show properties

• requestedAt: string required

ISO 8601 timestamp when the retry was submitted.

• retries: object[] required

One entry per hostname the retry was submitted for.

• hostname: string required

  • queued: boolean required

  • error: string | any required

    not_hosted_here when the host does not serve this hostname. Null when the retry was accepted.

• hostnameDiagnostics: object[] required

DNS and certificate state for each hostname, read after the retry was submitted.

• hostname: string required
  • purpose: string required

Why this hostname is in the set: apex for the registrable domain, www for its www twin, configured for the name on the domain record.

• isConfiguredHostname: boolean required
  • providerIps: string[] required

Addresses this hostname has to resolve to before it can serve.

• dnsInstructions: object[] required

Records to create for this hostname.

Response Example

{
  "$schema": "http://example.com",
  "data": {
    "requestedAt": "2019-08-24T14:15:22Z",
    "retries": [
      {
        "hostname": "string",
        "queued": true,
        "error": "not_hosted_here"
      }
    ],
    "hostnameDiagnostics": [
      {
        "hostname": "string",
        "purpose": "apex",
        "isConfiguredHostname": true,
        "providerIps": [],
        "verificationCode": "string",
        "dnsInstructions": [],
        "dns": {
          "observedAt": "2019-08-24T14:15:22Z",
          "expectedTxtValue": "string",
          "pointsToProvider": true,
          "proxyDetected": true,
          "txtVerified": true,
          "hasAaaaRecords": true,
          "hasCaaRecords": true,
          "records": {
            "a": [],
            "aaaa": [],
            "caa": [],
            "cname": [],
            "mx": [],
            "txt": []
          },
          "byResolver": []
        },
        "ssl": {
          "status": "missing",
          "canRetry": true,
          "certificateId": "string",
          "validationExpiration": "string",
          "authzUri": "string",
          "brokenRecord": {
            "reason": "string",
            "lastError": "string",
            "retryDate": "string",
            "failCount": -9007199254740991
          }
        }
      }
    ]
  },
  "operation": {
    "id": "string",
    "kind": "string",
    "status": "queued",
    "resources": [
      {
        "type": "string",
        "id": "string"
      }
    ],
    "progress": {
      "total": 9007199254740991,
      "completed": 9007199254740991,
      "failed": 9007199254740991
    },
    "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",
    "finishedAt": "2019-08-24T14:15:22Z"
  }
}

Error Response Example

{
  "$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"
}