These endpoints allow you to view the available language and runtime versions for the build system, and the versions configured for a specific project.

Tip: You can explore and test these endpoints interactively using our OpenAPI documentation.

List All Available Language Versions

Returns all available language and runtime versions from the build server.

URL

/language_versions

HTTP Method

GET

Example cURL request

curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/language_versions

Example Response

{
  "node": ["22", "20", "18", "16"],
  "php": ["8.4", "8.3", "8.2", "8.1", "7.4"],
  "ruby": ["3.4", "3.3", "3.2", "3.1"]
}

Each key is the language name, and the value is an array of available version strings sorted from newest to oldest.

Get Project Language Versions

Returns the language versions currently configured for a specific project's default build environment.

URL

/projects/<project>/language_versions

Replace <project> with either the permalink or identifier of the project.

HTTP Method

GET

Example cURL request

curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/projects/my-project/language_versions

Example Response

{
  "node": "22",
  "php": "8.4",
  "ruby": "3.4"
}

Each key is the language name, and the value is the single version string configured for that project.