Acquia

Acquia Teams and Permissions API

The Teams and Permissions API from Acquia — 10 operation(s) for teams and permissions.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 17

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 /permissions List all available permissions · Return a list of permissions #
Ask an LLM
“What permissions exist in the Acquia Cloud Platform?”
“Can I see every permission a role could grant, even ones I don't have?”
Tell an agent
List every permission available in the system.
Show the full catalog of role permissions.
GET /roles/{roleUuid} Get details of a role · Return details about a specific role #
Ask an LLM
“Which permissions does a particular role grant?”
“Can I look up a role by its UUID?”
Tell an agent
Show role {roleUuid}.
Get the permissions granted by role {roleUuid}.
DELETE /roles/{roleUuid} Delete a role · Deletes a specific role by its UUID #
Ask an LLM
“How do I delete a custom role we no longer use?”
“Can I remove a role from my organization?”
Tell an agent destructive · confirm first
Delete role {roleUuid}.
Remove the role {roleUuid} from the organization.
PUT /roles/{roleUuid} Update a role · Updates a role #
Ask an LLM
“Can I change which permissions a role grants?”
“How do I rename a custom role or edit its description?”
Tell an agent
Set role {roleUuid} permissions to {permissions}.
Rename role {roleUuid} to {name} with description {description}.
GET /teams List the teams I can access · Return teams the current user has access to #
Ask an LLM
“Which teams do I have access to?”
“Can I search my teams by name?”
Tell an agent
List all teams I have access to.
Show my teams matching {filter}.
GET /teams/{teamUuid} Get details of a team · Return details about a specific team #
Ask an LLM
“What details are stored about a specific team?”
“Can I look up a team by UUID?”
Tell an agent
Show team {teamUuid}.
Get the details of team {teamUuid}.
PUT /teams/{teamUuid} Rename a team · Change the name of a team #
Ask an LLM
“Can I change a team's name?”
“How do I rename a team?”
Tell an agent
Rename team {teamUuid} to {name}.
Change the name of team {teamUuid} to {name}.
DELETE /teams/{teamUuid} Delete a team · Deletes a specific team by its UUID #
Ask an LLM
“How do I delete a team entirely?”
“Can I remove a team that's no longer needed?”
Tell an agent destructive · confirm first
Delete team {teamUuid}.
Permanently remove team {teamUuid}.
POST /teams/{teamUuid}/actions/leave Leave a team · Removes the current user from a team #
Ask an LLM
“Can I remove myself from a team?”
“How do I leave a team I was added to?”
Tell an agent
Take me off team {teamUuid}.
Leave team {teamUuid}.
GET /teams/{teamUuid}/applications List applications a team can access · Returns a list of applications this team has access to #
Ask an LLM
“Which applications does this team have access to?”
“Can I filter a team's applications by name?”
Tell an agent
List applications available to team {teamUuid}.
Show team {teamUuid} applications matching {filter}.
POST /teams/{teamUuid}/applications Give a team access to an application · Adds an application to this team #
Ask an LLM
“How do I grant a team access to one of my applications?”
“Can I add an application to an existing team?”
Tell an agent
Add application {uuid} to team {teamUuid}.
Grant team {teamUuid} access to application {uuid}.
DELETE /teams/{teamUuid}/applications/{applicationUuid} Remove an application from a team · Removes the application from this team #
Ask an LLM
“Can I revoke a team's access to an application?”
“Will team members lose access immediately if I remove an app from their team?”
Tell an agent destructive · confirm first
Remove application {applicationUuid} from team {teamUuid}.
Revoke team {teamUuid}'s access to application {applicationUuid}.
GET /teams/{teamUuid}/invites List a team's pending invitations · Returns a list of invitations to this team #
Ask an LLM
“Who has been invited to this team but not joined yet?”
“Can I filter a team's invitations by email?”
Tell an agent
List invitations for team {teamUuid}.
Show team {teamUuid} invites matching {filter}.
POST /teams/{teamUuid}/invites Invite a user to a team · Invites a user to join a team #
Ask an LLM
“How do I invite a colleague to join a team?”
“Can I pick their roles when I send a team invite?”
Tell an agent
Invite {email} to team {teamUuid} with roles {roles}.
Send a team {teamUuid} invitation to {email} granting {roles}.
GET /teams/{teamUuid}/members List a team's members · Returns a list of team members #
Ask an LLM
“Who are the members of this team?”
“Can I filter team members by last name or permission?”
Tell an agent
List members of team {teamUuid}.
Show team {teamUuid} members matching {filter}.
PUT /teams/{teamUuid}/members/{userUuid} Set a team member's roles · Grant team roles to a member #
Ask an LLM
“How do I change the roles a teammate holds?”
“Can I grant additional roles to an existing team member?”
Tell an agent
Give member {userUuid} of team {teamUuid} the roles {roles}.
Set roles {roles} for user {userUuid} in team {teamUuid}.
DELETE /teams/{teamUuid}/members/{userUuid} Remove a member from a team · Remove a user from a team #
Ask an LLM
“How do I remove someone else from a team?”
“Can I kick a user off a team I administer?”
Tell an agent destructive · confirm first
Remove user {userUuid} from team {teamUuid}.
Kick member {userUuid} out of team {teamUuid}.

Documentation

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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/acquia/refs/heads/main/openapi/acquia-teams-and-permissions-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-teams-and-permissions-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-teams-and-permissions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Acquia Cloud API Documentation Teams and Permissions 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 (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/acquia/refs/heads/main/openapi/acquia-teams-and-permissions-api-openapi.yml