1Password Connect: GetFileContent fails with "need at least version 1.3.0" on Connect 1.5.4

TL;DR

For "error with GetFileContent: need at least version 1.3.0 of Connect for this function,": upgrade your Connect server images to 1.5.5 or later. Set the image tag to 1.5.5 (or newer) for connect-api and connect-sync.

error with GetFileContent: need at least version 1.3.0 of Connect for this function,
detected version 1.2.0 (or earlier). Please update your Connect server

Steps

1. Calling GetFileContent through connect-sdk-go against Connect server 1.5.4 errors with:

error with GetFileContent: need at least version 1.3.0 of Connect for this function,
detected version 1.2.0 (or earlier). Please update your Connect server

2. The call worked fine against 1.5.0. The version in the error is wrong: the server

really is 1.5.4.

3. This is a bug in the Connect server itself, in how the File object's content_path

is handled in 1.5.4. The SDK asks the server for the file content, the server's version detection misfires, and you get the bogus "update your Connect server" message. Nothing is wrong with your SDK version or your vault items.

4. Upgrade your Connect server images to 1.5.5 or later. In the connect-helm-charts

setup that means bumping both connect-api and connect-sync:

5. Check what you are running now: kubectl get deploy -l app=connect -o jsonpath and look at the image tags, or check your helm values.

6. Set the image tag to 1.5.5 (or newer) for connect-api and connect-sync.
7. helm upgrade and wait for the rollout to finish.
8. Retry the GetFileContent call. It should work immediately.
9. Report the exact version pair (SDK version and both server image versions), since the

1.5.5 fix was specifically for this 1.5.4 regression. A different pair failing the same way would be a new bug, not this one.

When to use

You are seeing this: Calling GetFileContent through connect-sdk-go against Connect server 1.5.4 errors with: `` error with GetFileContent: need at least version 1.3.0 of Connect for this function, detected version 1.2.0 (or earlier). Use this skill when you run into "1Password Connect: GetFileContent fails with "need at least version 1.3.0" on Connect 1.5.4".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: server 1.5.4, 1.3.0, 1.2.0, against 1.5.0, 1.5.5. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

A user asked why GetFileContent from the 1Password Connect Go SDK panicked on Connect server 1.5.4 with "need at least version 1.3.0 of Connect for this function, detected version 1.2.0", even though the server was 1.5.4 and the same call worked on 1.5.0. The verified resolution: this was a Connect server bug in the File object contentpath handling, fixed in v1.5.5; upgrading the connect-api and connect-sync images to 1.5.5 or later makes GetFileContent work again. Thread: https://vectle.com/threads/thrlIWl6wd3l4I0-kDZhJs9Rg