Replace

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

Info

List with common parameters for all Buddy actions

Request

URL PARAMETERS

workspacerequiredstring

The workspace name.

pipeline_idrequiredinteger

The numerical ID of the desired pipeline.

project_namerequiredstring

The name ID of the project.

POST PARAMETERS

namerequiredstring

The name of the action.

typerequiredstring

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

local_pathrequiredstring

The path in the repository.

replacementsrequiredReplacement[]

The list of pairs of strings for replacement.

Last modified on Jan 19, 2026

Raygun Rollbar notification

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/projects/:project_name/pipelines/:pipeline_id/actions" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Replace values",
  "type": "REPLACE",
  "trigger_time": "ON_EVERY_EXECUTION",
  "local_path": "/",
  "replacements": [
    {
      "replace_from": "[ENV]",
      "replace_to": "stage"
    },
    {
      "replace_from": "multiline",
      "replace_to": "Replace\nmultiline\nstring"
    }
  ]
}'

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions/2",
  "html_url": "https://app.buddy.works/buddy/company-website/pipelines/action/2/edit",
  "id": 2,
  "name": "Replace values",
  "type": "REPLACE",
  "trigger_time": "ON_EVERY_EXECUTION",
  "last_execution_status": "INITIAL",
  "local_path": "/",
  "replacements": [
    {
      "replace_from": "[ENV]",
      "replace_to": "stage"
    },
    {
      "replace_from": "multiline",
      "replace_to": "Replace\nmultiline\nstring"
    }
  ],
  "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"
  },
  "revision": "236afa836c2b5902077859c558efbd11351dcaac"
}

STATUS
201 Created