Domains

Each and every test is done against a domain.

In order to limit misuse of our platform, we enforce that you must prove ownership for all domains that your team uses.

Permissions

Member role vs API call

List domains

Add domain

Remove domain

Reader

True

False

False

Editor

True

True

True

Admin

True

True

True

AdminWthBilling

True

True

True

Owner

True

True

True

List domains

Web

In order to view the domains on our platform, all you have to do is browse to the Domains page.

API call

The API call is:

curl -s \
    -d '{"team_id":"my-team"}' \
    -H "X-Api-Key: my_api_key" \
    -X POST \
    https://app.rungutan.com/v1/api/domains/list | jq . -r

{
  "Domains": [
    {
      "domain_name": "my_domain",
      "member_email": "[email protected]",
      "submitted_date": "2020-03-05T07:03:20Z"
    }
  ]
}

CLI

As simple as:

$ rungutan domains list
{
    "Domains": [
        {
            "domain_name": "my_domain",
            "member_email": "[email protected]",
            "submitted_date": "2020-03-05T07:03:20Z"
        }
    ]
}

Add domains

Web

In order to add a new domain on our platform, all you have to do is browse to the Domains page and click on the Add domain button.

API call

The API call is:

curl -s \
    -d '{"team_id":"my-team", "domain_name": "my-domain.com"}' \
    -H "X-Api-Key: my_api_key" \
    -X POST \
    https://app.rungutan.com/v1/api/domains/add | jq . -r

{
  "message": "Successfully added your domain."
}

CLI

$ rungutan domains add --domain_name other-domain.com
{
    "message": "Successfully added your domain"
}

Remove domains

Web

In order to remove a domain on our platform, all you have to do is browse to the Domains page anclick on the Remove domain button for the respective domain.

API call

The API call is:

curl -s \
    -d '{"team_id":"my-team", "domain_name": "my-domain.com"}' \
    -H "X-Api-Key: my_api_key" \
    -X POST \
    https://app.rungutan.com/v1/api/domains/remove | jq . -r

{
  "message": "Successfully removed your domain."
}

CLI

Drop it like it’s hot:

$ rungutan domains remove --domain_name other-domain.com
{
    "message": "Successfully removed your domain"
}