---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/addons/{addonsId}"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/addons/{addonsId}"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/addons/{addonsId}

`GET /v1/projects/{projectsId}/locations/{locationsId}/addons/{addonsId}`

## Request

- Base URL: `https://apihub.googleapis.com`
- URL: `https://apihub.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/addons/{addonsId}`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/apihub.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/apihub.readonly`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/apihub.readwrite`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/apihub.readwrite`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
- TypeScript: <https://skmtc.dev/google/apis/apihub/docs/v1/projects/:projectsId/locations/:locationsId/addons/:addonsId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get an addon.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required
- `addonsId` string, required

## Response `200`

Successful response

- GoogleCloudApihubV1Addon: Addon resource.
  - `boostSpecGeminiRegionId` string: Output only. The Vertex AI region where the BoostSpec Gemini model calls run for this API Hub instance. Populated only for the SpecGen addon (`system-spec-generation`); other addons leave this field empty. `gemini-2.5-flash` is not available in every API Hub region, so the effective region may differ from the API Hub instance's own region. The value follows these semantics: - `""`: BoostSpec is disabled in this region (the addon is not SpecGen, or the API Hub instance region has no configured Gemini endpoint or fallback). - Equal to the API Hub instance region: BoostSpec calls run in-region. - Differs from the API Hub instance region: BoostSpec calls run in the specified fallback region. Callers rendering this field can derive the three display states from this single field combined with the API Hub instance region.
  - `config` GoogleCloudApihubV1AddonConfig: Configuration for the addon.
    - `allDataAddonConfig` GoogleCloudApihubV1AllDataAddonConfig: Configuration for addons which act on all data in the API hub. This is used to specify if the addon is enabled for all data in the API hub.
      - `enabled` boolean: Required. If true, the addon is enabled for all data in the API hub.
    - `gatewayPluginAddonConfig` GoogleCloudApihubV1GatewayPluginAddonConfig: Configuration for gateway plugin addons. This is used to specify the list of gateway plugin configs for which the addon is enabled.
      - `gatewayPluginConfigs` GoogleCloudApihubV1GatewayPluginConfig[]: Required. The list of gateway plugin configs for which the addon is enabled. Each gateway plugin config should have a unique plugin instance.
        - `apigeeEdgeConfig` GoogleCloudApihubV1ApigeeEdgeConfig: Configuration for Apigee Edge gateways. Applicability of a filter is determined by the filter being provided. If none of the filters are provided the addon will be enabled for all data brought in by the gateway plugin instance.
          - `environmentFilter` GoogleCloudApihubV1EnvironmentFilter: Filter for environments.
            - `allEnvironments` boolean: Optional. Indicates if this filter should match all environments or only a subset of environments. If set to true, all environments are matched.
            - `environments` string[]: Optional. If provided, only environments in this list are matched. This field is ignored if `all_environments` is true.
        - `apigeeOpdkConfig` GoogleCloudApihubV1ApigeeOPDKConfig: Configuration for Apigee OPDK gateways. Applicability of a filter is determined by the filter being provided. If none of the filters are provided the addon will be enabled for all data brought in by the gateway plugin instance.
          - `environmentFilter` GoogleCloudApihubV1EnvironmentFilter: Filter for environments.
            - `allEnvironments` boolean: Optional. Indicates if this filter should match all environments or only a subset of environments. If set to true, all environments are matched.
            - `environments` string[]: Optional. If provided, only environments in this list are matched. This field is ignored if `all_environments` is true.
        - `apigeeXHybridConfig` GoogleCloudApihubV1ApigeeXHybridConfig: Configuration for Apigee X and Apigee Hybrid gateways. Applicability of a filter is determined by the filter being provided. If none of the filters are provided the addon will be enabled for all data brought in by the gateway plugin instance.
          - `environmentFilter` GoogleCloudApihubV1EnvironmentFilter: Filter for environments.
            - `allEnvironments` boolean: Optional. Indicates if this filter should match all environments or only a subset of environments. If set to true, all environments are matched.
            - `environments` string[]: Optional. If provided, only environments in this list are matched. This field is ignored if `all_environments` is true.
        - `pluginInstance` string: Required. The name of the gateway plugin instance for which the config is to be specified. Format: projects/{project}/locations/{location}/plugins/{plugin}/pluginInstances/{plugin_instance}
  - `createTime` string, google-datetime: Output only. The time at which the addon was created.
  - `dataSource` 'DATA_SOURCE_UNSPECIFIED' | 'PLUGIN_INSTANCE' | 'ALL_DATA': Required. The data source on which the addon operates. This determines which field in the `config` oneof is used.
  - `description` string: Optional. The description of the addon.
  - `displayName` string: Required. The display name of the addon.
  - `name` string: Identifier. The name of the addon to enable. Format: `projects/{project}/locations/{location}/addons/{addon}`.
  - `state` 'ADDON_STATE_UNSPECIFIED' | 'ACTIVE' | 'UPDATING' | 'ERROR' | 'INACTIVE': Output only. The state of the addon.
  - `updateTime` string, google-datetime: Output only. The time at which the addon was last updated.

## Changes

- **2026-11-08** `09b6c7d2247b`: 4 info
  - the security scope `https://www.googleapis.com/auth/apihub.readonly` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/apihub.readonly` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/apihub/changes/v1/projects/:projectsId/locations/:locationsId/addons/:addonsId/get.md)

---

[API](https://skmtc.dev/google/apis/apihub.md) - [All operations](https://skmtc.dev/google/apis/apihub/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/apihub/revisions/09b6c7d2247b?raw)