Pluralsight · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Pluralsight REST Licensing API

5 actions 5 updates phrasing extends openapi/pluralsight-licensing-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Pluralsight's API. It is a proposal applied on top of the contract, not a document Pluralsight publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/invitations'].get

$.paths['/invitations'].post

$.paths['/users'].get

$.paths['/teams'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Pluralsight REST Licensing API
  version: 1.0.0
extends: openapi/pluralsight-licensing-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/invitations'].get
  update:
    x-apievangelist-phrasing:
      intent: List pending user invitations
      effect: read
      questions:
      - Who has been invited to our plan but hasn't accepted yet?
      - Can I see outstanding license invitations on the legacy licensing API?
      instructions:
      - text: List all pending invitations to our plan.
      - text: Show invites that haven't been accepted yet.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/invitations'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a user invitation to the plan
      effect: write
      questions:
      - How do I invite a new user to our Pluralsight plan?
      - Can I still send license invitations through the deprecated licensing endpoint?
      instructions:
      - text: Send a new invitation to join our plan.
      - text: Invite a new learner to the plan using the legacy licensing API.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List licensed users in the plan
      effect: read
      questions:
      - Which users hold a license in our plan?
      - What does the legacy licensing API return for plan members?
      instructions:
      - text: List all licensed users in our plan.
      - text: Show everyone currently on the plan via the licensing API.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: List teams in the plan
      effect: read
      questions:
      - What teams exist in our learning plan?
      - Can I list plan teams without the newer GraphQL Teams API?
      instructions:
      - text: List all teams in our plan.
      - text: Show me the plan's teams.
      method: generated
      generated: '2026-10-01'