Traffic Sources DNS Devices

Get All DNS Devices

get

Returns a list of all DNS devices.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

List of Requested DNS Devices

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

get

/api/v1/dns-devices

HTTPcURLJavaScriptPython

GET /api/v1/dns-devices HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": [
    {
      "id": "text",
      "name": "text",
      "type": "text",
      "site": "text",
      "enabled": true
    }
  ]
}

Add DNS Device

post

Adds a new DNS device.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

Name of the DNS device.

typestringRequired

Type of the DNS device.

sitestringRequired

Site location of the DNS device.

enabledbooleanRequired

Whether the DNS device is enabled.

Responses

201

Requested DNS Device

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

post

/api/v1/dns-devices

HTTPcURLJavaScriptPython

POST /api/v1/dns-devices HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "name": "text",
  "type": "text",
  "site": "text",
  "enabled": true
}

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": {
    "id": "text",
    "name": "text",
    "type": "text",
    "site": "text",
    "enabled": true
  }
}

Get DNS Device By ID

get

Fetches a specific DNS device by ID.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The ID of the DNS device to fetch.

Responses

200

Requested DNS Device

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

get

/api/v1/dns-devices/{id}

HTTPcURLJavaScriptPython

GET /api/v1/dns-devices/{id} HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": {
    "id": "text",
    "name": "text",
    "type": "text",
    "site": "text",
    "enabled": true
  }
}

Update DNS Device By ID

put

Updates a DNS device by ID.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The ID of the DNS device to update.

Body

application/json

namestringRequired

Name of the DNS device.

typestringRequired

Type of the DNS device.

sitestringRequired

Site location of the DNS device.

enabledbooleanRequired

Whether the DNS device is enabled.

Responses

200

Requested DNS Device

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

put

/api/v1/dns-devices/{id}

HTTPcURLJavaScriptPython

PUT /api/v1/dns-devices/{id} HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "name": "text",
  "type": "text",
  "site": "text",
  "enabled": true
}

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": {
    "id": "text",
    "name": "text",
    "type": "text",
    "site": "text",
    "enabled": true
  }
}

Delete DNS Device By ID

delete

Deletes a DNS device by ID.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The ID of the DNS device to delete.

Responses

204

An empty response.

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

delete

/api/v1/dns-devices/{id}

HTTPcURLJavaScriptPython

DELETE /api/v1/dns-devices/{id} HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Bulk Delete DNS Devices

put

Deletes multiple DNS devices in bulk.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodystring[]

application/json

string[]Optional

Responses

204

An empty response.

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

put

/api/v1/dns-devices/bulkdelete

HTTPcURLJavaScriptPython

PUT /api/v1/dns-devices/bulkdelete HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 8

[
  "text"
]

No content

Enable DNS Device By ID

put

Enables a DNS device by ID.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The ID of the DNS device to enable.

Responses

200

Requested DNS Device

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

put

/api/v1/dns-devices/{id}/enable

HTTPcURLJavaScriptPython

PUT /api/v1/dns-devices/{id}/enable HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": {
    "id": "text",
    "name": "text",
    "type": "text",
    "site": "text",
    "enabled": true
  }
}

Disable DNS Device By ID

put

Disables a DNS device by ID.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

The ID of the DNS device to disable.

Responses

200

Requested DNS Device

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

put

/api/v1/dns-devices/{id}/disable

HTTPcURLJavaScriptPython

PUT /api/v1/dns-devices/{id}/disable HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": {
    "id": "text",
    "name": "text",
    "type": "text",
    "site": "text",
    "enabled": true
  }
}