API access to Intervals.icu

Guide
673

Username is the string API_KEY

674

Thanks, that was a rather stupid mistake

675

If you do a quick search on the forum for that string, you’ll see that you are not alone making that mistake.
So don’t go banging you head against the wall :wink:

676

Edit a message via API

UI has already the option to edit a message. Would be nice to get this also on API level @david

put /api/v1/chats/{id}/messages/{msgId}

I want to get away from my current workaround:

Edit Logic to perform a deleteChatMessage followed by a sendPrivateMessage instead of calling a PUT endpoint.

677

Add Images via API for chats

@david similar request, UI can, API can´t not yet

Request URL https://intervals.icu/api/chats/image-attachment
Request Method POST

678

avg_lr_balance is a float - what does it represent?
i.e.
47.425816

679

It is left %.

680

I’m looking for the endpoint to update the (manual) FTP through the API. Does this endpoint exist?

681

you can plan workouts and upload them to Intervals.icu.

You can either create them directly in the Intervals.icu calendar using the built‑in workout editor, or send planned workouts via the API using the /events/bulk endpoint and a valid API key / OAuth token. If you share how you are trying to do it (web interface, API, which tool), I can help you pinpoint what’s going wrong.

682

If that’s the case, why are all my numbers < 50%, but the intervals gui says
Avg L/R 52/48 ? (and my wahoo headunit agrees with 52/48)

683

Gracias

1 Like
684

There were some issues a while ago, but I thought this was all sorted.
Here’s a link with more details (could be quit boring :wink: )

I don’t know what the actual situation on Wahoo is, I use Garmin and that is correctly displayed.

685

Maybe someone can help. I’m trying out the API and so far it works great for me. Only issue is, that my Garmin has no VO2max calculation for cycling and therefor I have no value to extract via Intervals.ICU.

But there is a diagram for a calculated VO2max based on my activities. Any possibility to extract the calculated VO2max value from the diagram via API and not via export?

686

If you mean the value on the power page, it‘s calculated from the 5 minute peak power value. So you could just read out that value and do a simple calculation to get the value:

image
image1493×895 172 KB

687

I’ve meant the diagram from the user mayer, but the VO2max calculation from the power page is similar enough. However I’ve tried that before and already implemented the calculation logic. I was just unable to extract the 5min power via API.

688

hi.
how can I get my current season start date and name?

I tried with hoping that that give me all my sesons start date but I get an empy json

https://intervals.icu/api/v1/athlete/xxxxxx/events?category=SEASON_START

thanks

689

Hi,

I’m trying to use the basic API and I get a access denied error.

I get the same when testing using Intervals.icu API docs

Screenshot_20260302-082653.Vivaldi
Screenshot_20260302-082653.Vivaldi1220×2712 234 KB

Am I doing something wrong?

Thanks
Rui

690

Yeah probably.

Did you really use, as told many times in this forum, the username “API_KEY”? So this is literally the username for all. Not your credentials (the Api key from the settings), this is “only” used as password.

691

I guess the usual mistake…

The user is ‘API_KEY’ (NOT your apikey but the literal string)
The password is your apikey.

1 Like
692

Thx both for the prompt help. And apologies I understand it’s frustrating when this has been mentioned multiple times. Maybe to.make it even more clear to new users you could write it in bold red underlined letters in the API document :rofl:

Or just default the value and not make it an input if it is always API_KEY this would most likely avoid all confusions.

I honestly spent all day yesterday and even asked LLMs for help and we both did the same mistake…