Acquia

Acquia Codebases API

The Codebases API from Acquia — 8 operation(s) for codebases.

GitHub OpenAPI

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /codebases/{codebaseId}/bulk-code-switch List past bulk code switches on a codebase · Retrieves a list of bulk code switches details performed on a codebase #
Ask an LLM
“What bulk code switches have already been run against a codebase?”
“Can I page through the history of bulk code switch operations for one codebase?”
Tell an agent
List the bulk code switches performed on codebase {codebase}.
Show the {limit} most recent bulk code switches on codebase {codebase}.
POST /codebases/{codebaseId}/bulk-code-switch Switch many environments to one git reference · Starts a new Bulk Code Switch for a codebase #
Ask an LLM
“How do I move several environments to the same branch or tag in one go?”
“Can a bulk code switch run Cloud Actions on each target afterward?”
Tell an agent
Start a bulk code switch on codebase {codebase} to reference {reference} for targets {targets}.
Switch environments {targets} of codebase {codebase} to {reference} in bulk and run cloud actions {cloud_actions}.
GET /codebases/{codebaseId}/bulk-code-switch/{bulkCodeSwitchId} Check on one bulk code switch · Retrieves bulk code switch details by id #
Ask an LLM
“Did a particular bulk code switch finish, and which targets did it touch?”
“What are the details of one bulk code switch by its ID?”
Tell an agent
Get bulk code switch {switch} on codebase {codebase}.
Show the status of bulk switch {switch} for codebase {codebase}.
GET /applications/{applicationId}/codebase Find the codebase linked to an application · Retrieves a codebase details linked to the specified application #
Ask an LLM
“Which codebase is an application built from?”
“Can I look up the codebase attached to a given application ID?”
Tell an agent
Show the codebase linked to application {application}.
Find which codebase application {application} uses.
GET /codebases List all codebases I can access · Retrieves a list of codebases accessible by the user #
Ask an LLM
“What codebases do I have access to across Acquia?”
“Which codebases can my user account see?”
Tell an agent
List every codebase I can access.
Show all the codebases available to my user.
GET /codebases/{codebaseId} View details of one codebase · Retrieves a codebase details by its ID #
Ask an LLM
“What are the label, description and details of a specific codebase?”
“Can I pull up a single codebase by its ID?”
Tell an agent
Get the details of codebase {codebase}.
Open codebase {codebase} and tell me what's in it.
PUT /codebases/{codebaseId} Rename or redescribe a codebase · Update a codebase details by its ID #
Ask an LLM
“How do I change the label shown for a codebase?”
“Can I edit a codebase's description after it's created?”
Tell an agent
Rename codebase {codebase} to {label}.
Set the description of codebase {codebase} to {description}.
DELETE /codebases/{codebaseId} Delete a codebase · Delete a codebase by its ID #
Ask an LLM
“Can I permanently remove a codebase I no longer use?”
“What's the way to delete a codebase by its ID?”
Tell an agent destructive · confirm first
Delete codebase {codebase}.
Remove codebase {codebase} entirely.
GET /subscriptions/{subscriptionId}/codebases List codebases under a subscription · Retrieves a list of codebases by subscription ID #
Ask an LLM
“Which codebases belong to one of my subscriptions?”
“How many codebases does a given subscription hold?”
Tell an agent
List the codebases in subscription {subscription}.
Show every codebase attached to subscription {subscription}.
OPTIONS /subscriptions/{subscriptionId}/codebases See regions available for a new codebase · Gets supported regions for a new codebase #
Ask an LLM
“Which regions can I create a new codebase in for this subscription?”
“Where is a new codebase allowed to be hosted under my subscription?”
Tell an agent
Show the supported regions for a new codebase in subscription {subscription}.
Check which hosting regions subscription {subscription} allows for new codebases.
GET /codebases/{codebaseId}/references List git branches and tags in a codebase · Retrieves a list of git references by codebase #
Ask an LLM
“What branches and tags exist in a codebase's git repository?”
“Which git references could I deploy from this codebase?”
Tell an agent
List the git references in codebase {codebase}.
Show all branches and tags available in codebase {codebase}.
GET /codebases/{codebaseId}/references/{referenceName} View one git reference in a codebase · Retrieves a single git reference data for the given codebase #
Ask an LLM
“What commit does a particular branch or tag point to in my codebase?”
“Does a specific git reference exist in this codebase?”
Tell an agent
Get git reference {reference} from codebase {codebase}.
Look up the {reference} branch or tag in codebase {codebase}.

Documentation

📖
Documentation
https://cloudapi-docs.acquia.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/acquia/refs/heads/main/openapi/acquia-codebases-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/acquia:acquia-codebases-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

acquia-codebases-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Acquia Cloud API Documentation Codebases API
  x-logo:
    url: assets/cloud-platform.svg
    backgroundColor: '#FFFFFF'
    altText: Acquia Cloud
  description: 'Acquia Cloud API


    # Compatibility


    ## Stability


    The response for all resource endpoints includes an `X-CloudAPI-Stability` header that indicates what changes, if any, Acquia will make to the resource and how changes will be communicated.'
  version: 2.0.0
  contact:
    name: Customer Experience Engineering (CXE)
    url: https://www.acquia.com
tags:


# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/acquia/refs/heads/main/openapi/acquia-codebases-api-openapi.yml