Acquia · Capability

Acquia Cloud API Documentation — Subscriptions

Acquia Cloud API Documentation — Subscriptions. 31 operations. Lead operation: Return a list of subscription.. Self-contained Naftiko capability covering one Acquia business surface.

Run with Naftiko AcquiaSubscriptions

What You Can Do

GET
Getsubscriptions — Return a list of subscription.
/v1/subscriptions
GET
Getsubscription — Return details about a specific subscription.
/v1/subscriptions/{subscriptionuuid}
PUT
Putsubscription — Modifies a subscription.
/v1/subscriptions/{subscriptionuuid}
GET
Getsubscriptionapplications — Provides a list of applications that are a part of the subscription.
/v1/subscriptions/{subscriptionuuid}/applications
GET
Getcodestudiosubscriptionmetadata — Retrieves Code Studio metadata for a subscription.
/v1/subscriptions/{subscriptionuuid}/code-studio
OPTIONS
Optionscodestudio — Displays Code Studio options for a subscription.
/v1/subscriptions/{subscriptionuuid}/code-studio
POST
Postenablecodestudio — Enables Code Studio for a subscription.
/v1/subscriptions/{subscriptionuuid}/code-studio/actions/enable
GET
Getcodestudioapplications — Retrieves a list of Code Studio enabled applications for a subscription.
/v1/subscriptions/{subscriptionuuid}/code-studio/applications
GET
Getcodestudiousers — Retrieves a list of users assigned to Code Studio for a subscription.
/v1/subscriptions/{subscriptionuuid}/code-studio/users
POST
Postcodestudiousers — Assigns a user to a Code Studio seat for a subscription.
/v1/subscriptions/{subscriptionuuid}/code-studio/users
GET
Getcodestudiouser — Retrieves details about a specific Code Studio user.
/v1/subscriptions/{subscriptionuuid}/code-studio/users/{useruuid}
DELETE
Deletecodestudiouser — Unassigns a user from a Code Studio seat.
/v1/subscriptions/{subscriptionuuid}/code-studio/users/{useruuid}
GET
Getsubscriptiondomainregistrations — Returns a list of Domains registered with this subscription.
/v1/subscriptions/{subscriptionuuid}/domains
POST
Postsubscriptiondomainregistration — Registers a Domain with this subscription.
/v1/subscriptions/{subscriptionuuid}/domains
GET
Getsubscriptiondomainregistration — Returns a speicific Domain registered with this subscription.
/v1/subscriptions/{subscriptionuuid}/domains/{domainregistrationuuid}
DELETE
Deletesubscriptiondomainregistration — Unregisters a Domain registered with this subscription.
/v1/subscriptions/{subscriptionuuid}/domains/{domainregistrationuuid}
POST
Postsubscriptionverifydomainregistration — Triggers re-verification and update to the domain verification status.
/v1/subscriptions/{subscriptionuuid}/domains/{domainregistrationuuid}/actions/verify
GET
Getsubscriptionentitlements — Provides a list of entitlements that are a part of the subscription.
/v1/subscriptions/{subscriptionuuid}/entitlements
GET
Getsubscriptionides — Returns a list of Cloud IDEs associated with this subscription.
/v1/subscriptions/{subscriptionuuid}/ides
GET
Getsubscriptionsusagelinks — Retrieves traversal links for a subscription's usage data.
/v1/subscriptions/{subscriptionuuid}/metrics/usage
GET
Getsubscriptionsusagedata — Retrieves aggregate usage data for a subscription.
/v1/subscriptions/{subscriptionuuid}/metrics/usage/data
GET
Getsubscriptionsusagedatabyapplication — Retrieves usage data for a subscription, broken down by application.
/v1/subscriptions/{subscriptionuuid}/metrics/usage/data-by-application
GET
Getsubscriptionsusageviewsdatabyapplication — Retrieves views data for a subscription, broken down by application.
/v1/subscriptions/{subscriptionuuid}/metrics/usage/views-by-application
GET
Getsubscriptionsusagevisitsdatabyapplication — Retrieves visits data for a subscription, broken down by application.
/v1/subscriptions/{subscriptionuuid}/metrics/usage/visits-by-application
GET
Getsubscriptionsusagemetricdata — Retrieves aggregate usage metric data for a subscription.
/v1/subscriptions/{subscriptionuuid}/metrics/usage/{usagemetric}
GET
Getshieldacl — Provides a list of Shield ACL rules.
/v1/subscriptions/{subscriptionuuid}/shield-acl
POST
Postshieldacl — Creates a Shield ACL rule.
/v1/subscriptions/{subscriptionuuid}/shield-acl
POST
Postresetshieldacl — Resets Shield ACL rules to default settings.
/v1/subscriptions/{subscriptionuuid}/shield-acl/actions/reset
GET
Getshieldaclrulebyuuid — Returns the specified Shield ACL rule.
/v1/subscriptions/{subscriptionuuid}/shield-acl/{shieldacluuid}
PUT
Putshieldacl — Updates a Shield ACL rule.
/v1/subscriptions/{subscriptionuuid}/shield-acl/{shieldacluuid}
DELETE
Deleteshieldacl — Deletes a Shield ACL rule.
/v1/subscriptions/{subscriptionuuid}/shield-acl/{shieldacluuid}

MCP Tools

return-list-subscription

Return a list of subscription.

read-only idempotent
return-details-about-specific-subscription

Return details about a specific subscription.

read-only idempotent
modifies-subscription

Modifies a subscription.

idempotent
provides-list-applications-that-are

Provides a list of applications that are a part of the subscription.

read-only idempotent
retrieves-code-studio-metadata-subscription

Retrieves Code Studio metadata for a subscription.

read-only idempotent
displays-code-studio-options-subscription

Displays Code Studio options for a subscription.

enables-code-studio-subscription

Enables Code Studio for a subscription.

retrieves-list-code-studio-enabled

Retrieves a list of Code Studio enabled applications for a subscription.

read-only idempotent
retrieves-list-users-assigned-code

Retrieves a list of users assigned to Code Studio for a subscription.

read-only idempotent
assigns-user-code-studio-seat

Assigns a user to a Code Studio seat for a subscription.

retrieves-details-about-specific-code

Retrieves details about a specific Code Studio user.

read-only idempotent
unassigns-user-code-studio-seat

Unassigns a user from a Code Studio seat.

idempotent
returns-list-domains-registered-this

Returns a list of Domains registered with this subscription.

read-only idempotent
registers-domain-this-subscription

Registers a Domain with this subscription.

returns-speicific-domain-registered-this

Returns a speicific Domain registered with this subscription.

read-only idempotent
unregisters-domain-registered-this-subscription

Unregisters a Domain registered with this subscription.

idempotent
triggers-re-verification-and-update

Triggers re-verification and update to the domain verification status.

provides-list-entitlements-that-are

Provides a list of entitlements that are a part of the subscription.

read-only idempotent
returns-list-cloud-ides-associated

Returns a list of Cloud IDEs associated with this subscription.

read-only idempotent
retrieves-traversal-links-subscription-s-usage

Retrieves traversal links for a subscription's usage data.

read-only idempotent
retrieves-aggregate-usage-data-subscription

Retrieves aggregate usage data for a subscription.

read-only idempotent
retrieves-usage-data-subscription-broken

Retrieves usage data for a subscription, broken down by application.

read-only idempotent
retrieves-views-data-subscription-broken

Retrieves views data for a subscription, broken down by application.

read-only idempotent
retrieves-visits-data-subscription-broken

Retrieves visits data for a subscription, broken down by application.

read-only idempotent
retrieves-aggregate-usage-metric-data

Retrieves aggregate usage metric data for a subscription.

read-only idempotent
provides-list-shield-acl-rules

Provides a list of Shield ACL rules.

read-only idempotent
creates-shield-acl-rule

Creates a Shield ACL rule.

resets-shield-acl-rules-default

Resets Shield ACL rules to default settings.

returns-specified-shield-acl-rule

Returns the specified Shield ACL rule.

read-only idempotent
updates-shield-acl-rule

Updates a Shield ACL rule.

idempotent
deletes-shield-acl-rule

Deletes a Shield ACL rule.

idempotent

Capability Spec

cloud-openapi-full-subscriptions.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Acquia Cloud API Documentation — Subscriptions
  description: 'Acquia Cloud API Documentation — Subscriptions. 31 operations. Lead operation: Return a list of subscription..
    Self-contained Naftiko capability covering one Acquia business surface.'
  tags:
  - Acquia
  - Subscriptions
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ACQUIA_API_KEY: ACQUIA_API_KEY
capability:
  consumes:
  - type: http
    namespace: cloud-openapi-full-subscriptions
    baseUri: ''
    description: Acquia Cloud API Documentation — Subscriptions business capability. Self-contained, no shared references.
    resources:
    - name: subscriptions
      path: /subscriptions
      operations:
      - name: getsubscriptions
        method: GET
        description: Return a list of subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid
      path: /subscriptions/{subscriptionUuid}
      operations:
      - name: getsubscription
        method: GET
        description: Return details about a specific subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: putsubscription
        method: PUT
        description: Modifies a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: subscriptions-subscriptionUuid-applications
      path: /subscriptions/{subscriptionUuid}/applications
      operations:
      - name: getsubscriptionapplications
        method: GET
        description: Provides a list of applications that are a part of the subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-code-studio
      path: /subscriptions/{subscriptionUuid}/code-studio
      operations:
      - name: getcodestudiosubscriptionmetadata
        method: GET
        description: Retrieves Code Studio metadata for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: optionscodestudio
        method: OPTIONS
        description: Displays Code Studio options for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-code-studio-actions-enable
      path: /subscriptions/{subscriptionUuid}/code-studio/actions/enable
      operations:
      - name: postenablecodestudio
        method: POST
        description: Enables Code Studio for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-code-studio-applications
      path: /subscriptions/{subscriptionUuid}/code-studio/applications
      operations:
      - name: getcodestudioapplications
        method: GET
        description: Retrieves a list of Code Studio enabled applications for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-code-studio-users
      path: /subscriptions/{subscriptionUuid}/code-studio/users
      operations:
      - name: getcodestudiousers
        method: GET
        description: Retrieves a list of users assigned to Code Studio for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: postcodestudiousers
        method: POST
        description: Assigns a user to a Code Studio seat for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: subscriptions-subscriptionUuid-code-studio-users-userUuid
      path: /subscriptions/{subscriptionUuid}/code-studio/users/{userUuid}
      operations:
      - name: getcodestudiouser
        method: GET
        description: Retrieves details about a specific Code Studio user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletecodestudiouser
        method: DELETE
        description: Unassigns a user from a Code Studio seat.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-domains
      path: /subscriptions/{subscriptionUuid}/domains
      operations:
      - name: getsubscriptiondomainregistrations
        method: GET
        description: Returns a list of Domains registered with this subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: postsubscriptiondomainregistration
        method: POST
        description: Registers a Domain with this subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: subscriptions-subscriptionUuid-domains-domainRegistrationUuid
      path: /subscriptions/{subscriptionUuid}/domains/{domainRegistrationUuid}
      operations:
      - name: getsubscriptiondomainregistration
        method: GET
        description: Returns a speicific Domain registered with this subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletesubscriptiondomainregistration
        method: DELETE
        description: Unregisters a Domain registered with this subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-domains-domainRegistrationUuid-actions-verify
      path: /subscriptions/{subscriptionUuid}/domains/{domainRegistrationUuid}/actions/verify
      operations:
      - name: postsubscriptionverifydomainregistration
        method: POST
        description: Triggers re-verification and update to the domain verification status.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-entitlements
      path: /subscriptions/{subscriptionUuid}/entitlements
      operations:
      - name: getsubscriptionentitlements
        method: GET
        description: Provides a list of entitlements that are a part of the subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-ides
      path: /subscriptions/{subscriptionUuid}/ides
      operations:
      - name: getsubscriptionides
        method: GET
        description: Returns a list of Cloud IDEs associated with this subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-metrics-usage
      path: /subscriptions/{subscriptionUuid}/metrics/usage
      operations:
      - name: getsubscriptionsusagelinks
        method: GET
        description: Retrieves traversal links for a subscription's usage data.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-metrics-usage-data
      path: /subscriptions/{subscriptionUuid}/metrics/usage/data
      operations:
      - name: getsubscriptionsusagedata
        method: GET
        description: Retrieves aggregate usage data for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-metrics-usage-data-by-application
      path: /subscriptions/{subscriptionUuid}/metrics/usage/data-by-application
      operations:
      - name: getsubscriptionsusagedatabyapplication
        method: GET
        description: Retrieves usage data for a subscription, broken down by application.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-metrics-usage-views-by-application
      path: /subscriptions/{subscriptionUuid}/metrics/usage/views-by-application
      operations:
      - name: getsubscriptionsusageviewsdatabyapplication
        method: GET
        description: Retrieves views data for a subscription, broken down by application.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-metrics-usage-visits-by-application
      path: /subscriptions/{subscriptionUuid}/metrics/usage/visits-by-application
      operations:
      - name: getsubscriptionsusagevisitsdatabyapplication
        method: GET
        description: Retrieves visits data for a subscription, broken down by application.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-metrics-usage-usageMetric
      path: /subscriptions/{subscriptionUuid}/metrics/usage/{usageMetric}
      operations:
      - name: getsubscriptionsusagemetricdata
        method: GET
        description: Retrieves aggregate usage metric data for a subscription.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-shield-acl
      path: /subscriptions/{subscriptionUuid}/shield-acl
      operations:
      - name: getshieldacl
        method: GET
        description: Provides a list of Shield ACL rules.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: postshieldacl
        method: POST
        description: Creates a Shield ACL rule.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: subscriptions-subscriptionUuid-shield-acl-actions-reset
      path: /subscriptions/{subscriptionUuid}/shield-acl/actions/reset
      operations:
      - name: postresetshieldacl
        method: POST
        description: Resets Shield ACL rules to default settings.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subscriptions-subscriptionUuid-shield-acl-shieldAclUuid
      path: /subscriptions/{subscriptionUuid}/shield-acl/{shieldAclUuid}
      operations:
      - name: getshieldaclrulebyuuid
        method: GET
        description: Returns the specified Shield ACL rule.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: putshieldacl
        method: PUT
        description: Updates a Shield ACL rule.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteshieldacl
        method: DELETE
        description: Deletes a Shield ACL rule.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.ACQUIA_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloud-openapi-full-subscriptions-rest
    port: 8080
    description: REST adapter for Acquia Cloud API Documentation — Subscriptions. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/subscriptions
      name: subscriptions
      description: REST surface for subscriptions.
      operations:
      - method: GET
        name: getsubscriptions
        description: Return a list of subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}
      name: subscriptions-subscriptionuuid
      description: REST surface for subscriptions-subscriptionUuid.
      operations:
      - method: GET
        name: getsubscription
        description: Return details about a specific subscription.
        call: cloud-openapi-full-subscriptions.getsubscription
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: putsubscription
        description: Modifies a subscription.
        call: cloud-openapi-full-subscriptions.putsubscription
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/applications
      name: subscriptions-subscriptionuuid-applications
      description: REST surface for subscriptions-subscriptionUuid-applications.
      operations:
      - method: GET
        name: getsubscriptionapplications
        description: Provides a list of applications that are a part of the subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptionapplications
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/code-studio
      name: subscriptions-subscriptionuuid-code-studio
      description: REST surface for subscriptions-subscriptionUuid-code-studio.
      operations:
      - method: GET
        name: getcodestudiosubscriptionmetadata
        description: Retrieves Code Studio metadata for a subscription.
        call: cloud-openapi-full-subscriptions.getcodestudiosubscriptionmetadata
        outputParameters:
        - type: object
          mapping: $.
      - method: OPTIONS
        name: optionscodestudio
        description: Displays Code Studio options for a subscription.
        call: cloud-openapi-full-subscriptions.optionscodestudio
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/code-studio/actions/enable
      name: subscriptions-subscriptionuuid-code-studio-actions-enable
      description: REST surface for subscriptions-subscriptionUuid-code-studio-actions-enable.
      operations:
      - method: POST
        name: postenablecodestudio
        description: Enables Code Studio for a subscription.
        call: cloud-openapi-full-subscriptions.postenablecodestudio
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/code-studio/applications
      name: subscriptions-subscriptionuuid-code-studio-applications
      description: REST surface for subscriptions-subscriptionUuid-code-studio-applications.
      operations:
      - method: GET
        name: getcodestudioapplications
        description: Retrieves a list of Code Studio enabled applications for a subscription.
        call: cloud-openapi-full-subscriptions.getcodestudioapplications
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/code-studio/users
      name: subscriptions-subscriptionuuid-code-studio-users
      description: REST surface for subscriptions-subscriptionUuid-code-studio-users.
      operations:
      - method: GET
        name: getcodestudiousers
        description: Retrieves a list of users assigned to Code Studio for a subscription.
        call: cloud-openapi-full-subscriptions.getcodestudiousers
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postcodestudiousers
        description: Assigns a user to a Code Studio seat for a subscription.
        call: cloud-openapi-full-subscriptions.postcodestudiousers
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/code-studio/users/{useruuid}
      name: subscriptions-subscriptionuuid-code-studio-users-useruuid
      description: REST surface for subscriptions-subscriptionUuid-code-studio-users-userUuid.
      operations:
      - method: GET
        name: getcodestudiouser
        description: Retrieves details about a specific Code Studio user.
        call: cloud-openapi-full-subscriptions.getcodestudiouser
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletecodestudiouser
        description: Unassigns a user from a Code Studio seat.
        call: cloud-openapi-full-subscriptions.deletecodestudiouser
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/domains
      name: subscriptions-subscriptionuuid-domains
      description: REST surface for subscriptions-subscriptionUuid-domains.
      operations:
      - method: GET
        name: getsubscriptiondomainregistrations
        description: Returns a list of Domains registered with this subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptiondomainregistrations
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postsubscriptiondomainregistration
        description: Registers a Domain with this subscription.
        call: cloud-openapi-full-subscriptions.postsubscriptiondomainregistration
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/domains/{domainregistrationuuid}
      name: subscriptions-subscriptionuuid-domains-domainregistrationuuid
      description: REST surface for subscriptions-subscriptionUuid-domains-domainRegistrationUuid.
      operations:
      - method: GET
        name: getsubscriptiondomainregistration
        description: Returns a speicific Domain registered with this subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptiondomainregistration
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletesubscriptiondomainregistration
        description: Unregisters a Domain registered with this subscription.
        call: cloud-openapi-full-subscriptions.deletesubscriptiondomainregistration
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/domains/{domainregistrationuuid}/actions/verify
      name: subscriptions-subscriptionuuid-domains-domainregistrationuuid-actions-verify
      description: REST surface for subscriptions-subscriptionUuid-domains-domainRegistrationUuid-actions-verify.
      operations:
      - method: POST
        name: postsubscriptionverifydomainregistration
        description: Triggers re-verification and update to the domain verification status.
        call: cloud-openapi-full-subscriptions.postsubscriptionverifydomainregistration
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/entitlements
      name: subscriptions-subscriptionuuid-entitlements
      description: REST surface for subscriptions-subscriptionUuid-entitlements.
      operations:
      - method: GET
        name: getsubscriptionentitlements
        description: Provides a list of entitlements that are a part of the subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptionentitlements
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/ides
      name: subscriptions-subscriptionuuid-ides
      description: REST surface for subscriptions-subscriptionUuid-ides.
      operations:
      - method: GET
        name: getsubscriptionides
        description: Returns a list of Cloud IDEs associated with this subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptionides
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/metrics/usage
      name: subscriptions-subscriptionuuid-metrics-usage
      description: REST surface for subscriptions-subscriptionUuid-metrics-usage.
      operations:
      - method: GET
        name: getsubscriptionsusagelinks
        description: Retrieves traversal links for a subscription's usage data.
        call: cloud-openapi-full-subscriptions.getsubscriptionsusagelinks
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/metrics/usage/data
      name: subscriptions-subscriptionuuid-metrics-usage-data
      description: REST surface for subscriptions-subscriptionUuid-metrics-usage-data.
      operations:
      - method: GET
        name: getsubscriptionsusagedata
        description: Retrieves aggregate usage data for a subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptionsusagedata
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/metrics/usage/data-by-application
      name: subscriptions-subscriptionuuid-metrics-usage-data-by-application
      description: REST surface for subscriptions-subscriptionUuid-metrics-usage-data-by-application.
      operations:
      - method: GET
        name: getsubscriptionsusagedatabyapplication
        description: Retrieves usage data for a subscription, broken down by application.
        call: cloud-openapi-full-subscriptions.getsubscriptionsusagedatabyapplication
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/metrics/usage/views-by-application
      name: subscriptions-subscriptionuuid-metrics-usage-views-by-application
      description: REST surface for subscriptions-subscriptionUuid-metrics-usage-views-by-application.
      operations:
      - method: GET
        name: getsubscriptionsusageviewsdatabyapplication
        description: Retrieves views data for a subscription, broken down by application.
        call: cloud-openapi-full-subscriptions.getsubscriptionsusageviewsdatabyapplication
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/metrics/usage/visits-by-application
      name: subscriptions-subscriptionuuid-metrics-usage-visits-by-application
      description: REST surface for subscriptions-subscriptionUuid-metrics-usage-visits-by-application.
      operations:
      - method: GET
        name: getsubscriptionsusagevisitsdatabyapplication
        description: Retrieves visits data for a subscription, broken down by application.
        call: cloud-openapi-full-subscriptions.getsubscriptionsusagevisitsdatabyapplication
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/metrics/usage/{usagemetric}
      name: subscriptions-subscriptionuuid-metrics-usage-usagemetric
      description: REST surface for subscriptions-subscriptionUuid-metrics-usage-usageMetric.
      operations:
      - method: GET
        name: getsubscriptionsusagemetricdata
        description: Retrieves aggregate usage metric data for a subscription.
        call: cloud-openapi-full-subscriptions.getsubscriptionsusagemetricdata
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/shield-acl
      name: subscriptions-subscriptionuuid-shield-acl
      description: REST surface for subscriptions-subscriptionUuid-shield-acl.
      operations:
      - method: GET
        name: getshieldacl
        description: Provides a list of Shield ACL rules.
        call: cloud-openapi-full-subscriptions.getshieldacl
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postshieldacl
        description: Creates a Shield ACL rule.
        call: cloud-openapi-full-subscriptions.postshieldacl
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/shield-acl/actions/reset
      name: subscriptions-subscriptionuuid-shield-acl-actions-reset
      description: REST surface for subscriptions-subscriptionUuid-shield-acl-actions-reset.
      operations:
      - method: POST
        name: postresetshieldacl
        description: Resets Shield ACL rules to default settings.
        call: cloud-openapi-full-subscriptions.postresetshieldacl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subscriptions/{subscriptionuuid}/shield-acl/{shieldacluuid}
      name: subscriptions-subscriptionuuid-shield-acl-shieldacluuid
      description: REST surface for subscriptions-subscriptionUuid-shield-acl-shieldAclUuid.
      operations:
      - method: GET
        name: getshieldaclrulebyuuid
        description: Returns the specified Shield ACL rule.
        call: cloud-openapi-full-subscriptions.getshieldaclrulebyuuid
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: putshieldacl
        description: Updates a Shield ACL rule.
        call: cloud-openapi-full-subscriptions.putshieldacl
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteshieldacl
        description: Deletes a Shield ACL rule.
        call: cloud-openapi-full-subscriptions.deleteshieldacl
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloud-openapi-full-subscriptions-mcp
    port: 9090
    transport: http
    description: MCP adapter for Acquia Cloud API Documentation — Subscriptions. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: return-list-subscription
      description: Return a list of subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getsubscriptions
      outputParameters:
      - type: object
        mapping: $.
    - name: return-details-about-specific-subscription
      description: Return details about a specific subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getsubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: modifies-subscription
      description: Modifies a subscription.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.putsubscription
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: provides-list-applications-that-are
      description: Provides a list of applications that are a part of the subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getsubscriptionapplications
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-code-studio-metadata-subscription
      description: Retrieves Code Studio metadata for a subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getcodestudiosubscriptionmetadata
      outputParameters:
      - type: object
        mapping: $.
    - name: displays-code-studio-options-subscription
      description: Displays Code Studio options for a subscription.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-openapi-full-subscriptions.optionscodestudio
      outputParameters:
      - type: object
        mapping: $.
    - name: enables-code-studio-subscription
      description: Enables Code Studio for a subscription.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-openapi-full-subscriptions.postenablecodestudio
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-list-code-studio-enabled
      description: Retrieves a list of Code Studio enabled applications for a subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getcodestudioapplications
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-list-users-assigned-code
      description: Retrieves a list of users assigned to Code Studio for a subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getcodestudiousers
      outputParameters:
      - type: object
        mapping: $.
    - name: assigns-user-code-studio-seat
      description: Assigns a user to a Code Studio seat for a subscription.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-openapi-full-subscriptions.postcodestudiousers
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-details-about-specific-code
      description: Retrieves details about a specific Code Studio user.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getcodestudiouser
      outputParameters:
      - type: object
        mapping: $.
    - name: unassigns-user-code-studio-seat
      description: Unassigns a user from a Code Studio seat.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: cloud-openapi-full-subscriptions.deletecodestudiouser
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-list-domains-registered-this
      description: Returns a list of Domains registered with this subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getsubscriptiondomainregistrations
      outputParameters:
      - type: object
        mapping: $.
    - name: registers-domain-this-subscription
      description: Registers a Domain with this subscription.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-openapi-full-subscriptions.postsubscriptiondomainregistration
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-speicific-domain-registered-this
      description: Returns a speicific Domain registered with this subscription.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-subscriptions.getsubscriptiondomainregistration
      outputParameters:
      - type: object
        mapping: $.
    - name: unregisters-domain-registered-this-subscription
      description: Unregisters a Domain registered with this subscription.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: cloud-openapi-full-subscriptions.deletesubscriptiondomainregis

# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/acquia/refs/heads/main/capabilities/cloud-openapi-full-subscriptions.yaml