divisions/{{ID}}

PUT

Updates a specific Division

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

DIVISION:UPDATE, DIVISION:READ

Request Structure

Table 525 Request Path Parameters

Name	Description
ID	The integral, unique identifier of the requested Division

name:

The new name of the Division

#1280 Request Example

PUT /api/5.0/divisions/3 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 17
Content-Type: application/json

{"name": "quest"}

Response Structure

id:

An integral, unique identifier for this Division

lastUpdated:

The date and time at which this Division was last modified, in RFC 3339 format

Changed in version 5.0: Prior to version 5.0 of the API, this field was in Traffic Ops’s Custom Date/Time Format.

name:

The Division name

#1281 Response Example

HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: yBd8MzBR/Qbc/xts44WEIFRTrqeMKZwUe2ufpm6JH6frh1UjFmYRs3/B7E5FTruFWRTuvEIlx5EpDmp3f9LjzA==
X-Server-Name: traffic_ops_golang/
Date: Thu, 29 Nov 2018 20:10:36 GMT
Content-Length: 137

{ "alerts": [
    {
        "text": "division was updated.",
        "level": "success"
    }
],
"response": {
    "id": 3,
    "lastUpdated": "2018-11-29T16:23:53.696397+05:30",
    "name": "quest"
}}

DELETE

Deletes a specific Division.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

DIVISION:DELETE, DIVISION:READ

Request Structure

Table 526 Request Path Parameters

Name	Description
ID	The integral, unique identifier of the requested Division

#1282 Request Example

DELETE /api/5.0/divisions/3 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 2
Content-Type: application/json

Response Structure

id:

The integral, unique identifier of the deleted Division.

#1283 Response Example

HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: yBd8MzBR/Qbc/xts44WEIFRTrqeMKZwUe2ufpm6JH6frh1UjFmYRs3/B7E5FTruFWRTuvEIlx5EpDmp3f9LjzA==
X-Server-Name: traffic_ops_golang/
Date: Thu, 29 Nov 2018 20:10:36 GMT
Content-Length: 83

{
    "alerts": [
        {
            "text": "division was deleted.",
            "level": "success"
        }
    ],
    "response": {
        "id": "3"
    }
}