GBG · OpenAPI Overlay 1.0.0

API Evangelist overlay for GBG Go API v1

8 actions 8 updates documentation extends ../openapi/_original/gbg-go-v1-openapi.yml
Derived by API Evangelist Built from the contracts GBG publishes. GBG did not publish this file.
View Overlay File View on GitHub Overlay Specification

What the actions change

operationIdx-operationId-originx-mcp-serverx-llms-txtx-agent-skill

Targets 8

$.paths['/as/token.oauth2'].post
$.paths['/journey/start'].post
$.paths['/journey/task/list'].post
$.paths['/journey/task/list/schema'].post
$.paths['/journey/task/schema'].post
$.paths['/journey/task/update'].post
$.paths['/journey/state/fetch'].post
$.info

OpenAPI Overlay

Raw ↑ 
overlay: 1.0.0
info:
  title: API Evangelist overlay for GBG Go API v1
  version: 1.0.0
extends: ../openapi/_original/gbg-go-v1-openapi.yml
x-generated: '2026-10-18'
x-method: generated
x-source: openapi/gbg-go-v1-openapi.yml
x-rationale: 'The published GBG Go OpenAPI declares no operationIds. This overlay adds them without mutating the original: names come verbatim
  from the provider''s own core SDK spec (openapi/_original/gbg-go-core-sdk-spec.yaml) where that spec declares the same method+path, and are
  otherwise generated from the summary and marked x-operationId-origin: generated. It also links the provider-published MCP server, llms.txt and
  agent skill.'
actions:
- target: $.paths['/as/token.oauth2'].post
  description: Add operationId generateAccessToken (Generate access token)
  update:
    operationId: generateAccessToken
    x-operationId-origin: 'generated: API Evangelist name derived from the operation summary; the provider declares none'
- target: $.paths['/journey/start'].post
  description: Add operationId startJourney (Start journey)
  update:
    operationId: startJourney
    x-operationId-origin: 'provider: declared verbatim in openapi/_original/gbg-go-core-sdk-spec.yaml'
- target: $.paths['/journey/task/list'].post
  description: Add operationId getTasks (Retrieve tasks)
  update:
    operationId: getTasks
    x-operationId-origin: 'provider: declared verbatim in openapi/_original/gbg-go-core-sdk-spec.yaml'
- target: $.paths['/journey/task/list/schema'].post
  description: Add operationId getTasksSchema (Retrieve tasks with their schema)
  update:
    operationId: getTasksSchema
    x-operationId-origin: 'provider: declared verbatim in openapi/_original/gbg-go-core-sdk-spec.yaml'
- target: $.paths['/journey/task/schema'].post
  description: Add operationId getTaskSchema (Retrieve task schema)
  update:
    operationId: getTaskSchema
    x-operationId-origin: 'provider: declared verbatim in openapi/_original/gbg-go-core-sdk-spec.yaml'
- target: $.paths['/journey/task/update'].post
  description: Add operationId updateTask (Submit task data)
  update:
    operationId: updateTask
    x-operationId-origin: 'provider: declared verbatim in openapi/_original/gbg-go-core-sdk-spec.yaml'
- target: $.paths['/journey/state/fetch'].post
  description: Add operationId getJourneyState (Fetch journey state)
  update:
    operationId: getJourneyState
    x-operationId-origin: 'provider: declared verbatim in openapi/_original/gbg-go-core-sdk-spec.yaml'
- target: $.info
  description: Point agents at the provider-published agent surfaces.
  update:
    x-mcp-server: https://docs.go.gbgplc.com/mcp
    x-llms-txt: https://docs.go.gbgplc.com/llms.txt
    x-agent-skill: https://docs.go.gbgplc.com/.well-known/agent-skills/gbg/skill.md

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • 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 overlay 
curl "https://apis.io/api/v1/overlays/gbg-go-v1-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?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.