{
  "info": {
    "_postman_id": "33cafec4-80ba-45f5-abab-c7316b86c083",
    "name": "Bump.sh Api Branches Previews API",
    "description": "This is the official Bump.sh API documentation.  Obviously created\nwith Bump.sh.\n\nThe Bump.sh API is a REST API. It enables you to [create, update](#operation-post-versions)\nor [preview](#operation-post-previews) your API(s) documentation,\n[create stand-alone documentation diffs](#operation-post-diffs) or\n[validate a documentation definition](#operation-post-validations)\n(currently in OpenAPI or AsyncAPI).\n\nOur [webhook](#webhook-documentation-change) also lets you get\nnotifications every time a change is introduced in your API.\n",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T01:16:42.000Z",
    "updatedAt": "2026-07-28T01:16:42.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-33cafec4-80ba-45f5-abab-c7316b86c083"
  },
  "item": [
    {
      "name": "previews",
      "item": [
        {
          "name": "{preview_id}",
          "item": [
            {
              "name": "Update an Existing Preview",
              "id": "da421659-46a0-43f1-bfd9-dfe8fcfa26df",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "method": "PUT",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/previews/:preview_id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "previews",
                    ":preview_id"
                  ],
                  "variable": [
                    {
                      "id": "7ba8d4f3-aba0-47c5-99dd-8ee85fe360bc",
                      "key": "preview_id",
                      "value": "<string>",
                      "description": "(Required) UUID of an existing preview you wish to update."
                    }
                  ]
                },
                "description": "Update a preview with the given documentation file. The preview will stay active for 30 minutes after the last update.\n"
              },
              "response": [
                {
                  "id": "9b694007-fa40-4fe3-bf82-70314037b743",
                  "name": "200 response",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [
                      {
                        "key": "Content-Type",
                        "value": "application/json"
                      },
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: basic",
                        "key": "Authorization",
                        "value": "Basic <credentials>"
                      }
                    ],
                    "body": {
                      "mode": "raw",
                      "raw": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
                      "options": {
                        "raw": {
                          "headerFamily": "json",
                          "language": "json"
                        }
                      }
                    },
                    "url": {
                      "raw": "{{baseUrl}}/previews/:preview_id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "previews",
                        ":preview_id"
                      ],
                      "variable": [
                        {
                          "key": "preview_id"
                        }
                      ]
                    }
                  },
                  "status": "OK",
                  "code": 200,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
                  "createdAt": "2026-07-28T01:16:43.000Z",
                  "updatedAt": "2026-07-28T01:16:43.000Z",
                  "uid": "35240-9b694007-fa40-4fe3-bf82-70314037b743"
                },
                {
                  "id": "f6abedb1-f119-4bff-8ea7-f9da4a7862a7",
                  "name": "422 response",
                  "originalRequest": {
                    "method": "PUT",
                    "header": [
                      {
                        "key": "Content-Type",
                        "value": "application/json"
                      },
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: basic",
                        "key": "Authorization",
                        "value": "Basic <credentials>"
                      }
                    ],
                    "body": {
                      "mode": "raw",
                      "raw": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
                      "options": {
                        "raw": {
                          "headerFamily": "json",
                          "language": "json"
                        }
                      }
                    },
                    "url": {
                      "raw": "{{baseUrl}}/previews/:preview_id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "previews",
                        ":preview_id"
                      ],
                      "variable": [
                        {
                          "key": "preview_id"
                        }
                      ]
                    }
                  },
                  "status": "Unprocessable Entity (WebDAV) (RFC 4918)",
                  "code": 422,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"message\": \"<string>\",\n  \"errors\": {}\n}",
                  "createdAt": "2026-07-28T01:16:43.000Z",
                  "updatedAt": "2026-07-28T01:16:43.000Z",
                  "uid": "35240-f6abedb1-f119-4bff-8ea7-f9da4a7862a7"
                }
              ],
              "createdAt": "2026-07-28T01:16:42.000Z",
              "updatedAt": "2026-07-28T01:16:42.000Z",
              "uid": "35240-da421659-46a0-43f1-bfd9-dfe8fcfa26df"
            }
          ],
          "id": "1c3ebb0d-b49a-47b2-bf06-d2518fa3304d",
          "createdAt": "2026-07-28T01:16:42.000Z",
          "updatedAt": "2026-07-28T01:16:42.000Z",
          "uid": "35240-1c3ebb0d-b49a-47b2-bf06-d2518fa3304d"
        },
        {
          "name": "Create a Preview",
          "id": "08fc3fa5-a4c3-4177-a650-438f792f31df",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
              "options": {
                "raw": {
                  "headerFamily": "json",
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/previews",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "previews"
              ]
            },
            "description": "Create a preview for a given documentation file. The preview will have a unique temporary URL, and will be active for 30 minutes.\n"
          },
          "response": [
            {
              "id": "a44338c4-4a24-4080-a88a-6e65576b6da7",
              "name": "201 response",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: basic",
                    "key": "Authorization",
                    "value": "Basic <credentials>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/previews",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "previews"
                  ]
                }
              },
              "status": "Created",
              "code": 201,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
              "createdAt": "2026-07-28T01:16:43.000Z",
              "updatedAt": "2026-07-28T01:16:43.000Z",
              "uid": "35240-a44338c4-4a24-4080-a88a-6e65576b6da7"
            },
            {
              "id": "203459a8-c2e3-4e92-bc30-896ba02acfd8",
              "name": "422 response",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: basic",
                    "key": "Authorization",
                    "value": "Basic <credentials>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"definition\": \"<string>\",\n  \"references\": [\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    },\n    {\n      \"location\": \"<string>\",\n      \"content\": \"<string>\"\n    }\n  ],\n  \"url\": \"<uri>\",\n  \"id\": \"<string>\",\n  \"expires_at\": \"<dateTime>\",\n  \"public_url\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/previews",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "previews"
                  ]
                }
              },
              "status": "Unprocessable Entity (WebDAV) (RFC 4918)",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"message\": \"<string>\",\n  \"errors\": {}\n}",
              "createdAt": "2026-07-28T01:16:43.000Z",
              "updatedAt": "2026-07-28T01:16:43.000Z",
              "uid": "35240-203459a8-c2e3-4e92-bc30-896ba02acfd8"
            }
          ],
          "createdAt": "2026-07-28T01:16:42.000Z",
          "updatedAt": "2026-07-28T01:16:42.000Z",
          "uid": "35240-08fc3fa5-a4c3-4177-a650-438f792f31df"
        }
      ],
      "id": "9beb51ad-7db7-4d1f-b223-0991b4037748",
      "createdAt": "2026-07-28T01:16:42.000Z",
      "updatedAt": "2026-07-28T01:16:42.000Z",
      "uid": "35240-9beb51ad-7db7-4d1f-b223-0991b4037748"
    }
  ],
  "auth": {
    "type": "basic",
    "basic": [
      {
        "key": "username",
        "value": "{{basicAuthUsername}}",
        "type": "string"
      },
      {
        "key": "password",
        "value": "{{basicAuthPassword}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://bump.sh/api/v1"
    }
  ]
}