# ERROR: Failed to load a required FDB API function. (2204)

**URL:** <https://forums.foundationdb.org/t/error-failed-to-load-a-required-fdb-api-function-2204/4404>\
**Category:** Using FoundationDB\
**Created:** [March 25, 2024, 2:40pm UTC](https://forums.foundationdb.org/t/error-failed-to-load-a-required-fdb-api-function-2204/4404 "2024-03-25T14:40:34Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![erwan](https://sea1.discourse-cdn.com/foundationdb/user_avatar/forums.foundationdb.org/erwan/32/1768_2.png) [@erwan](https://forums.foundationdb.org/u/erwan)\
**Post date:** [March 25, 2024, 2:40pm UTC](https://forums.foundationdb.org/t/error-failed-to-load-a-required-fdb-api-function-2204/4404/1 "2024-03-25T14:40:34Z")

</div>

I am upgrading some tooling from FoundationDB 7.2 to 7.3, and I am having this error with `fdbcli`:

```auto
ERROR: Failed to load a required FDB API function. (2204)

```

It works however if I call `fdbcli --api-version 720` instead of just `fdbcli`.

I imagine I must have some leftovers of 7.2, but where should I look? The only reference I found from this error is in the FDB source code: [Code search results · GitHub](https://github.com/search?q=repo%3Aapple%2Ffoundationdb%20api_function_missing&type=code) so it doesn’t seem to be raised often.

Can I get more details about the real meaning of this error, what kind of issue does it usually reflect?

The version I’m using:

```auto
fdbcli -v
FoundationDB CLI 7.3 (v7.3.27)
source version 57ccdb8fee6d0e5d4488fbc964d7c64909fe0dc2
protocol fdb00b073000000

```

Thank you!

---

<div class="post-metadata">

**Author:** ![PierreZ](https://sea1.discourse-cdn.com/foundationdb/user_avatar/forums.foundationdb.org/pierrez/32/866_2.png) [@PierreZ](https://forums.foundationdb.org/u/PierreZ)\
**Post date:** [March 27, 2024, 8:19am UTC](https://forums.foundationdb.org/t/error-failed-to-load-a-required-fdb-api-function-2204/4404/2 "2024-03-27T08:19:22Z")

</div>

I think you are trying to use `fdbcli` in 7.3 with a cluster in 7.2, which cannot be done because of the wire protocol compatibility:

> FDB has an internal wire protocol for communication between server processes that is not guaranteed to be stable across versions. Patch releases for the same minor version are protocol-compatible, but different minor versions are not protocol-compatible.

If you want to upgrade the tooling, you need to upgrade everything. There is [procedures available here](https://github.com/apple/foundationdb/wiki/Upgrading-FoundationDB) that you can follow.

---

<div class="post-metadata">

**Author:** ![erwan](https://sea1.discourse-cdn.com/foundationdb/user_avatar/forums.foundationdb.org/erwan/32/1768_2.png) [@erwan](https://forums.foundationdb.org/u/erwan)\
**Post date:** [March 27, 2024, 9:01am UTC](https://forums.foundationdb.org/t/error-failed-to-load-a-required-fdb-api-function-2204/4404/3 "2024-03-27T09:01:15Z")

</div>

Thank you for your response!

I’m actually not really performing an upgrade of a cluster, I’m spinning up a new 7.3 cluster after changing all my k8s build scripts to support it from 7.2 (which is why I’m thinking of possible “leftovers”).

I confirm that all nodes are in 7.3 which is why I don’t understand why I’m seeing this error. Moreoever, when I had different mixed versions in the past, instead of failing `fdbcli` with this message, fdbcli was working but showing the database as “unavailable” with the list of nodes unreachable because of wrong version.

---

<div class="post-metadata">

**Author:** ![hikouki-gumo](https://avatars.discourse-cdn.com/v4/letter/h/b3f665/32.png) [@hikouki-gumo](https://forums.foundationdb.org/u/hikouki-gumo)\
**Post date:** [June 12, 2025, 3:41am UTC](https://forums.foundationdb.org/t/error-failed-to-load-a-required-fdb-api-function-2204/4404/4 "2025-06-12T03:41:55Z")

</div>

Got the same issue. For my case, it’s due to multi-version clients configuration. Make sure you configure correct lib\_c.

> **[Using FoundationDB Clients — FoundationDB ON documentation](https://apple.github.io/foundationdb/api-general.html#multi-version-client)**
