Last updated on 15th September 2026

Get a global build command via API

This method returns the details of a single global build command template, identified by its identifier.

Tip: You can explore and test this endpoint interactively using our OpenAPI documentation.

URL

/global_build_commands/:identifier

HTTP Method

GET

Example cURL Request

curl -H "Accept: application/json" \
--user your-email@example.com:your-api-key \
https://test.deployhq.com/global_build_commands/df8966fe-e161-4517-98e2-24f79102dd62

Example Response

{
  "identifier": "df8966fe-e161-4517-98e2-24f79102dd62",
  "description": "Install dependencies",
  "command": "npm ci",
  "halt_on_error": true,
  "source": "global"
}

Error Responses

  • 401 Unauthorized - the email address or API key is missing or incorrect
  • 403 Forbidden - your user is not an account administrator
  • 404 Not Found - no global build command matches the supplied identifier