oCoreoCore Docs
API Reference

Domains

List instance domains

Returns all custom domains configured for an instance.

GET
/instances/{id}/domains

Authorization

Authorization<token>

JWT Bearer token (format: Bearer {token})

In: header

Path Parameters

idRequiredstring

Instance ID

curl -X GET "//api.ocore.dev/api/instances/<string>/domains" \
  -H "Authorization: <token>"

OK

{
  "domains": [
    {
      "createdAt": "string",
      "dnsStatus": "string",
      "domain": "string",
      "id": "string",
      "instanceId": "string",
      "isAutoGenerated": true,
      "isPrimary": true,
      "sslExpiresAt": "string",
      "sslStatus": "string",
      "updatedAt": "string"
    }
  ],
  "total": 0
}

Add custom domain

Adds a custom domain to an instance and enqueues proxy configuration.

POST
/instances/{id}/domains

Authorization

Authorization<token>

JWT Bearer token (format: Bearer {token})

In: header

Request Body

application/jsonRequired

Domain request

domainstring
isPrimaryboolean

Path Parameters

idRequiredstring

Instance ID

curl -X POST "//api.ocore.dev/api/instances/<string>/domains" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "string",
    "isPrimary": true
  }'

Created

{
  "createdAt": "string",
  "dnsStatus": "string",
  "domain": "string",
  "id": "string",
  "instanceId": "string",
  "isAutoGenerated": true,
  "isPrimary": true,
  "sslExpiresAt": "string",
  "sslStatus": "string",
  "updatedAt": "string"
}

Get domain details

Returns details for a single domain by ID.

GET
/instances/{id}/domains/{domainId}

Authorization

Authorization<token>

JWT Bearer token (format: Bearer {token})

In: header

Path Parameters

idRequiredstring

Instance ID

domainIdRequiredstring

Domain ID

curl -X GET "//api.ocore.dev/api/instances/<string>/domains/<string>" \
  -H "Authorization: <token>"

OK

{
  "createdAt": "string",
  "dnsStatus": "string",
  "domain": "string",
  "id": "string",
  "instanceId": "string",
  "isAutoGenerated": true,
  "isPrimary": true,
  "sslExpiresAt": "string",
  "sslStatus": "string",
  "updatedAt": "string"
}

Delete custom domain

Removes a custom domain from an instance and updates proxy configuration.

DELETE
/instances/{id}/domains/{domainId}

Authorization

Authorization<token>

JWT Bearer token (format: Bearer {token})

In: header

Path Parameters

idRequiredstring

Instance ID

domainIdRequiredstring

Domain ID

curl -X DELETE "//api.ocore.dev/api/instances/<string>/domains/<string>" \
  -H "Authorization: <token>"

No Content

Update domain

Updates mutable fields on a domain (e.g. isPrimary).

PUT
/instances/{id}/domains/{domainId}

Authorization

Authorization<token>

JWT Bearer token (format: Bearer {token})

In: header

Request Body

application/jsonRequired

Domain update

isPrimaryboolean

Path Parameters

idRequiredstring

Instance ID

domainIdRequiredstring

Domain ID

curl -X PUT "//api.ocore.dev/api/instances/<string>/domains/<string>" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "isPrimary": true
  }'

OK

{
  "createdAt": "string",
  "dnsStatus": "string",
  "domain": "string",
  "id": "string",
  "instanceId": "string",
  "isAutoGenerated": true,
  "isPrimary": true,
  "sslExpiresAt": "string",
  "sslStatus": "string",
  "updatedAt": "string"
}

Set primary domain

Sets a domain as the primary domain for an instance.

PUT
/instances/{id}/domains/{domainId}/primary

Authorization

Authorization<token>

JWT Bearer token (format: Bearer {token})

In: header

Path Parameters

idRequiredstring

Instance ID

domainIdRequiredstring

Domain ID

curl -X PUT "//api.ocore.dev/api/instances/<string>/domains/<string>/primary" \
  -H "Authorization: <token>"

OK

{
  "message": "string"
}

Was this page helpful?
Edit on GitHub

Instances

Previous Page

D N S

Next Page