Domain

Endpointhttps://api.lettermint.co/v1

List all domains for the team

GET

https://api.lettermint.co/v1

/domains

List all domains for the team › query Parameters

sort

string

Available sorts are domain, created_at, status_changed_at. You can sort by multiple options by separating them with a comma. To sort in descending order, use - sign in front of the sort, for example: -domain.

Default: -created_at

page[size]

integer

The number of results that will be returned per page.

Default: 30

page[cursor]

string

The cursor to start the pagination from.

filter[status]

string · enum


`verified` The domain is active and verified.
`partially_verified` Some DNS records of the domain could not be verified.
`pending_verification` The domain is new and verification is pending.
`failed_verification` The domain verification failed.

Enum values:

verified

partially_verified

pending_verification

failed_verification

filter[domain]

string

Search by domain name (partial match, case insensitive)

List all domains for the team › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

List all domains for the team › Responses

200

Paginated set of DomainListData

object[] · required

path

string | null · required

Base path for paginator generated URLs.

per_page

integer · min: 0 · required

Number of items shown per page.

next_cursor

string | null · required

The "cursor" that points to the next set of items.

next_page_url

string | null · uri · required

prev_cursor

string | null · required

The "cursor" that points to the previous set of items.

prev_page_url

string | null · uri · required

Create a new domain

POST

https://api.lettermint.co/v1

/domains

Create a new domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Create a new domain › Request Body

domain

string · maxLength: 255 · pattern: ^(?!:\/\/)(?=.{1,255… · required

Create a new domain › Responses

DomainData

id

string · required

domain

string · required

status_changed_at

string | null · date-time · required

created_at

string · date-time · required

object[]

POST/domains

curl --request POST \
  --url https://api.lettermint.co/v1/domains \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "domain"
}
'

shell

Example Request Body

{
  "domain": "domain"
}

json

Example Responses

{
  "id": "id",
  "domain": "domain",
  "status_changed_at": "2024-08-25T15:00:00Z",
  "dns_records": [
    {
      "id": "id",
      "type": "TXT",
      "hostname": "hostname",
      "fqdn": "fqdn",
      "content": "content",
      "status": "active",
      "verified_at": "verified_at",
      "last_checked_at": "2024-08-25T15:00:00Z"
    }
  ],
  "projects": [
    {
      "id": "id",
      "name": "name"
    }
  ],
  "created_at": "2024-08-25T15:00:00Z"
}

json

application/json

Get domain details

GET

https://api.lettermint.co/v1

/domains/{domainId}

Get domain details › path Parameters

domainId

string · required

Get domain details › query Parameters

include

string

Available includes are dnsRecords, dnsRecordsCount, dnsRecordsExists. You can include multiple options by separating them with a comma.

Get domain details › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Get domain details › Responses

200

DomainData

id

string · required

domain

string · required

status_changed_at

string | null · date-time · required

created_at

string · date-time · required

object[]

Delete a domain

DELETE

https://api.lettermint.co/v1

/domains/{domainId}

Delete a domain › path Parameters

domainId

string · required

Delete a domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Delete a domain › Responses

200

message

string · const · required

Const value: Domain deleted successfully.

Verify all DNS records for a domain

POST

https://api.lettermint.co/v1

/domains/{domainId}/dns-records/verify

Verify all DNS records for a domain › path Parameters

domainId

string · required

Verify all DNS records for a domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Verify all DNS records for a domain › Responses

message

string · required

Verify a specific DNS record

POST

https://api.lettermint.co/v1

/domains/{domainId}/dns-records/{recordId}/verify

Verify a specific DNS record › path Parameters

domainId

string · required

recordId

string · required

Verify a specific DNS record › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Verify a specific DNS record › Responses

message

string · const · required

Const value: DNS record verified successfully.

Update projects associated with a domain

PUT

https://api.lettermint.co/v1

/domains/{domainId}/projects

Update projects associated with a domain › path Parameters

domainId

string · required

Update projects associated with a domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Update projects associated with a domain › Request Body

project_ids

string[] · required

Update projects associated with a domain › Responses

object · required

message

string · const · required

Const value: Domain projects updated successfully.

PUT/domains/{domainId}/projects

curl --request PUT \
  --url https://api.lettermint.co/v1/domains/:domainId/projects \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_ids": [
    "00000000-0000-0000-0000-000000000000"
  ]
}
'

shell

Example Request Body

{
  "project_ids": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

json

Example Responses

{
  "data": {
    "id": "id",
    "domain": "domain",
    "status_changed_at": "2024-08-25T15:00:00Z",
    "dns_records": [
      {
        "id": "id",
        "type": "TXT",
        "hostname": "hostname",
        "fqdn": "fqdn",
        "content": "content",
        "status": "active",
        "verified_at": "verified_at",
        "last_checked_at": "2024-08-25T15:00:00Z"
      }
    ],
    "projects": [
      {
        "id": "id",
        "name": "name"
      }
    ],
    "created_at": "2024-08-25T15:00:00Z"
  },
  "message": "Domain projects updated successfully."
}

json

application/json

Team Project

Lettermint Team API

Domain

Endpointhttps://api.lettermint.co/v1

List all domains for the team

GET

https://api.lettermint.co/v1

/domains

List all domains for the team › query Parameters

sort

string

Default: -created_at

page[size]

integer

The number of results that will be returned per page.

Default: 30

page[cursor]

string

The cursor to start the pagination from.

filter[status]

string · enum


`verified` The domain is active and verified.
`partially_verified` Some DNS records of the domain could not be verified.
`pending_verification` The domain is new and verification is pending.
`failed_verification` The domain verification failed.

Enum values:

verified

partially_verified

pending_verification

failed_verification

filter[domain]

string

Search by domain name (partial match, case insensitive)

List all domains for the team › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

List all domains for the team › Responses

200

Paginated set of DomainListData

object[] · required

path

string | null · required

Base path for paginator generated URLs.

per_page

integer · min: 0 · required

Number of items shown per page.

next_cursor

string | null · required

The "cursor" that points to the next set of items.

next_page_url

string | null · uri · required

prev_cursor

string | null · required

The "cursor" that points to the previous set of items.

prev_page_url

string | null · uri · required

Create a new domain

POST

https://api.lettermint.co/v1

/domains

Create a new domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Create a new domain › Request Body

domain

string · maxLength: 255 · pattern: ^(?!:\/\/)(?=.{1,255… · required

Create a new domain › Responses

DomainData

id

string · required

domain

string · required

status_changed_at

string | null · date-time · required

created_at

string · date-time · required

object[]

POST/domains

curl --request POST \
  --url https://api.lettermint.co/v1/domains \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "domain"
}
'

shell

Example Request Body

{
  "domain": "domain"
}

json

Example Responses

{
  "id": "id",
  "domain": "domain",
  "status_changed_at": "2024-08-25T15:00:00Z",
  "dns_records": [
    {
      "id": "id",
      "type": "TXT",
      "hostname": "hostname",
      "fqdn": "fqdn",
      "content": "content",
      "status": "active",
      "verified_at": "verified_at",
      "last_checked_at": "2024-08-25T15:00:00Z"
    }
  ],
  "projects": [
    {
      "id": "id",
      "name": "name"
    }
  ],
  "created_at": "2024-08-25T15:00:00Z"
}

json

application/json

Get domain details

GET

https://api.lettermint.co/v1

/domains/{domainId}

Get domain details › path Parameters

domainId

string · required

Get domain details › query Parameters

include

string

Available includes are dnsRecords, dnsRecordsCount, dnsRecordsExists. You can include multiple options by separating them with a comma.

Get domain details › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Get domain details › Responses

200

DomainData

id

string · required

domain

string · required

status_changed_at

string | null · date-time · required

created_at

string · date-time · required

object[]

Delete a domain

DELETE

https://api.lettermint.co/v1

/domains/{domainId}

Delete a domain › path Parameters

domainId

string · required

Delete a domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Delete a domain › Responses

200

message

string · const · required

Const value: Domain deleted successfully.

Verify all DNS records for a domain

POST

https://api.lettermint.co/v1

/domains/{domainId}/dns-records/verify

Verify all DNS records for a domain › path Parameters

domainId

string · required

Verify all DNS records for a domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Verify all DNS records for a domain › Responses

message

string · required

Verify a specific DNS record

POST

https://api.lettermint.co/v1

/domains/{domainId}/dns-records/{recordId}/verify

Verify a specific DNS record › path Parameters

domainId

string · required

recordId

string · required

Verify a specific DNS record › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Verify a specific DNS record › Responses

message

string · const · required

Const value: DNS record verified successfully.

Update projects associated with a domain

PUT

https://api.lettermint.co/v1

/domains/{domainId}/projects

Update projects associated with a domain › path Parameters

domainId

string · required

Update projects associated with a domain › Headers

Authorization

string · required

Bearer token. Format: Bearer {team_token}

Update projects associated with a domain › Request Body

project_ids

string[] · required

Update projects associated with a domain › Responses

object · required

message

string · const · required

Const value: Domain projects updated successfully.

PUT/domains/{domainId}/projects

curl --request PUT \
  --url https://api.lettermint.co/v1/domains/:domainId/projects \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_ids": [
    "00000000-0000-0000-0000-000000000000"
  ]
}
'

shell

Example Request Body

{
  "project_ids": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

json

Example Responses

{
  "data": {
    "id": "id",
    "domain": "domain",
    "status_changed_at": "2024-08-25T15:00:00Z",
    "dns_records": [
      {
        "id": "id",
        "type": "TXT",
        "hostname": "hostname",
        "fqdn": "fqdn",
        "content": "content",
        "status": "active",
        "verified_at": "verified_at",
        "last_checked_at": "2024-08-25T15:00:00Z"
      }
    ],
    "projects": [
      {
        "id": "id",
        "name": "name"
      }
    ],
    "created_at": "2024-08-25T15:00:00Z"
  },
  "message": "Domain projects updated successfully."
}

json

application/json

Team Project