/v1/version

GET /v1/version

Retrieve the server version number

Output

Name Mandatory Type Description
local boolean Either this is a local server
version string Version number human readable

Sample session

curl -i -X GET 'http://localhost:8000/v1/version'

GET /v1/version HTTP/1.1



HTTP/1.1 200
ACCESS-CONTROL-ALLOW-ORIGIN: *
CONNECTION: keep-alive
CONTENT-LENGTH: 50
CONTENT-TYPE: application/json
DATE: Thu, 08 Jan 2015 16:09:15 GMT
SERVER: Python/3.5 GNS3/1.4.0dev13
X-ROUTE: /v1/version

{
    "local": true,
    "version": "1.4.0dev13"
}

POST /v1/version

Check if version is the same as the server

Response status codes

  • 200: Same version
  • 409: Invalid version

Input

Name Mandatory Type Description
local boolean Either this is a local server
version string Version number human readable

Output

Name Mandatory Type Description
local boolean Either this is a local server
version string Version number human readable

Sample session

curl -i -X POST 'http://localhost:8000/v1/version' -d '{"version": "1.4.0dev13"}'

POST /v1/version HTTP/1.1
{
    "version": "1.4.0dev13"
}


HTTP/1.1 200
ACCESS-CONTROL-ALLOW-ORIGIN: *
CONNECTION: keep-alive
CONTENT-LENGTH: 31
CONTENT-TYPE: application/json
DATE: Thu, 08 Jan 2015 16:09:15 GMT
SERVER: Python/3.5 GNS3/1.4.0dev13
X-ROUTE: /v1/version

{
    "version": "1.4.0dev13"
}