Create

POST
/workspaces
/:workspace
/targets

Creates a Amazon Elastic Kubernetes Service Target.

Request

REQUIRED SCOPES

TARGET_ADD

URL PARAMETERS

workspacerequiredstring

The workspace name.

POST PARAMETERS

namerequiredstring

The name of the target

identifierrequiredstring

Readable ID for target. It can consist of uppercase and lowercase letters, numbers, and underscores. It must start with a letter.

typerequiredString

The type of the target. For AKS use AKS.

integrationrequiredstring

Identifier of the integration.

clusterrequiredstring

Address of the cluster.

regionrequiredstring

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

role_arnstring

Amazon resource name specifying the role.

projectproject

Set this if you want to add the target to a project. Must contain field name (string).

pipelinepipeline

Set this if you want to add the target to a pipeline. Must contain field id (integer).

environmentenvironment

Set this if you want to add the target to an environment. Must contain field id (string).

permissionsPipelinePermissions

Define to set permissions for the target.

pathstring

Path on the server defined in the target.

disabledboolean

When set to true the target is disabled. By default it is set to false.

tagsstring[]

A list of tags associated with the target.

Last modified on Jan 19, 2026

Edit Edit

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/targets" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "tg-u0t7lns1iymq3",
  "identifier": "eks_workspace",
  "tags": [
    "orange",
    "rabsperry",
    "olive"
  ],
  "name": "EKS WORKSPACE",
  "integration": "AMAZON_DEFAULT_group",
  "cluster": "https://192.168.12.123:6464",
  "region": "eu-central-1",
  "role_arn": "arn:aws:iam::123456789012:role/eks-cluster-service-role",
  "type": "EKS"
}'

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/targets/tg-tkeoqrx7shvrd",
  "html_url": "https://app.buddy.works/buddy/-/targets/tg-tkeoqrx7shvrd/edit",
  "id": "tg-tkeoqrx7shvrd",
  "identifier": "eks_workspace",
  "permissions": {
    "others": "USE_ONLY",
    "users": [
      {
        "id": 1,
        "access_level": "MANAGE"
      }
    ]
  },
  "tags": [
    "orange",
    "rabsperry",
    "olive"
  ],
  "name": "EKS WORKSPACE",
  "integration": "AMAZON_DEFAULT_group",
  "cluster": "https://192.168.12.123:6464",
  "region": "eu-central-1",
  "role_arn": "arn:aws:iam::123456789012:role/eks-cluster-service-role",
  "type": "EKS"
}