Connect Vekta to AI assistants

Edited

Connect Claude Code, Codex or Gemini CLI to your Vekta data, then ask questions and plan training in plain language.

For: Coaches · Athletes Apps: Web (to create your key), Claude Code, Codex or Gemini CLI on a Mac or Windows computer

What an AI assistant can do with Vekta

Vekta already models every session you record. Connecting an assistant lets you ask anything about that data and build the tools you want, without writing code yourself.

  • Ask questions: for example how this block compares with last year, or which athletes slept badly this week.

  • Build your own tools: reports, dashboards or a morning summary of your athletes.

  • Write back into Vekta: plan workouts, add notes and events and comment on activities from the conversation. Workouts you plan this way reach the athlete's devices.

It is for coaches and for self-coached athletes. The connection uses the Vekta API, which is included with every Vekta subscription at no extra cost.

What you need

  • An active Vekta subscription: your key reads your own data only while you are subscribed. For a coach, an athlete's data is readable while that athlete has an active subscription, whoever pays for it.

  • To be 18 or over: minors can't create an API key.

  • A Mac or Windows computer: Claude Code, Codex and Gemini CLI run on your own computer.

  • An account with the assistant you pick: with Anthropic for Claude Code, OpenAI for Codex or Google for Gemini CLI. Claude Code and Codex need a paid plan.

  • No coding: you paste one prompt and the assistant does the rest. The code it writes stays on your computer.

Connect your assistant

Setup takes a few minutes and you only do it once per computer.

Copy the setup prompt
Go to joinvekta.com/api and select Copy setup prompt on the card for Claude Code, Codex or Gemini CLI.

Paste it into your assistant
Open your assistant on your computer, paste the prompt and send it.

Create your key when Vekta opens
Vekta opens in your browser. Create an API key (see "Create and manage your API keys" below) and copy it.

Let the assistant pick it up
Your assistant picks up the key and stores it on your computer, so the key never goes into the chat. You can then start asking questions.

The setup prompt also leaves a note that the assistant reads at the start of every new chat, so it finds your key again next time.

Create and manage your API keys

Your key is what lets the assistant reach your data. You create and delete keys yourself, with no need to contact us.

Create a key
In Vekta, open Settings > API, select New API key. The key is ready straight away.

Use one key per tool
You can hold up to 10 keys, and rename or delete any of them on the same screen.

Keep it private
Your key reaches your data, and your athletes' data if you coach, so treat it like a password. Don't paste it into a chat, share it or put it in code you publish. If it is ever exposed, delete it in Settings > API and create a new one.

What your assistant can read and change

Your key reads what your account can see in Vekta, and writes only what you ask it to.

Data

Read

Create, change or delete

Profile and metrics history (weight, Critical Power, W′, critical speed, D′, VO2max…)

Yes

No

Activities, with streams, laps, climbs, pool lengths and best efforts

Yes

No

Comments on activities

Yes

Yes. Your comment notifies the athlete in the mobile app

Planned workouts, with their structure

Yes

Yes. They are sent to the athlete's connected devices, unless hidden

Training Library workouts

Yes

Yes

Notes and events

Yes

Yes

Sleep and Daily Wellness Check-in answers

Yes

No

Workspace invitations

No

Invite an athlete or a coach

Your assistant can't upload, edit or delete activities, change metrics or zones, or change your settings. To add an activity, drag its FIT file onto your Calendar in the web app.

Start with a Vekta Skill

Vekta Skills are ready-made prompts and tools for jobs coaches and athletes do every week, such as a morning check-in on your athletes, planning the week ahead or a race debrief. Browse them at joinvekta.com/skills.

Run a skill
Paste its prompt into Claude Code, Codex or Gemini CLI. Or install its file: unzip it into ~/.claude/skills for Claude Code, or ~/.agents/skills for Codex and Gemini CLI.

Scheduled skills need your computer on
A skill that runs every day or every week runs on your own computer, so the computer has to be on at that time.

Skills that write ask first
Every skill that writes to Vekta asks you to confirm before it does. Each skill's page lists what it reads and what it writes.

Unlocking a skill's prompt and file asks for your name and email address.

Claude and ChatGPT in a browser

The browser versions of Claude and ChatGPT can't connect to Vekta yet, because they can't call the API from your computer. Use Claude Code, Codex or Gemini CLI instead. A Vekta MCP server, which will bring the same access to Claude and ChatGPT in a browser, is coming.

For coaches: your athletes' data

A coach's key reaches the athletes in every Workspace where you are a coach or an admin. That access comes with responsibilities towards your athletes.

  • Which athletes: athletes in Workspaces where you are a coach or admin, while they have an active subscription. Your own subscription doesn't affect access to their data.

  • Set by your admin: Workspace admins choose, coach by coach, who can reach the Workspace's athletes through the API.

  • Tell your athletes and get their consent: inform your athletes, and get their explicit consent before you process their health data outside Vekta or send it to an AI provider. Athletes under 18 need parental authorisation.

  • Delete their data when they leave: delete any athlete data you hold outside Vekta within 30 days after the athlete leaves your Workspace.

  • Keep keys personal: don't share a key with another coach. Each coach creates their own.

  • Don't train AI models on Vekta data: this and other limits are set out in the API Rules.

Frequently asked questions

Can I connect Vekta to ChatGPT or Claude in my browser?

Not yet. Use Claude Code, Codex or Gemini CLI on your computer. A Vekta MCP server for the browser versions is coming.

Do I need to know how to code?

No. You paste one prompt, then ask in plain language. The assistant writes and runs the code for you.

Does the API cost extra?

No. It is included with every Vekta subscription. The assistant itself needs its own account, and Claude Code and Codex need a paid plan.

I'm a coach and my assistant says I have no subscription. Why?

Your key reads your own training only if your own account has an active subscription. Your athletes' data depends on their subscriptions, not yours, so it still works.

A new chat can't find my key. What do I do?

Tell the assistant that the key is stored on this computer and ask it to find it and carry on.

I pasted my key into a chat by mistake. What do I do?

Delete that key in Settings > API, create a new one and run the setup prompt again.

Can my assistant upload FIT files to Vekta?

No, the API has no upload. Drag your FIT files onto your Calendar in the web app. Learn more in Import your training history.

Will my assistant change my athletes' plans on its own?

Only if you ask it to. Skills that write ask you to confirm first, and some save planned workouts hidden, as drafts only you can see until you unhide them.

Can I use the API without an AI assistant?

Yes. It is a standard REST API, so Python, a spreadsheet or a dashboard tool can read it. The full documentation is at docs.joinvekta.com.

Related articles

Was this article helpful?

Sorry about that! Care to tell us more?

Thanks for the feedback!

There was an issue submitting your feedback
Please check your connection and try again.