# 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 <uri>

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 <date-time> 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

```json
{
  "$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

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