SSH command (Private key from environment variables)

POST
/workspaces
/:domain
/projects
/:project_name
/pipelines
/:pipeline_id
/actions

Hint

List with common parameters for all Buddy actions

Request

URL PARAMETERS

domainrequired string

The workspace domain.

pipeline_idrequired integer

The numerical ID of the desired pipeline.

project_namerequired string

The name ID of the project.

POST PARAMETERS

namerequired string

The name of the action.

typerequired string

The type of the action. Should be set to SSH_COMMAND.

authentication_moderequired string

The authentication mode for SSH. Should be set to ENV_KEY.

commandsrequired string[]

The array of commands invoked on the remote server.

hostrequired string

The host for the connection.

loginrequired string

The username required to connect to the server.

passwordrequired string

The password required to connect to the server.

portrequired string

The port for the connection.

env_keyrequired string

The private SSH key name defined in environment variables.

passphraseoptional string

The passphrase for the private SSH key.

run_as_scriptoptional boolean

If set to true, commands are executed as a regular script. If set to false, the commands will be executed one by one, in non-interactive mode.

shelloptional string

The name of the shell that will be used to execute commands. Can be one of SH (default) or BASH.

working_directoryoptional string

The absolute or relative path on the remote server.

execute_every_commandoptional boolean

If set to true all commands will be executed regardless of the result of the previous command.

Last modified on Oct 7, 2024

SSH command (Private key & password)Proxy

Example:

curl -X POST "https://api.buddy.works/workspaces/:domain/projects/:project_name/pipelines/:pipeline_id/actions" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Execute commands on localhost",
  "type": "SSH_COMMAND",
  "trigger_time": "ON_EVERY_EXECUTION",
  "authentication_mode": "ENV_KEY",
  "host": "localhost",
  "port": "22",
  "login": "api_tests_user",
  "passphrase": "api_tests_password",
  "password": "testtest",
  "working_directory": "/",
  "shell": "SH",
  "run_as_script": true,
  "ignore_errors": true,
  "commands": [
    "npm prune",
    "npm install --silent"
  ],
  "env_key": "MyKey"
}'

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions/858",
  "html_url": "https://app.buddy.works/buddy/company-website/pipelines/action/858/edit",
  "id": 858,
  "name": "Execute commands on localhost",
  "type": "SSH_COMMAND",
  "trigger_time": "ON_EVERY_EXECUTION",
  "last_execution_status": "INITIAL",
  "working_directory": "/",
  "shell": "SH",
  "run_as_script": true,
  "ignore_errors": true,
  "login": "root",
  "host": "localhost",
  "port": "22",
  "authentication_mode": "ENV_KEY",
  "env_key": "MyKey",
  "commands": [
    "npm prune",
    "npm install --silent"
  ],
  "pipeline": {
    "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2",
    "html_url": "https://app.buddy.works/buddy/company-website/pipelines/pipeline/2",
    "id": 2,
    "name": "Live mirror",
    "on": "CLICK",
    "refs": [
      "refs/heads/master"
    ],
    "last_execution_status": "SUCCESSFUL",
    "last_execution_revision": "506a3963507943d6908154f4bc9646e829128a08"
  }
}

STATUS
201 Created

LIMITS
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999