Account Computer List

URI	/v1/accounts/{username}/computers
URI Parameters	username (string)
Methods	GET, POST

GET /v1/accounts/{username}/computers

Gets an account's computers

Scope	computers_read
Query Selector Parameters	deleted (int) – 0\|1
Query Pagination Parameters	page (int) – the page to show (min 1, default 1) page_size (int) – the number of computers per page (min 1, max 50, default 10)
Query Sorting Parameters	order_by (string const) – COMP_ID\|NAME order_dir (string const) – ASC\|DESC
Request Body Parameters	n/a
Response Attributes	computer_id (string) name (string) link (link object)

Example JSON

Request:

GET /v1/accounts/barracuda/computers HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Accept: application/json

Response:

HTTP/1.1 200 OK

Content-Type: application/json

{

"page": 2,

"page_size": 10,

"count": 12,

"links": [

{

"rel": "first",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers?page=1"

},

{

"rel": "prev",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers?page=1"

}

],

"list": [

{

"computer_id": "0010",

"name": "Mail Server",

"link": {

"rel": "self",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers/0010"

}

},

{

"computer_id": "0011",

"name": "Personal Computer",

"link": {

"rel": "self",

"href": "https://api.intronis.com/v1/accounts/barracuda/computers/0011"

}

]

}

Example XML

Request:

GET /v1/accounts/barracuda/computers HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Accept: application/xml

Response:

HTTP/1.1 200 OK

Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>

<computer_id>0010</computer_id>

<name>Mail Server</name>

</computer>

<computer_id>0011</computer_id>

<name>Personal Computer</name>

</computer>

</list>

POST /v1/accounts/{username}/computers

Adds a new computer to an account.

Scope	computers_write
Request Body Parameters	name (string) password (string) email (string) phone (string)
Response Attributes	n/a

Example JSON

Request:

POST /v1/accounts/barracuda/computers HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Content-Type: application/json

{

"name": "Mail Server",

"password": "ps8wEzeT",

"email": "jsmith@barracuda.com",

"phone": "617-948-5300"

}

Response:

HTTP/1.1 201 Created

Location: https://api.intronis.com/v1/accounts/barracuda/computers/0001

Example XML

Request:

POST /v1/accounts/barracuda/computers HTTP/1.1

Host: api.intronis.com

Authorization: OAuth vF9dft4qmT

Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>

<name>Mail Server</name>

<password>ps8wEzeT</password>

<email>jsmith@barracuda.com</email>

</computer>

Response:

HTTP/1.1 201 Created

Location: https://api.intronis.com/v1/accounts/barracuda/computers/0001