ThousandEyes · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for ThousandEyes Tag Assignment API

5 actions 5 updates phrasing extends openapi/thousandeyes-tag-assignment-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for ThousandEyes's API. It is a proposal applied on top of the contract, not a document ThousandEyes publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/tags/assign'].post
$.paths['/tags/unassign'].post
$.paths['/tags/{id}/assign'].post
$.paths['/tags/{id}/unassign'].post

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for ThousandEyes Tag Assignment API
  version: 1.0.0
extends: openapi/thousandeyes-tag-assignment-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/tags/assign'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign several tags to objects
      effect: write
      questions:
      - Can I attach several tags to many tests in one call?
      - Does bulk tag assignment keep the tags already on an object?
      instructions:
      - text: 'Assign these tags to their objects: {tags}.'
        slots:
          tags: requestBody.tags
      - text: Bulk assign multiple tags as {tags}.
        slots:
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tags/unassign'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove several tags from objects
      effect: write
      questions:
      - Can I strip multiple tags from many objects at once?
      - Does bulk tag removal work for dynamically tagged endpoint agents?
      instructions:
      - text: 'Unassign these tags from their objects: {tags}.'
        slots:
          tags: requestBody.tags
      - text: Bulk remove multiple tags as {tags}.
        slots:
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tags/{id}/assign'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign one tag to objects
      effect: write
      questions:
      - Can I apply a single tag to a list of tests or agents?
      - Is assigning one tag cumulative with its existing assignments?
      instructions:
      - text: Assign tag {id} to {assignments}.
        slots:
          id: path.id
          assignments: requestBody.assignments
      - text: 'Apply tag {id} to these objects: {assignments}.'
        slots:
          id: path.id
          assignments: requestBody.assignments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tags/{id}/unassign'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove one tag from objects
      effect: write
      questions:
      - Can I take a single tag off several objects?
      - Which objects can't have a tag removed this way?
      instructions:
      - text: Remove tag {id} from {assignments}.
        slots:
          id: path.id
          assignments: requestBody.assignments
      - text: 'Unassign tag {id} from these objects: {assignments}.'
        slots:
          id: path.id
          assignments: requestBody.assignments
      method: generated
      generated: '2026-09-26'