Google Kubernetes Engine

View as Markdown

POST
/workspaces
/:workspace
/targets

Create a new Google Kubernetes Engine deployment target

Request

REQUIRED SCOPES

TARGET_ADD

URL PARAMETERS

workspacerequiredstring

The human-readable ID of the workspace

Example: "my-company"

POST PARAMETERS

typestring enum

The type of the target

Allowed enum:

GKE

urlread-onlystring

API endpoint to GET this object

html_urlread-onlystring

Web URL to view this object in Buddy.works

idstring

The ID of the target

identifierrequiredstring

A human-readable ID. Alphanumeric characters, underscores, and hyphens (hyphens cannot appear at the start or end).

namestring

The name of the target

projectShortProjectView

Short representation of a project

pipelineShortPipelineView

Short representation of a pipeline

environmentShortEnvironmentView

Short representation of an environment object

permissionsPermissionsView

Access permissions configuration

all_pipelines_allowedboolean

Indicates if all pipelines are allowed to use this target

allowed_pipelinesAllowedPipelineView[]

List of specific pipelines allowed to use this target

Constraints: Unique items required

disabledboolean

Indicates if this target is disabled (default: false)

tagsstring[]

The list of tags associated with the target

Constraints: Unique items required

integrationrequiredstring

The integration. Required when adding GKE/EKS/AKS/DOKS

clusterrequiredstring

The ID of the cluster or fully qualified identifier for the cluster. Required when the platform is set to GKE

regionstring

EKS region, e.g. eu-central-1

proxyTargetK8sProxyView

SSH proxy target for tunneling to private MySQL servers

zonerequiredstring

GKE zone. E.g., europe-west3-a

project_idrequiredstring

The ID of the Google Cloud project. Required for GOOGLE_SERVICE_ACCOUNT integration type with OIDC auth_type

Response

RESPONSE BODY

typestring enum

The type of the target

Allowed enum:

GKE

urlread-onlystring

API endpoint to GET this object

html_urlread-onlystring

Web URL to view this object in Buddy.works

idstring

The ID of the target

identifierrequiredstring

A human-readable ID. Alphanumeric characters, underscores, and hyphens (hyphens cannot appear at the start or end).

namestring

The name of the target

projectShortProjectView

Short representation of a project

pipelineShortPipelineView

Short representation of a pipeline

environmentShortEnvironmentView

Short representation of an environment object

permissionsPermissionsView

Access permissions configuration

all_pipelines_allowedboolean

Indicates if all pipelines are allowed to use this target

allowed_pipelinesAllowedPipelineView[]

List of specific pipelines allowed to use this target

Constraints: Unique items required

disabledboolean

Indicates if this target is disabled (default: false)

tagsstring[]

The list of tags associated with the target

Constraints: Unique items required

integrationrequiredstring

The integration. Required when adding GKE/EKS/AKS/DOKS

clusterrequiredstring

The ID of the cluster or fully qualified identifier for the cluster. Required when the platform is set to GKE

regionstring

EKS region, e.g. eu-central-1

proxyTargetK8sProxyView

SSH proxy target for tunneling to private MySQL servers

zonerequiredstring

GKE zone. E.g., europe-west3-a

project_idrequiredstring

The ID of the Google Cloud project. Required for GOOGLE_SERVICE_ACCOUNT integration type with OIDC auth_type

Last modified on Feb 18, 2026

Get target Edit target

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/targets" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "GKE",
  "identifier": "gke-production",
  "name": "GKE Production Cluster",
  "integration": "google-cloud-integration",
  "cluster": "production-cluster",
  "region": "us-central1",
  "project_id": "my-gcp-project",
  "zone": "us-central1-a",
  "tags": [
    "kubernetes",
    "gcp",
    "production"
  ]
}'

STATUS
201 Created