Skip to content
Duta

Add a domain

POST
/domains
curl --request POST \
  --url https://api.duta.indra.sh/v1/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "domain": "example" }'

Returns the two DNS records to publish. region is accepted and ignored: Duta sends from one region.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name

The domain to send from, such as example.com

string
>= 3 characters <= 253 characters /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/
domain

The same as name, under Duta’s original spelling

string
>= 3 characters <= 253 characters /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/
Examplegenerated
{
  "name": "example",
  "domain": "example"
}

Responses

Section titled “ Responses ”

201

Section titled “201”

Success

Media typeapplication/json
object
object
required
string
Allowed values: domain
id
required
string
name
required
string
domain
required
string
status
required
string
Allowed values: pending verified failed
region
required
string
capabilities
required
object
sending
required
string
Allowed values: enabled
receiving
required
string
Allowed values: disabled
created_at
required

ISO 8601

string format: date-time
records
required
Array<object>
object
record
required
string
Allowed values: DKIM SPF DMARC
type
required
string
Allowed values: CNAME TXT MX
name
required
string
value
required
string
priority
integer
ttl
required
string
Allowed values: Auto
status
required
string
Allowed values: verified pending not_started
purpose
required
string
required
required
boolean
group
required
string
Allowed values: dkim sending dmarc
verified_at
required

ISO 8601

string | null format: date-time
last_checked_at
required

ISO 8601

string | null format: date-time
Example
{
  "object": "domain",
  "status": "pending",
  "capabilities": {
    "sending": "enabled",
    "receiving": "disabled"
  },
  "records": [
    {
      "record": "DKIM",
      "type": "CNAME",
      "ttl": "Auto",
      "status": "verified",
      "group": "dkim"
    }
  ]
}

401

Section titled “401”

Missing or invalid API key

Media typeapplication/json
object
statusCode
required
integer
name
required

The Resend error name, so code that branches on it keeps working

string
message
required
string
code
required

Duta’s error code, finer grained than name

string
Allowed values: unauthorized forbidden not_found validation_failed domain_not_verified from_domain_not_allowed recipient_suppressed recipient_not_confirmed rate_limited quota_exceeded conflict payment_required account_paused content_rejected platform_halted payload_too_large length_required idempotency_conflict provider_error internal_error
detail
object
key
additional properties
request_id
required

Find this request on the Logs screen

string
Example
{
  "code": "unauthorized"
}

403

Section titled “403”

The key has sending access only

Media typeapplication/json
object
statusCode
required
integer
name
required

The Resend error name, so code that branches on it keeps working

string
message
required
string
code
required

Duta’s error code, finer grained than name

string
Allowed values: unauthorized forbidden not_found validation_failed domain_not_verified from_domain_not_allowed recipient_suppressed recipient_not_confirmed rate_limited quota_exceeded conflict payment_required account_paused content_rejected platform_halted payload_too_large length_required idempotency_conflict provider_error internal_error
detail
object
key
additional properties
request_id
required

Find this request on the Logs screen

string
Example
{
  "code": "unauthorized"
}

422

Section titled “422”

The request was refused. code says why

Media typeapplication/json
object
statusCode
required
integer
name
required

The Resend error name, so code that branches on it keeps working

string
message
required
string
code
required

Duta’s error code, finer grained than name

string
Allowed values: unauthorized forbidden not_found validation_failed domain_not_verified from_domain_not_allowed recipient_suppressed recipient_not_confirmed rate_limited quota_exceeded conflict payment_required account_paused content_rejected platform_halted payload_too_large length_required idempotency_conflict provider_error internal_error
detail
object
key
additional properties
request_id
required

Find this request on the Logs screen

string
Example
{
  "code": "unauthorized"
}

429

Section titled “429”

Rate limited. Retry after the Retry-After header

Media typeapplication/json
object
statusCode
required
integer
name
required

The Resend error name, so code that branches on it keeps working

string
message
required
string
code
required

Duta’s error code, finer grained than name

string
Allowed values: unauthorized forbidden not_found validation_failed domain_not_verified from_domain_not_allowed recipient_suppressed recipient_not_confirmed rate_limited quota_exceeded conflict payment_required account_paused content_rejected platform_halted payload_too_large length_required idempotency_conflict provider_error internal_error
detail
object
key
additional properties
request_id
required

Find this request on the Logs screen

string
Example
{
  "code": "unauthorized"
}