Fetch detailed information from an existing diff

GET /diffs/{id}

Fetch the result of a previously created diff with the POST /diffs API endpoint.

Path parameters

  • id string Required

    UUID of an existing diff from which to fetch diff details

Query parameters

  • formats array[string]

    A list of formats to render in the response. Possible values are text, markdown, html or json. If not provided defaults to render both text and markdown formats.

Responses

  • 200 application/json

    Diff successfully retrieved

    Hide response attributes Show response attributes object
    • id string

      Unique id of your diff

    • title string

      The title of the last parsed definition

    • The public URL of your diff

    • breaking boolean

      Identifies if the diff includes breaking changes

    • details array[object]

      Details of each change as a list of diff items. Present only if json format has been requested

      Hide details attributes Show details attributes object
      • id string

        The identifier of the diff change

      • name string

        The human name of diff change

      • status string

        Values are added, modified, or removed.

      • type string

        The object type of the diff change

      • breaking boolean

        Identifies if the item is a breaking change

      • previous object

        Object attributes values, before change. Possible attributes depend on the object type ('endpoint', 'body', 'response'…)

      • current object

        Object attributes values, after change. Possible attributes depend on the object type ('property', 'operation', 'message'…)

      • Represents breaking change reasons, used to give more context about this question: why is this change breaking?

        Hide breaking_details attributes Show breaking_details attributes
        • This property is used to generate the human message about breaking change reason

        • breaking_attributes array[string]

          When diff status is modified, this property is an array including every modified attribute responsible of the breaking change.

      • A list of children item changes

    • URL of previous version specification, in JSON format

    • URL of current version specification, in JSON format

    • markdown string

      The comparaison diff summary in markdown format. Present only if markdown format has been requested.

    • html string

      The comparaison diff summary in HTML format. Present only if html format has been requested.

    • text string

      The comparaison diff summary in plain text format. Present only if text format has been requested.

  • 202

    Diff is still being processed. Please try again later

  • 404

    Diff not found

GET /diffs/{id}
curl \
 -X GET https://bump.sh/api/v1/diffs/{id}
Response examples (200)
{
  "id": "2361df99-1234-4c80-a0cc-45c9fe565812",
  "public_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812",
  "breaking": false,
  "previous_version_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812/previous.json",
  "current_version_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812/current.json",
  "text": "Updated: POST /versions\n  Response modified: 201\n    Body attribute added: doc_id\n",
  "markdown": "## Modified (1)\n\n* `POST /user`\n  * Path parameters added: `id`, `email`\n  * Query parameters added: `period`, `limit`\n"
}
{
  "id": "2361df99-1234-4c80-a0cc-45c9fe565812",
  "public_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812",
  "breaking": false,
  "previous_version_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812/previous.json",
  "current_version_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812/current.json",
  "html": "<ul class=\"changelog-event__diff expandable\" data-expander-target=\"content\">\n  <li class=\"changelog-event__diff-operation added\">\n     Added: <a href=\"http://localhost:3000/diff/c1e36203-5b04-4adc-b8c5-8ac626ce8592#operation-get-diffs-parameter\"><code class=\"code-inline root\">GET /diffs/{id}</code></a>\n  </li>\n</ul>\n"
}
{
  "id": "2361df99-1234-4c80-a0cc-45c9fe565812",
  "public_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812",
  "breaking": false,
  "previous_version_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812/previous.json",
  "current_version_url": "https://bump.sh/diff/2361df99-3467-4c80-a0cc-45c9fe565812/current.json",
  "details": [
    {
      "id": "post-versions",
      "name": "POST /versions",
      "status": "added",
      "type": "endpoint",
      "breaking": false,
      "children": []
    }
  ]
}