← PostmanCONTENT HISTORY

Update to Postman

Snapshot Nov 17, 2026 · 18:13 UTC · version 0.9.0

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for collection-schema-v3

Skill instructions — Now says: From Postman CLI 1.87.0, `collection lint` reports an unrecognised field as a warning (`FMT206` in a request, `FMT208` in `definition.yaml`); older...

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save Postman and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Skill instructions

Before

Nov 4, 2026 · 12:08 UTC

workspace manifest mappings.

After

Nov 17, 2026 · 18:13 UTC

From Postman CLI 1.87.0, `collection lint` reports an unrecognised field as a warning (`FMT206` in a request, `FMT208` in `definition.yaml`); older versions drop it without a message. workspace manifest mappings. It lints every entity in...

Supporting files

Before

Nov 4, 2026 · 12:08 UTC

[{"relative_path":"reference/environment.md","size_in_bytes":2232},{"relative_path":"reference/globals.md","size_in_bytes":1213},{"relative_path":"reference/http.md","size_in_bytes":9193},{"relative_path":"reference/other_protocols.md","...

After

Nov 17, 2026 · 18:13 UTC

[{"relative_path":"reference/environment.md","size_in_bytes":2232},{"relative_path":"reference/globals.md","size_in_bytes":1213},{"relative_path":"reference/http.md","size_in_bytes":9881},{"relative_path":"reference/other_protocols.md","...

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -47,8 +47,14 @@
 Run `postman collection lint <collection-path>` for collection changes and
 `postman environment lint <path>` for environment changes. Review warnings as
 well as errors: an ignored field can change behavior even when parsing succeeds.
+From Postman CLI 1.87.0, `collection lint` reports an unrecognised field as a
+warning (`FMT206` in a request, `FMT208` in `definition.yaml`); older versions
+drop it without a message.
 Use `postman workspace lint` when checking relationships across entities or
-workspace manifest mappings.
+workspace manifest mappings. It lints every entity in the workspace and
+`.postman/resources.yaml`, so an error in any one of them fails the whole run,
+and it needs that manifest; `--fix` can rewrite files outside the one you are
+editing, so review its diff.
 
 Inspect the diff for unintended scope changes. When execution is appropriate,
 run the changed request through its collection to check inherited context.
Full technical diff · 2 changed fields

changed /included_files

BEFORE
[
  {
    "relative_path": "reference/environment.md",
    "size_in_bytes": 2232
  },
  {
    "relative_path": "reference/globals.md",
    "size_in_bytes": 1213
  },
  {
    "relative_path": "reference/http.md",
    "size_in_bytes": 9193
  },
  {
    "relative_path": "reference/other_protocols.md",
    "size_in_bytes": 7236
  }
]
AFTER
[
  {
    "relative_path": "reference/environment.md",
    "size_in_bytes": 2232
  },
  {
    "relative_path": "reference/globals.md",
    "size_in_bytes": 1213
  },
  {
    "relative_path": "reference/http.md",
    "size_in_bytes": 9881
  },
  {
    "relative_path": "reference/other_protocols.md",
    "size_in_bytes": 7468
  }
]

changed /skill_md_contents

BEFORE
"---\nname: collection-schema-v3\ndescription: Use when writing or debugging local Postman v3 collection, environment or globals files, including collection lint failures. Preserves the per-entity files, inherited context, and schema shapes that make API changes reusable and reviewable in Git. Use for requests such as \"fix this request YAML\".\n---\n\n# Collection Schema (v3, Git-Native)\n\nA v3 collection is a directory of independently editable entities. A change to\none request, example, or assertion can be reviewed in a PR beside the code it\nchecks, without regenerating a single large collection export.\n\n1. Edit the entity that owns the change. Top-level directories under\n   `postman/collections/` are collections; nested folders organize requests.\n   Requests live in `*.request.yaml`, scope metadata in\n   `.resources/definition.yaml`, and saved responses in\n   `.resources/<request-name>.resources/examples/*.example.yaml`.\n   `.resources/` holds metadata and examples, not runnable request files.\n2. Preserve inherited auth, variables, and scripts when changing a request.\n   Collection/folder definitions supply shared context; copying every inherited\n   field into each request creates competing values and noisy future edits.\n   See **variables** when deciding the scope of a value or secret reference.\n3. Consult the reference section for the entity being changed:\n   [HTTP requests, examples, and definitions](reference/http.md),\n   [environment files](reference/environment.md), or\n   [other protocols](reference/other_protocols.md).\n   Protocols have different URL, body, script, and settings shapes; an HTTP\n   field is not necessarily valid on another request kind.\n   For globals files, use the [globals reference](reference/globals.md).\n   Dataset YAML belongs to **datasets**; mocks belong to **api-mocking**.\n4. Preserve types at the YAML boundary. Quote `{{variables}}` and strings that\n   resemble booleans or numbers; JSON bodies are string content, best expressed\n   with block scalars. A syntactically valid YAML object can still be the wrong\n   request body shape. The HTTP reference gives the exact fields.\n5. Keep edits local to the intended entity. `order` is a numeric relative\n   ordering, so spaced values allow insertion without renumbering siblings.\n   Keep filenames portable and unique case-insensitively; a display `name`\n   can preserve characters that cannot appear in a filename. Renaming a request\n   also requires checking its examples path.\n6. Save examples for behavior consumers need to understand or simulate.\n   Their schemas feed **api-documentation**, **api-mocking**, and\n   **ai-readiness**; structural validity alone does not make an example\n   accurate or useful. Assertions derived from the contract belong with the\n   request through **api-testing**.\n\n## Verification\n\nRun `postman collection lint <collection-path>` for collection changes and\n`postman environment lint <path>` for environment changes. Review warnings as\nwell as errors: an ignored field can change behavior even when parsing succeeds.\nUse `postman workspace lint` when checking relationships across entities or\nworkspace manifest mappings.\n\nInspect the diff for unintended scope changes. When execution is appropriate,\nrun the changed request through its collection to check inherited context.\nFor script changes, check that the changed script executed and produced its\nintended effect; compare assertion counts with the assertions expected for that\nrun. A setup script may intentionally have none, and unrelated passing assertions\ndo not prove the changed script worked. Report structural validation separately\nfrom behavior verified against a target.\n"
AFTER
"---\nname: collection-schema-v3\ndescription: Use when writing or debugging local Postman v3 collection, environment or globals files, including collection lint failures. Preserves the per-entity files, inherited context, and schema shapes that make API changes reusable and reviewable in Git. Use for requests such as \"fix this request YAML\".\n---\n\n# Collection Schema (v3, Git-Native)\n\nA v3 collection is a directory of independently editable entities. A change to\none request, example, or assertion can be reviewed in a PR beside the code it\nchecks, without regenerating a single large collection export.\n\n1. Edit the entity that owns the change. Top-level directories under\n   `postman/collections/` are collections; nested folders organize requests.\n   Requests live in `*.request.yaml`, scope metadata in\n   `.resources/definition.yaml`, and saved responses in\n   `.resources/<request-name>.resources/examples/*.example.yaml`.\n   `.resources/` holds metadata and examples, not runnable request files.\n2. Preserve inherited auth, variables, and scripts when changing a request.\n   Collection/folder definitions supply shared context; copying every inherited\n   field into each request creates competing values and noisy future edits.\n   See **variables** when deciding the scope of a value or secret reference.\n3. Consult the reference section for the entity being changed:\n   [HTTP requests, examples, and definitions](reference/http.md),\n   [environment files](reference/environment.md), or\n   [other protocols](reference/other_protocols.md).\n   Protocols have different URL, body, script, and settings shapes; an HTTP\n   field is not necessarily valid on another request kind.\n   For globals files, use the [globals reference](reference/globals.md).\n   Dataset YAML belongs to **datasets**; mocks belong to **api-mocking**.\n4. Preserve types at the YAML boundary. Quote `{{variables}}` and strings that\n   resemble booleans or numbers; JSON bodies are string content, best expressed\n   with block scalars. A syntactically valid YAML object can still be the wrong\n   request body shape. The HTTP reference gives the exact fields.\n5. Keep edits local to the intended entity. `order` is a numeric relative\n   ordering, so spaced values allow insertion without renumbering siblings.\n   Keep filenames portable and unique case-insensitively; a display `name`\n   can preserve characters that cannot appear in a filename. Renaming a request\n   also requires checking its examples path.\n6. Save examples for behavior consumers need to understand or simulate.\n   Their schemas feed **api-documentation**, **api-mocking**, and\n   **ai-readiness**; structural validity alone does not make an example\n   accurate or useful. Assertions derived from the contract belong with the\n   request through **api-testing**.\n\n## Verification\n\nRun `postman collection lint <collection-path>` for collection changes and\n`postman environment lint <path>` for environment changes. Review warnings as\nwell as errors: an ignored field can change behavior even when parsing succeeds.\nFrom Postman CLI 1.87.0, `collection lint` reports an unrecognised field as a\nwarning (`FMT206` in a request, `FMT208` in `definition.yaml`); older versions\ndrop it without a message.\nUse `postman workspace lint` when checking relationships across entities or\nworkspace manifest mappings. It lints every entity in the workspace and\n`.postman/resources.yaml`, so an error in any one of them fails the whole run,\nand it needs that manifest; `--fix` can rewrite files outside the one you are\nediting, so review its diff.\n\nInspect the diff for unintended scope changes. When execution is appropriate,\nrun the changed request through its collection to check inherited context.\nFor script changes, check that the changed script executed and produced its\nintended effect; compare assertion counts with the assertions expected for that\nrun. A setup script may intentionally have none, and unrelated passing assertions\ndo not prove the changed script worked. Report structural validation separately\nfrom behavior verified against a target.\n"
Full snapshot data
{
  "description": "Use when writing or debugging local Postman v3 collection, environment or globals files, including collection lint failures. Preserves the per-entity files, inherited context, and schema shapes that make API changes reusable and reviewable in Git. Use for requests such as \"fix this request YAML\".",
  "included_files": [
    {
      "relative_path": "reference/environment.md",
      "size_in_bytes": 2232
    },
    {
      "relative_path": "reference/globals.md",
      "size_in_bytes": 1213
    },
    {
      "relative_path": "reference/http.md",
      "size_in_bytes": 9881
    },
    {
      "relative_path": "reference/other_protocols.md",
      "size_in_bytes": 7468
    }
  ],
  "name": "collection-schema-v3",
  "skill_md_contents": "---\nname: collection-schema-v3\ndescription: Use when writing or debugging local Postman v3 collection, environment or globals files, including collection lint failures. Preserves the per-entity files, inherited context, and schema shapes that make API changes reusable and reviewable in Git. Use for requests such as \"fix this request YAML\".\n---\n\n# Collection Schema (v3, Git-Native)\n\nA v3 collection is a directory of independently editable entities. A change to\none request, example, or assertion can be reviewed in a PR beside the code it\nchecks, without regenerating a single large collection export.\n\n1. Edit the entity that owns the change. Top-level directories under\n   `postman/collections/` are collections; nested folders organize requests.\n   Requests live in `*.request.yaml`, scope metadata in\n   `.resources/definition.yaml`, and saved responses in\n   `.resources/<request-name>.resources/examples/*.example.yaml`.\n   `.resources/` holds metadata and examples, not runnable request files.\n2. Preserve inherited auth, variables, and scripts when changing a request.\n   Collection/folder definitions supply shared context; copying every inherited\n   field into each request creates competing values and noisy future edits.\n   See **variables** when deciding the scope of a value or secret reference.\n3. Consult the reference section for the entity being changed:\n   [HTTP requests, examples, and definitions](reference/http.md),\n   [environment files](reference/environment.md), or\n   [other protocols](reference/other_protocols.md).\n   Protocols have different URL, body, script, and settings shapes; an HTTP\n   field is not necessarily valid on another request kind.\n   For globals files, use the [globals reference](reference/globals.md).\n   Dataset YAML belongs to **datasets**; mocks belong to **api-mocking**.\n4. Preserve types at the YAML boundary. Quote `{{variables}}` and strings that\n   resemble booleans or numbers; JSON bodies are string content, best expressed\n   with block scalars. A syntactically valid YAML object can still be the wrong\n   request body shape. The HTTP reference gives the exact fields.\n5. Keep edits local to the intended entity. `order` is a numeric relative\n   ordering, so spaced values allow insertion without renumbering siblings.\n   Keep filenames portable and unique case-insensitively; a display `name`\n   can preserve characters that cannot appear in a filename. Renaming a request\n   also requires checking its examples path.\n6. Save examples for behavior consumers need to understand or simulate.\n   Their schemas feed **api-documentation**, **api-mocking**, and\n   **ai-readiness**; structural validity alone does not make an example\n   accurate or useful. Assertions derived from the contract belong with the\n   request through **api-testing**.\n\n## Verification\n\nRun `postman collection lint <collection-path>` for collection changes and\n`postman environment lint <path>` for environment changes. Review warnings as\nwell as errors: an ignored field can change behavior even when parsing succeeds.\nFrom Postman CLI 1.87.0, `collection lint` reports an unrecognised field as a\nwarning (`FMT206` in a request, `FMT208` in `definition.yaml`); older versions\ndrop it without a message.\nUse `postman workspace lint` when checking relationships across entities or\nworkspace manifest mappings. It lints every entity in the workspace and\n`.postman/resources.yaml`, so an error in any one of them fails the whole run,\nand it needs that manifest; `--fix` can rewrite files outside the one you are\nediting, so review its diff.\n\nInspect the diff for unintended scope changes. When execution is appropriate,\nrun the changed request through its collection to check inherited context.\nFor script changes, check that the changed script executed and produced its\nintended effect; compare assertion counts with the assertions expected for that\nrun. A setup script may intentionally have none, and unrelated passing assertions\ndo not prove the changed script worked. Report structural validation separately\nfrom behavior verified against a target.\n"
}

SHA-256 of public snapshot: f989615f5ff370079d7e571c55c768d5fdab81c5833ab63533d797cfcd620703