Test variables

TFS 2017 | TFS 2015 | TFS 2013

Note

Looking for REST APIS that support TFS 2018 or later versions? See the Azure DevOps REST API Reference.

api-version = 3.0-preview

If you haven't already, look at the information on getting started with these APIs.

Get a list of test variables

GET https://{instance}/DefaultCollection/{project}/_apis/test/variables?api-version={version}[&$skip={int}&$top={int}]

Parameter	Type	Default	Notes
URL
instance	string		TFS server name ({server:port}).
project	string		Name or ID of the project.
Query
api-version	string		Version of the API to use.
$skip	int		Number of test variables to skip.
$top	int		Number of test variables to return.

Sample request

GET https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/variables?api-version=3.0-preview.1

Sample response

{
  "value": [
    {
      "id": 1,
      "name": "Operating System",
      "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/1",
      "project": {
        "name": "fabrikam-fiber-tfvc",
        "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
      },
      "description": "Default operating systems",
      "revision": 1,
      "values": [
        "Windows 10",
        "Windows 7",
        "Windows 8",
        "Windows 8.1"
      ]
    },
    {
      "id": 2,
      "name": "Browser",
      "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/2",
      "project": {
        "name": "fabrikam-fiber-tfvc",
        "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
      },
      "description": "Default browsers",
      "revision": 1,
      "values": [
        "Chrome",
        "Edge",
        "FireFox",
        "Internet Explorer 11.0",
        "Safari"
      ]
    },
    {
      "id": 3,
      "name": "Renamed Language",
      "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/3",
      "project": {
        "name": "fabrikam-fiber-tfvc",
        "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
      },
      "description": "Language for testing",
      "revision": 2,
      "values": [
        "English - UK",
        "English - US",
        "Japanese"
      ]
    }
  ],
  "count": 3
}

A page at a time

Sample request

GET https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/variables?$top=2&api-version=3.0-preview.1

Sample response

{
  "value": [
    {
      "id": 2,
      "name": "Browser",
      "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/2",
      "project": {
        "name": "fabrikam-fiber-tfvc",
        "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
      },
      "description": "Default browsers",
      "revision": 1,
      "values": [
        "Chrome",
        "Edge",
        "FireFox",
        "Internet Explorer 11.0",
        "Safari"
      ]
    },
    {
      "id": 3,
      "name": "Renamed Language",
      "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/3",
      "project": {
        "name": "fabrikam-fiber-tfvc",
        "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
      },
      "description": "Language for testing",
      "revision": 2,
      "values": [
        "English - UK",
        "English - US",
        "Japanese"
      ]
    }
  ],
  "count": 2
}

Get a test variable

GET https://{instance}/DefaultCollection/{project}/_apis/test/variables/{variableId}?api-version={version}

Parameter	Type	Notes
URL
instance	string	TFS server name ({server:port}).
project	string	Name or ID of the project.
variableId	int	ID of the test variable to get.
Query
api-version	string	Version of the API to use.

Sample request

GET https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/variables/1?api-version=3.0-preview.1

Sample response

{
  "id": 1,
  "name": "Operating System",
  "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/1",
  "project": {
    "name": "fabrikam-fiber-tfvc",
    "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
  },
  "description": "Default operating systems",
  "revision": 1,
  "values": [
    "Windows 10",
    "Windows 7",
    "Windows 8",
    "Windows 8.1"
  ]
}

Create a test variable

POST https://{instance}/DefaultCollection/{project}/_apis/test/variables?api-version={version}

Content-Type: application/json

{
  "name": {string},
  "description": {string},
  "values": {Array of string}
}

Parameter	Type	Default	Notes
URL
instance	string		TFS server name ({server:port}).
project	string		Name or ID of the project.
Query
api-version	string		Version of the API to use.
Body
name	string		Name of the new test variable.
description	string		Description of the new test variable.
values	string		List of values allowed for the test variable.

Sample request

POST https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/variables?api-version=3.0-preview.1

{
  "name": "Language",
  "description": "Language for testing",
  "values": [
    "English - US",
    "English - UK"
  ]
}

Sample response

{
  "id": 3,
  "name": "Language",
  "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/3",
  "project": {
    "name": "fabrikam-fiber-tfvc",
    "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
  },
  "description": "Language for testing",
  "revision": 1,
  "values": [
    "English - UK",
    "English - US"
  ]
}

Update a test variable

PATCH https://{instance}/DefaultCollection/{project}/_apis/test/variables/{variableId}?api-version={version}

Content-Type: application/json

{
  "name": {string},
  "description": {string},
  "values": {Array of string}
}

Parameter	Type	Default	Notes
URL
instance	string		TFS server name ({server:port}).
project	string		Name or ID of the project.
variableId	int		ID of the test variable to update.
Query
api-version	string		Version of the API to use.
Body
name	string		Name of the test variable.
description	string		Description of the test variable.
values	string		List of values allowed for the test variable.

Sample request

PATCH https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/variables/3?api-version=3.0-preview.1

{
  "values": [
    "English - US",
    "English - UK",
    "Japanese"
  ]
}

Sample response

{
  "id": 3,
  "name": "Renamed Language",
  "url": "https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/Variables/3",
  "project": {
    "name": "fabrikam-fiber-tfvc",
    "url": "https://mytfsserver/DefaultCollection/_apis/projects/fabrikam-fiber-tfvc"
  },
  "description": "Language for testing",
  "revision": 2,
  "values": [
    "English - UK",
    "English - US",
    "Japanese"
  ]
}

Delete a test variable

DELETE https://{instance}/DefaultCollection/{project}/_apis/test/variables/{variableId}?api-version={version}

Parameter	Type	Notes
URL
instance	string	TFS server name ({server:port}).
project	string	Name or ID of the project.
variableId	int	ID of the test variable to delete.
Query
api-version	string	Version of the API to use.

Sample request

DELETE https://mytfsserver/DefaultCollection/fabrikam-fiber-tfvc/_apis/test/variables/1?api-version=3.0-preview.1