Buddy

Name: Buddy API
Brand: Buddy
Availability: InStock

✓ Official Vendor SpecDeveloper ToolsCi Cdbearer24 EndpointsREST

For Agents

Manage Buddy CI/CD projects, pipelines, actions, and environments and read commits, branches, and tags from the connected repository.

Quickstart

Get started with Buddy in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"create a Buddy pipeline"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Buddy API.

Create and configure Buddy projects with linked Git repositories under a workspace

Define pipelines with triggers (push, manual, scheduled) and ordered actions per project

Add, update, and remove pipeline actions such as build, deploy, Slack, and SSH steps

Manage workspace-level environment variables for use across pipelines

GET STARTED

Start building with Buddy API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Buddy API for, with concrete tasks.

★ Programmatic Pipeline Provisioning

Stand up consistent CI/CD pipelines across many Buddy projects by scripting createProject, createPipeline, and addAction calls instead of clicking through the Buddy UI. The same script can apply identical lint, test, and deploy stages to every microservice and update them in place via updatePipeline and updateAction. Useful for platform teams maintaining dozens of services on Buddy.

Call createProject for the new repo, then createPipeline with trigger 'ON_EVERY_PUSH', then addAction for build, test, and deploy steps in order

ChatOps Deployment Triggering

Wire a Slack or chat command to fetch the latest commit on a branch via /workspaces/{workspace}/projects/{projectName}/repository/branches and trigger the deploy pipeline by updating its triggering metadata. The bearer-token model lets a chat bot run on a service account so engineers can ship from chat without leaving the conversation. Buddy returns the resulting build status which the bot can post back.

Call listBranches to confirm the branch exists, then update the pipeline to start it, and post the resulting status back to Slack

Repository Activity Monitoring

Surface repository activity in dashboards and ops tools by listing commits, branches, and tags from /workspaces/{workspace}/projects/{projectName}/repository/*. Engineering managers can see which branches are stale, what tags were cut last release, and which commits are queued for the next deploy without giving every viewer access to the underlying Git host.

Call listCommits for the project with branch=main and limit=20 to render the recent commit list in the dashboard

AI Agent CI/CD Through Jentic

Allow an AI agent to provision pipelines and trigger deploys on Buddy without holding the personal access token. Through Jentic, the agent searches by intent, loads the createPipeline schema, and executes against /workspaces/{workspace}/projects/{projectName}/pipelines with the requested configuration. Buddy's bearer token is stored in the Jentic vault and injected at execution time so credentials never enter the agent's context.

Use Jentic to search 'create a Buddy pipeline', load the createPipeline schema, and execute against the chosen workspace and project

Key Endpoints

24 endpoints — buddy is a ci/cd platform api for managing workspaces, projects, pipelines, actions, environments, and git repository data on buddy.

METHOD

PATH

DESCRIPTION

POST

/workspaces/{workspace}/projects

Create a project under a workspace

GET

/workspaces/{workspace}/projects

List projects in a workspace

POST

/workspaces/{workspace}/projects/{projectName}/pipelines

Create a pipeline on a project

GET

/workspaces/{workspace}/projects/{projectName}/pipelines

List pipelines on a project

POST

/workspaces/{workspace}/projects/{projectName}/pipelines/{pipelineId}/actions

Add an action to a pipeline

GET

/workspaces/{workspace}/projects/{projectName}/repository/commits

List repository commits

GET

/workspaces/{workspace}/projects/{projectName}/repository/branches

List repository branches

POST

/workspaces/{workspace}/environment

Create a workspace environment variable

POST

/workspaces/{workspace}/projects

Create a project under a workspace

GET

/workspaces/{workspace}/projects

List projects in a workspace

POST

/workspaces/{workspace}/projects/{projectName}/pipelines

Create a pipeline on a project

GET

/workspaces/{workspace}/projects/{projectName}/pipelines

List pipelines on a project

POST

/workspaces/{workspace}/projects/{projectName}/pipelines/{pipelineId}/actions

Add an action to a pipeline

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Buddy personal access tokens are stored encrypted in the Jentic vault. Jentic injects the token as the Authorization: Bearer header at execution time so the raw token never appears in the agent's prompt, logs, or browser network tabs.

Intent-based discovery

Agents search by intent (e.g., 'create a Buddy pipeline') and Jentic returns the matching createPipeline operation with its schema, so the agent calls /workspaces/{workspace}/projects/{projectName}/pipelines without browsing Buddy's docs.

Time to first call

Direct Buddy integration: 1-2 days for OAuth handling, pipeline DSL construction, and action ordering. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Bubble Data API

Stores Buddy build and deploy metadata in a no-code Bubble app for non-technical visibility

Use when an internal Bubble dashboard should show Buddy deploy status for stakeholders without Buddy access

Complementary

Buffer API

Schedules release announcement posts after a successful Buddy deploy

Pair with Buddy when an agent should post a release note when a deploy pipeline completes

Alternative

Buddyyen API

Different vendor with a similarly-named integration surface

Distinguish carefully — Buddyyen is unrelated to Buddy CI/CD; only use when the workflow specifically targets Buddyyen

FAQs

Specific to using Buddy API through Jentic.

What authentication does the Buddy API use?

Buddy uses OAuth 2.0 bearer tokens. Generate a personal access token in Buddy under My Profile → Access Tokens and send Authorization: Bearer <token> on every request. Through Jentic the access token is stored encrypted in the vault and injected at execution time so the raw token never enters the agent's context.

Can I create a Buddy pipeline programmatically?

Yes. POST to /workspaces/{workspace}/projects/{projectName}/pipelines with a JSON body specifying name, on (e.g., ON_EVERY_PUSH or CLICK), refs (branches), and any priority. Then add steps with addAction at /workspaces/{workspace}/projects/{projectName}/pipelines/{pipelineId}/actions. Each action specifies a type such as BUILD, DEPLOY, or SLACK.

What are the rate limits for the Buddy API?

Buddy applies per-workspace rate limits that are not encoded in the spec. The API returns 429 responses when a client exceeds its share, and clients should back off before retrying. See buddy.works/docs/api for current per-plan limits.

How do I trigger a Buddy deployment through Jentic?

Install the SDK with pip install jentic, search for 'trigger a Buddy pipeline', load the relevant pipeline-update schema, and execute against /workspaces/{workspace}/projects/{projectName}/pipelines/{pipelineId}. Jentic injects the bearer token from the vault and returns the run details.

Can I read commits and branches from the Buddy API?

Yes. GET /workspaces/{workspace}/projects/{projectName}/repository/commits returns the commit list, with a query parameter for branch and a limit. /repository/branches and /repository/tags return the branches and tags on the connected repository. These endpoints proxy to the underlying Git host that Buddy is connected to.

Is the Buddy API free?

Buddy offers a free tier with limited concurrent runs and projects, plus paid plans (Pro and Hyper) with higher capacity. API access is available on all plans; rate limits and concurrency scale with the tier. See buddy.works/pricing for current details.