GoToWebinar · API Governance Rules

GoToWebinar API Rules

Spectral linting rules defining API design standards and conventions for GoToWebinar.

GoToWebinar API Rules is a Spectral governance ruleset published by GoToWebinar on the APIs.io network, containing 8 lint rules.

The ruleset includes 4 error-severity rules, 3 warning-severity rules, and 1 info-severity rule.

Tagged areas include Attendees, Collaboration, Communications, Events, and Meetings.

Rulesets can be applied to your own OpenAPI specs via Spectral to enforce the same governance standards.

8 Rules error 4 warn 3 info 1
View Rules File View on GitHub

Rule Categories

gotowebinar

Rules

error
gotowebinar-base-url
Server URL must use the documented GoToWebinar V2 base URL.
$.servers[*].url
error
gotowebinar-oauth-token-url
OAuth flows must point at the new GoTo authentication service (post-2025-09-30 migration).
$.components.securitySchemes[?(@.type == 'oauth2')].flows..tokenUrl
error
gotowebinar-oauth-authorize-url
OAuth authorize URL must use the new authentication service.
$.components.securitySchemes[?(@.type == 'oauth2')].flows..authorizationUrl
warn
gotowebinar-operation-summary-title-case
Operation summaries should be Title Case.
$.paths.*.*.summary
warn
gotowebinar-tag-title-case
Tag names must be Title Case (e.g. Webinars, Co-Organizers).
$.tags[*].name
warn
gotowebinar-operation-id-camel-case
operationId should be camelCase (e.g. createWebinar, listSessionAttendees).
$.paths.*.*.operationId
info
gotowebinar-organizer-path-prefix
REST resources are scoped under /organizers/{organizerKey}/...
$.paths[?(@property != '/webhooks' && @property != '/webhooks/secretkey' && @property != '/userSubscriptions' && [email protected]('/webhooks/') && [email protected]('/userSubscriptions/'))]~
error
gotowebinar-webhook-event-names
Webhook eventName enums must use the four documented event types.
$.components.schemas..[?(@.eventName)].eventName.enum

Spectral Ruleset

Raw ↑ 
extends:
  - spectral:oas
documentationUrl: https://developer.goto.com/GoToWebinarV2
description: Spectral ruleset for GoToWebinar OpenAPI specifications. Enforces conventions observed in the V2 REST and Webhooks APIs published at developer.goto.com.
rules:
  gotowebinar-base-url:
    description: Server URL must use the documented GoToWebinar V2 base URL.
    severity: error
    given: "$.servers[*].url"
    then:
      function: pattern
      functionOptions:
        match: "^https://api\\.getgo\\.com/G2W/rest/v2$"

  gotowebinar-oauth-token-url:
    description: OAuth flows must point at the new GoTo authentication service (post-2025-09-30 migration).
    severity: error
    given: "$.components.securitySchemes[?(@.type == 'oauth2')].flows..tokenUrl"
    then:
      function: pattern
      functionOptions:
        match: "^https://authentication\\.logmeininc\\.com/oauth/token$"

  gotowebinar-oauth-authorize-url:
    description: OAuth authorize URL must use the new authentication service.
    severity: error
    given: "$.components.securitySchemes[?(@.type == 'oauth2')].flows..authorizationUrl"
    then:
      function: pattern
      functionOptions:
        match: "^https://authentication\\.logmeininc\\.com/oauth/authorize$"

  gotowebinar-operation-summary-title-case:
    description: Operation summaries should be Title Case.
    severity: warn
    given: "$.paths.*.*.summary"
    then:
      function: pattern
      functionOptions:
        match: "^([A-Z][a-zA-Z0-9]*)(\\s+[A-Za-z0-9-]+)*$"

  gotowebinar-tag-title-case:
    description: Tag names must be Title Case (e.g. Webinars, Co-Organizers).
    severity: warn
    given: "$.tags[*].name"
    then:
      function: pattern
      functionOptions:
        match: "^[A-Z][A-Za-z0-9-]*(\\s+[A-Z][A-Za-z0-9-]*)*$"

  gotowebinar-operation-id-camel-case:
    description: operationId should be camelCase (e.g. createWebinar, listSessionAttendees).
    severity: warn
    given: "$.paths.*.*.operationId"
    then:
      function: pattern
      functionOptions:
        match: "^[a-z][a-zA-Z0-9]*$"

  gotowebinar-organizer-path-prefix:
    description: REST resources are scoped under /organizers/{organizerKey}/...
    severity: info
    given: "$.paths[?(@property != '/webhooks' && @property != '/webhooks/secretkey' && @property != '/userSubscriptions' && [email protected]('/webhooks/') && [email protected]('/userSubscriptions/'))]~"
    then:
      function: pattern
      functionOptions:
        match: "^/organizers/\\{organizerKey\\}"

  gotowebinar-webhook-event-names:
    description: Webhook eventName enums must use the four documented event types.
    severity: error
    given: "$.components.schemas..[?(@.eventName)].eventName.enum"
    then:
      function: schema
      functionOptions:
        schema:
          type: array
          items:
            type: string
            enum: [registrant.added, registrant.joined, webinar.created, webinar.changed]