Create target with YAML

POST
/workspaces
/:workspace
/targets
/yaml

Create a new target in the workspace, project, pipeline or environment scope by sending its full YAML definition in a POST request.

Request

REQUIRED SCOPES

TARGET_WRITE

URL PARAMETERS

workspacerequiredstring

The human-readable ID of the workspace

Example: "my-company"

GET PARAMETERS

project_namestring

Filter targets by project name

Example: "my-project"

pipeline_idinteger

Filter targets by pipeline ID

Example: 12345

environment_idstring

Filter targets by environment ID

Example: "67890"

BODY PARAMETERS

yamlstring

The Base64-encoded YAML definition of the target

Response

RESPONSE BODY

variantsvariants

Type-specific parameters based on discriminator value

Last modified on Aug 18, 2026

Delete target Export target

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/targets/yaml" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "yaml": "LSB0YXJnZXQ6..."
}'