Heroku

  • POST
  • /workspaces
  • /:workspace
  • /projects
  • /:project_name
  • /pipelines
  • /:pipeline_id
  • /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 HEROKU.
application_namerequiredstring
The name of the application.
integrationrequiredIntegration
The integration.
use_custom_gitignoreboolean
When set to true the push will ignore paths listed in .gitignore file.
isolatedboolean
When set to true, action will push only repository files (without artifacts).
deployment_excludesstring[]
The paths and/or files that will be left out during the push. Only works when use_custom_gitignore is set to true.
deployment_includesstring[]
The exceptions from the ignore patterns set in deployment_excludes.
without_forceboolean
Defines whether the --force flag should be used when invoking the git push command or not.

Last modified on Jan 19, 2026

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": "Push to Your Repo", "type": "HEROKU", "trigger_time": "ON_EVERY_EXECUTION", "use_custom_gitignore": true, "isolated": true, "integration": { "identifier": "5ddb7c180fb38be67bd78a88a" }, "application_name": "AppName", "deployment_excludes": [ "/tmp/", "*.log" ], "deployment_includes": [ "/assets/style", "/tmp/file.txt" ] }'

Response

EXAMPLE RESPONSE
{ "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/1/actions/1", "html_url": "https://app.buddy.works/buddy/company-website/pipelines/pipeline/1/action/1/edit", "id": 1, "name": "Deploy application to Heroku", "type": "HEROKU", "trigger_time": "ON_EVERY_EXECUTION", "last_execution_status": "INITIAL", "application_name": "AppName", "use_custom_gitignore": true, "isolated": true, "integration": { "url": "https://api.buddy.works/workspaces/buddy/user/integrations/1", "html_url": "https://app.buddy.works/my-id", "identifier": "5ddb7c180fb38be67bd78a88a" }, "deployment_excludes": [ "/tmp/", "*.log" ], "deployment_includes": [ "/assets/style", "/tmp/file.txt" ], "pipeline": { "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/1", "html_url": "https://app.buddy.works/buddy/company-website/pipelines/pipeline/1", "id": 1, "name": "test server", "on": "CLICK", "refs": [ "refs/heads/master" ], "last_execution_status": "SUCCESSFUL", "last_execution_revision": "506a3963507943d6908154f4bc9646e829128a08" } }
STATUS
201 Created