<commit_before>---
title: Service Broker API
---

## <a id='changelog'></a>Document Changelog ##

[v2 API Change Log](v2-api-changelog.html)

## <a id='versions'></a>Versions ##

Two major versions of the Service Broker API are currently supported by Cloud
Foundry, v1 and v2.
As v1 is deprecated and support will be removed in the next major version of
Cloud Foundry, it is recommended that all new brokers implement v2 and current
brokers are upgraded.

<div style="width:50%">
  <table>
    <thead>
      <tr>
        <th>Current Version</th>
        <th>Past Versions</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>2.2</td>
        <td><a href="api-v2.1.html">2.1</a><br/><a href="api-v2.0.html">2.0</a><br/><a href="api-v1.html">v1 (unversioned)</a></td>
      </tr>
    </tbody>
  </table>
</div>

## <a id='changes'></a>Changes ##

### <a id='change-policy'></a>Change Policy ###

* Existing endpoints and fields will not be removed or renamed.
* New optional endpoints, or new HTTP methods for existing endpoints, may be
added to enable support for new features.
* New fields may be added to existing request/response messages.
These fields must be optional, and should be ignored by clients and servers
that do not understand them.

### <a id='api-changes-since-v2.1'></a>Changes Since v2.1 ###
<commit_msg>Correcting an anchor to remove invalid character<commit_after>---
title: Service Broker API
---

## <a id='changelog'></a>Document Changelog ##

[v2 API Change Log](v2-api-changelog.html)

## <a id='versions'></a>Versions ##

Two major versions of the Service Broker API are currently supported by Cloud
Foundry, v1 and v2.
As v1 is deprecated and support will be removed in the next major version of
Cloud Foundry, it is recommended that all new brokers implement v2 and current
brokers are upgraded.

<div style="width:50%">
  <table>
    <thead>
      <tr>
        <th>Current Version</th>
        <th>Past Versions</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>2.2</td>
        <td><a href="api-v2.1.html">2.1</a><br/><a href="api-v2.0.html">2.0</a><br/><a href="api-v1.html">v1 (unversioned)</a></td>
      </tr>
    </tbody>
  </table>
</div>

## <a id='changes'></a>Changes ##

### <a id='change-policy'></a>Change Policy ###

* Existing endpoints and fields will not be removed or renamed.
* New optional endpoints, or new HTTP methods for existing endpoints, may be
added to enable support for new features.
* New fields may be added to existing request/response messages.
These fields must be optional, and should be ignored by clients and servers
that do not understand them.

### <a id='api-changes-since-v2-1'></a>Changes Since v2.1 ###

{'fraction_non_alphanumeric': 0.14798372179060304, 'fraction_numerical': 0.017758046614872364, 'mean_word_length': 3.425531914893617, 'pattern_counts': {'":': 0, '<': 79, '<?xml version=': 0, '>': 79, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4390445', 'n_tokens_mistral': 907, 'n_tokens_neox': 889, 'n_words': 306}