Install Self-Hosted
Get Started on Cloud
BasicsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesSelf-HostedAgents & TunnelsYAML

DigitalOcean Droplet

View as Markdown
  • POST
  • /workspaces
  • /:workspace
  • /targets

Create a new DigitalOcean Droplet 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:
DIGITAL_OCEAN
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

hostrequiredstring
The host for the connection
portrequiredstring
The port for the connection
pathstring
Path on the server defined in the target
authrequiredSSHAuthView
Define proxy servers' authentication method using the following parameters
proxyTargetSSHProxyView
Define a SSH proxy server using the following parameters (available only for SSH targets)
integrationrequiredstring
The integration. Required when adding GKE/EKS/AKS/DOKS

Response

RESPONSE BODY
typestring enum
The type of the target
Allowed enum:
DIGITAL_OCEAN
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

hostrequiredstring
The host for the connection
portrequiredstring
The port for the connection
pathstring
Path on the server defined in the target
authrequiredSSHAuthView
Define proxy servers' authentication method using the following parameters
proxyTargetSSHProxyView
Define a SSH proxy server using the following parameters (available only for SSH targets)
integrationrequiredstring
The integration. Required when adding GKE/EKS/AKS/DOKS

Last modified on Feb 18, 2026

Previous pageGet targetNext pageEdit 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": "DIGITAL_OCEAN",
  "identifier": "do-droplets",
  "name": "DigitalOcean Droplets",
  "integration": "digitalocean-integration",
  "region": "nyc3",
  "tags": [
    "digitalocean",
    "droplets"
  ]
}'
STATUS
201 Created