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

FTP Server

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

Create a new FTP Server 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:
FTP
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

secureboolean
FTP secure connection (FTPS)
hostrequiredstring
The host for the connection
portrequiredstring
The port for the connection
authrequiredFTPAuthView
Authentication details
pathstring
Path on the server defined in the target

Response

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

secureboolean
FTP secure connection (FTPS)
hostrequiredstring
The host for the connection
portrequiredstring
The port for the connection
authrequiredFTPAuthView
Authentication details
pathstring
Path on the server defined in the target

Last modified on Feb 18, 2026

Previous pageGet targetNext pageEdit target

Examples

FTP TargetFTPS Target (Secure FTP)

Example: FTP Target

curl -X POST "https://api.buddy.works/workspaces/:workspace/targets" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "FTP",
  "identifier": "ftp-server",
  "name": "FTP File Server",
  "host": "ftp.example.com",
  "port": "21",
  "path": "/public_html",
  "auth": {
    "username": "ftpuser",
    "password": "ftppass123"
  },
  "secure": false,
  "tags": [
    "ftp",
    "files"
  ]
}'

Example: FTPS Target (Secure FTP)

curl -X POST "https://api.buddy.works/workspaces/:workspace/targets" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "FTP",
  "identifier": "ftps-secure-server",
  "name": "FTPS Secure File Server",
  "host": "ftps.example.com",
  "port": "21",
  "path": "/var/www/secure",
  "auth": {
    "username": "ftpsuser",
    "password": "ftpspass123"
  },
  "secure": true,
  "tags": [
    "ftps",
    "secure",
    "files"
  ]
}'
STATUS
201 Created