Acquia Cloud API Documentation — Agreements

naftiko: 1.0.0-alpha2
info:
  label: Acquia Cloud API Documentation — Agreements
  description: 'Acquia Cloud API Documentation — Agreements. 5 operations. Lead operation: Return a list of agreements.. Self-contained
    Naftiko capability covering one Acquia business surface.'
  tags:
  - Acquia
  - Agreements
  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-agreements
    baseUri: ''
    description: Acquia Cloud API Documentation — Agreements business capability. Self-contained, no shared references.
    resources:
    - name: agreements
      path: /agreements
      operations:
      - name: getagreements
        method: GET
        description: Return a list of agreements.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agreements-agreementUuid
      path: /agreements/{agreementUuid}
      operations:
      - name: getagreement
        method: GET
        description: Return a specific agreement by a provided UUID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agreements-agreementUuid-actions-accept
      path: /agreements/{agreementUuid}/actions/accept
      operations:
      - name: postacceptagreement
        method: POST
        description: Accepts a legal agreement by UUID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agreements-agreementUuid-actions-decline
      path: /agreements/{agreementUuid}/actions/decline
      operations:
      - name: postdeclineagreement
        method: POST
        description: Declines a legal agreement by UUID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agreements-agreementUuid-invitees
      path: /agreements/{agreementUuid}/invitees
      operations:
      - name: getinvitees
        method: GET
        description: Returns a list of users invited to action this agreement.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.ACQUIA_API_KEY}}'
  exposes:
  - type: rest
    namespace: cloud-openapi-full-agreements-rest
    port: 8080
    description: REST adapter for Acquia Cloud API Documentation — Agreements. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/agreements
      name: agreements
      description: REST surface for agreements.
      operations:
      - method: GET
        name: getagreements
        description: Return a list of agreements.
        call: cloud-openapi-full-agreements.getagreements
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreementuuid}
      name: agreements-agreementuuid
      description: REST surface for agreements-agreementUuid.
      operations:
      - method: GET
        name: getagreement
        description: Return a specific agreement by a provided UUID.
        call: cloud-openapi-full-agreements.getagreement
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreementuuid}/actions/accept
      name: agreements-agreementuuid-actions-accept
      description: REST surface for agreements-agreementUuid-actions-accept.
      operations:
      - method: POST
        name: postacceptagreement
        description: Accepts a legal agreement by UUID.
        call: cloud-openapi-full-agreements.postacceptagreement
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreementuuid}/actions/decline
      name: agreements-agreementuuid-actions-decline
      description: REST surface for agreements-agreementUuid-actions-decline.
      operations:
      - method: POST
        name: postdeclineagreement
        description: Declines a legal agreement by UUID.
        call: cloud-openapi-full-agreements.postdeclineagreement
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/agreements/{agreementuuid}/invitees
      name: agreements-agreementuuid-invitees
      description: REST surface for agreements-agreementUuid-invitees.
      operations:
      - method: GET
        name: getinvitees
        description: Returns a list of users invited to action this agreement.
        call: cloud-openapi-full-agreements.getinvitees
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloud-openapi-full-agreements-mcp
    port: 9090
    transport: http
    description: MCP adapter for Acquia Cloud API Documentation — Agreements. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: return-list-agreements
      description: Return a list of agreements.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-agreements.getagreements
      outputParameters:
      - type: object
        mapping: $.
    - name: return-specific-agreement-provided-uuid
      description: Return a specific agreement by a provided UUID.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-agreements.getagreement
      outputParameters:
      - type: object
        mapping: $.
    - name: accepts-legal-agreement-uuid
      description: Accepts a legal agreement by UUID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-openapi-full-agreements.postacceptagreement
      outputParameters:
      - type: object
        mapping: $.
    - name: declines-legal-agreement-uuid
      description: Declines a legal agreement by UUID.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: cloud-openapi-full-agreements.postdeclineagreement
      outputParameters:
      - type: object
        mapping: $.
    - name: returns-list-users-invited-action
      description: Returns a list of users invited to action this agreement.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloud-openapi-full-agreements.getinvitees
      outputParameters:
      - type: object
        mapping: $.