Vultr Server

View as Markdown

PATCH
/workspaces
/:workspace
/targets
/:target_id

Update Vultr Server target configuration

Request

REQUIRED SCOPES

TARGET_MANAGE

URL PARAMETERS

workspacerequiredstring

The human-readable ID of the workspace

Example: "my-company"

target_idrequiredstring

Target unique identifier (hash ID)

Example: "tgt-1234567890abcdef"

POST PARAMETERS

typestring enum

The type of the target

Allowed enum:

VULTR

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:

VULTR

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

Create target Get target

Request example


curl -X PATCH "https://api.buddy.works/workspaces/:workspace/targets/:target_id" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "VULTR",
  "identifier": "vultr-instances",
  "name": "Vultr Server Instances",
  "integration": "vultr-integration",
  "region": "ewr",
  "tags": [
    "vultr",
    "servers"
  ]
}'

STATUS
200 OK