naftiko: 1.0.0-alpha2
info:
  label: Google Data Studio API
  description: The Looker Studio API (formerly Google Data Studio API) enables programmatic management of Looker Studio assets,
    including searching for assets and managing permissions within Google Workspace or Cloud Identity organizations. The API
    is only available to users that belong to an organization with Google Workspace or Cloud Identity.
  tags:
  - Google
  - Data
  - Studio
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: google-data-studio
    baseUri: https://datastudio.googleapis.com/v1
    description: Google Data Studio API HTTP API.
    authentication:
      type: bearer
      token: '{{GOOGLE_DATA_STUDIO_TOKEN}}'
    resources:
    - name: assets-search
      path: /assets:search
      operations:
      - name: searchassets
        method: GET
        description: Google Data Studio Search Looker Studio assets
        inputParameters:
        - name: assetTypes
          in: query
          type: string
          required: true
          description: The asset type to search. Exactly one asset type must be specified.
        - name: title
          in: query
          type: string
          description: Search string checked against asset title and description. Supports advanced search syntax including
            creator:me, creator:user@example.com, owner:me, owner:user@
        - name: includeTrashed
          in: query
          type: boolean
          description: When true, includes only trashed assets. When false or omitted, excludes trashed assets. Defaults to
            false.
        - name: owner
          in: query
          type: string
          description: Filter by the asset owner's email address.
        - name: orderBy
          in: query
          type: string
          description: Sort order for the results. Supported values are title, last_viewed_by_me, create_time, last_accessed_time,
            and id.
        - name: pageSize
          in: query
          type: integer
          description: The maximum number of results to return per page. Defaults to 1000.
        - name: pageToken
          in: query
          type: string
          description: Token for pagination. Use the nextPageToken or previousPageToken value from a prior response to retrieve
            subsequent pages.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: assets-assetname-permissions
      path: /assets/{assetName}/permissions
      operations:
      - name: getpermissions
        method: GET
        description: Google Data Studio Get asset permissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchpermissions
        method: PATCH
        description: Google Data Studio Update asset permissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: assets-assetname-permissions-addmembers
      path: /assets/{assetName}/permissions:addMembers
      operations:
      - name: addmembers
        method: POST
        description: Google Data Studio Add members to an asset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: assets-assetname-permissions-revokeallpermission
      path: /assets/{assetName}/permissions:revokeAllPermissions
      operations:
      - name: revokeallpermissions
        method: POST
        description: Google Data Studio Revoke all permissions for members
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: google-data-studio-rest
    description: REST adapter for Google Data Studio API.
    resources:
    - path: /assets:search
      name: searchassets
      operations:
      - method: GET
        name: searchassets
        description: Google Data Studio Search Looker Studio assets
        call: google-data-studio.searchassets
        outputParameters:
        - type: object
          mapping: $.
    - path: /assets/{assetName}/permissions
      name: getpermissions
      operations:
      - method: GET
        name: getpermissions
        description: Google Data Studio Get asset permissions
        call: google-data-studio.getpermissions
        outputParameters:
        - type: object
          mapping: $.
    - path: /assets/{assetName}/permissions
      name: patchpermissions
      operations:
      - method: PATCH
        name: patchpermissions
        description: Google Data Studio Update asset permissions
        call: google-data-studio.patchpermissions
        outputParameters:
        - type: object
          mapping: $.
    - path: /assets/{assetName}/permissions:addMembers
      name: addmembers
      operations:
      - method: POST
        name: addmembers
        description: Google Data Studio Add members to an asset
        call: google-data-studio.addmembers
        outputParameters:
        - type: object
          mapping: $.
    - path: /assets/{assetName}/permissions:revokeAllPermissions
      name: revokeallpermissions
      operations:
      - method: POST
        name: revokeallpermissions
        description: Google Data Studio Revoke all permissions for members
        call: google-data-studio.revokeallpermissions
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: google-data-studio-mcp
    transport: http
    description: MCP adapter for Google Data Studio API for AI agent use.
    tools:
    - name: searchassets
      description: Google Data Studio Search Looker Studio assets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-data-studio.searchassets
      with:
        assetTypes: tools.assetTypes
        title: tools.title
        includeTrashed: tools.includeTrashed
        owner: tools.owner
        orderBy: tools.orderBy
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: assetTypes
        type: string
        description: The asset type to search. Exactly one asset type must be specified.
        required: true
      - name: title
        type: string
        description: Search string checked against asset title and description. Supports advanced search syntax including
          creator:me, creator:user@example.com, owner:me, owner:user@
      - name: includeTrashed
        type: boolean
        description: When true, includes only trashed assets. When false or omitted, excludes trashed assets. Defaults to
          false.
      - name: owner
        type: string
        description: Filter by the asset owner's email address.
      - name: orderBy
        type: string
        description: Sort order for the results. Supported values are title, last_viewed_by_me, create_time, last_accessed_time,
          and id.
      - name: pageSize
        type: integer
        description: The maximum number of results to return per page. Defaults to 1000.
      - name: pageToken
        type: string
        description: Token for pagination. Use the nextPageToken or previousPageToken value from a prior response to retrieve
          subsequent pages.
      outputParameters:
      - type: object
        mapping: $.
    - name: getpermissions
      description: Google Data Studio Get asset permissions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-data-studio.getpermissions
      outputParameters:
      - type: object
        mapping: $.
    - name: patchpermissions
      description: Google Data Studio Update asset permissions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-data-studio.patchpermissions
      outputParameters:
      - type: object
        mapping: $.
    - name: addmembers
      description: Google Data Studio Add members to an asset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-data-studio.addmembers
      outputParameters:
      - type: object
        mapping: $.
    - name: revokeallpermissions
      description: Google Data Studio Revoke all permissions for members
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-data-studio.revokeallpermissions
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    GOOGLE_DATA_STUDIO_TOKEN: GOOGLE_DATA_STUDIO_TOKEN