Postman · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Postman Tags API

10 actions 10 updates phrasing extends openapi/postman-tags-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 10

$.info

$.paths['/apis/{apiId}/tags'].get

$.paths['/apis/{apiId}/tags'].put

$.paths['/collections/{collectionId}/tags'].get

$.paths['/collections/{collectionId}/tags'].put

$.paths['/tags/{slug}/entities'].get

$.paths['/workspaces/{workspaceId}/tags'].get

$.paths['/workspaces/{workspaceId}/tags'].put

$.paths['/tags/{entityType}/{entityId}'].get

$.paths['/tags/{entityType}/{entityId}'].put

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 Postman Tags API
  version: 1.0.0
extends: openapi/postman-tags-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: 9
- target: $.paths['/apis/{apiId}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an API's tags
      effect: read
      questions:
      - What tags are on this API?
      - How do I see how an API in Postman is tagged?
      instructions:
      - text: Get the tags on API {apiId}.
        slots:
          apiId: path.apiId
      - text: Show which tags are applied to API {apiId}.
        slots:
          apiId: path.apiId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/apis/{apiId}/tags'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an API's tags
      effect: write
      questions:
      - Does updating an API's tags replace the existing ones?
      - How do I tag an API?
      instructions:
      - text: Set the tags on API {apiId} to {tags}.
        slots:
          apiId: path.apiId
          tags: requestBody.tags
      - text: Replace all tags of API {apiId} with {tags}.
        slots:
          apiId: path.apiId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/collections/{collectionId}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a collection's tags
      effect: read
      questions:
      - Which tags are on this collection?
      - Can I read the tags attached to a collection?
      instructions:
      - text: Get the tags on collection {collectionId}.
        slots:
          collectionId: path.collectionId
      - text: Show how collection {collectionId} is tagged.
        slots:
          collectionId: path.collectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/collections/{collectionId}/tags'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a collection's tags
      effect: write
      questions:
      - How do I tag a collection?
      - Will setting collection tags remove the ones already there?
      instructions:
      - text: Set the tags on collection {collectionId} to {tags}.
        slots:
          collectionId: path.collectionId
          tags: requestBody.tags
      - text: Replace all tags of collection {collectionId} with {tags}.
        slots:
          collectionId: path.collectionId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tags/{slug}/entities'].get
  update:
    x-apievangelist-phrasing:
      intent: Find elements carrying a tag
      effect: read
      questions:
      - Which workspaces, APIs and collections share a given tag?
      - Can I filter tagged elements to only collections?
      - Which Postman plans support tagging?
      instructions:
      - text: Find everything tagged {slug}.
        slots:
          slug: path.slug
      - text: List {entityType} elements tagged {slug}.
        slots:
          entityType: query.entityType
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace's tags
      effect: read
      questions:
      - What tags are applied to this workspace?
      - Can I read a workspace's tags?
      instructions:
      - text: Get the tags on workspace {workspaceId}.
        slots:
          workspaceId: path.workspaceId
      - text: Show how workspace {workspaceId} is tagged.
        slots:
          workspaceId: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}/tags'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a workspace's tags
      effect: write
      questions:
      - How do I tag a workspace?
      - Does setting workspace tags overwrite the existing ones?
      instructions:
      - text: Set the tags on workspace {workspaceId} to {tags}.
        slots:
          workspaceId: path.workspaceId
          tags: requestBody.tags
      - text: Replace all tags of workspace {workspaceId} with {tags}.
        slots:
          workspaceId: path.workspaceId
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tags/{entityType}/{entityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get tags for any entity by type
      effect: read
      questions:
      - Is there one generic endpoint to read tags for an API, collection or workspace by type?
      - Can I get an entity's tags by passing its type and ID?
      instructions:
      - text: Get the tags on {entityType} {entityId} via the generic entity-tags endpoint.
        slots:
          entityType: path.entityType
          entityId: path.entityId
      - text: Look up tags for entity {entityId} of type {entityType}.
        slots:
          entityId: path.entityId
          entityType: path.entityType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tags/{entityType}/{entityId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace tags on any entity by type
      effect: write
      questions:
      - Is there a generic endpoint to set tags on an entity given its type and ID?
      - To add a tag without losing the others, do I need to resend the current list?
      instructions:
      - text: Replace the tags on {entityType} {entityId} with {tags} via the generic endpoint.
        slots:
          entityType: path.entityType
          entityId: path.entityId
          tags: requestBody.tags
      - text: Set tags {tags} on entity {entityId} of type {entityType}.
        slots:
          tags: requestBody.tags
          entityId: path.entityId
          entityType: path.entityType
      method: generated
      generated: '2026-09-26'

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/postman-tags-api-phrasing-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.