Set a custom collection hostname for this domain (org admin)

PUT

/v1/domains/{id}/collect

curl --request PUT \
  --url https://api.monita.ai/v1/domains/example/collect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "hostname": "example" }'

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Request Body

Media typeapplication/json

object

hostname

required

string

>= 4 characters <= 253 characters

Example^generated

{
  "hostname": "example"
}

Responses

200

OK

Media typeapplication/json

object

hostname

required

string

nullable

status

required

string

nullable

dns

Array<object>

object

type

required

string

name

required

string

value

required

string

purpose

required

string

Example^generated

{
  "hostname": "example",
  "status": "example",
  "dns": [
    {
      "type": "example",
      "name": "example",
      "value": "example",
      "purpose": "example"
    }
  ]
}

400

Bad hostname

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}

404

Not found

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}

503

Provisioning unavailable

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}