Swift Docs
  • Overview
    • Disclaimer
  • Quick guides
    • Quick Start Guide Links
      • 1. Download Syncro App
      • 2. Create an account or Log in
      • 2. Create an Athlete
      • 3. Design your first test
      • 4. Setting up your tripods
      • 5. Connect your system to Syncro App
      • 6. Run your first test
    • Product Brochures
      • Timing Systems
      • EZEJUMP
      • Yardstick
  • Product Manuals
    • EZEJUMP
      • Test Design
    • Timing Systems
      • Getting Started
      • Tripod Setup
    • Syncro App
    • Labs
      • What is Swift Labs?
      • Creating a Swift Labs account
      • Displaying and update Sprint Bound Index in Labs
      • Displaying Split Velocities in Labs
      • Assigning Athlete Permissions to Coaches
      • Missing data from Swift Labs
      • Labs Organisation Transfer
      • Updating Athlete DOB
      • Exporting Labs Data
      • Using QR Code Stickers for Athlete Identification (ID)
      • Creating and Inviting Coaches
      • Importing athletes via CSV
      • Creating an API key
      • Upgrading your Labs Subscription
  • Developers
    • API Integration
      • Creating an API key
  • FAQ
    • FAQ
      • How do I send diagnostics info?
      • How do I charge my Device?
      • What are “Run Options” in Syncro Test designer ?
      • Where should I place gates?
      • What is a ‘target gate’
      • What is Reaction Mode?
      • What are starting modes?
      • What is the maximum distance gates will work over?
      • Can I split up my system into smaller systems?
      • How do I repair my Tripod?
      • What is the Maximum range between iPad and access point Timing Gate?
      • How long does a Gate battery last?
      • How long does an EZEJUMP battery last?
      • What is a Combine Vertical Jump Test?
      • When do I turn 'Beam trigger off'?
      • What is Speed Sprint?
      • What is 'time in turn'?
      • Is there any limitation when using a device on the ground?
      • Why doesn't the finish gate beep?
      • How do I flash Recovery firmware to my Gate?
      • How to hardware reset a gate
      • My timing Gate is constantly reporting 55% battery, how do I fix it?
      • Will be the Syncro app be released on Android ?
    • Contact
Powered by GitBook
On this page

Was this helpful?

  1. Product Manuals
  2. Labs

Creating an API key

PreviousImporting athletes via CSVNextUpgrading your Labs Subscription

Last updated 3 years ago

Was this helpful?

It’s important to remember that the token is exactly the same as giving someone your email and password. They will have access to act on behalf of you, be careful who you share your token to.

Creating an API key allows you to obtain access to the platform without having to login through the Swift Labs web application. The API key can be used to add and modify athlete and squad information and pull athlete activity data as well as additional administration functions.

Creating the Key

Navigating to your organisation settings and clicking on the last tab within the organisation settings will take you to your API keys for your organisation.

Organisation API Keys

Clicking on the “Add Key” will take you to create a new API Key. To create a new key, three components are required, including; the token name, expiry and token scopes.

By default the token expiry is set to the maximum of three months and must be manually renewed once the token has expired.

Creating an API KeyAPI Token

Token Scopes

Token scopes restrict the amount of functionality the token has with the account. Selecting the athletes:read token will prevent the token from being able to create or remove an athlete. This gives you fine grain control over the amount of functionality and access the token has. Using the table below, you should determine the level of access required.

Scope
Description

coaches:read

Read coaches for your organisation.

athletes:read

Read the athletes of your organisation.

athletes:create

Create athletes for your organisation.

athletes:update

Update athletes for your organisation.

athletes:remove

Remove athletes for your organisation.

squads:read

Read the squads for your organisation.

squads:create

Create squads for your organisation.

squads:update

Update squads for your organisation.

squads:remove

Remove squads for your organisation.

squads:athletes

List the athletes that are members of the squad.

squads:coaches

List the coaches that are members of the squad

squads:add_coaches

Add coaches to the squad.

squads:add_athletes

Add athletes to the squad.

squads:remove_coaches

Remove coaches from the squad.

squads:remove_athletes

Remove athletes from the squad.

activity:read

Read activities of an athlete, acthlete:read also required.

activity:remove

Remove activities of an athlete, athlete:read also required.

org:read

Read your organisation details.

org:write

Update your organisation details.

org:users_read

Read the users for your organisation.

org:users_update

Update the users for your organisation.

org:users_remove

Remove users from your organisation.

user:read

Read your user profile.

user:write

Update your user profile.

Using your token

Authorization: JndHI3iPWR3n6oeMKyOeB1BAs4kbobfchkvakZG9b4sTuSZSr3kjBb3eZA5EjADt3XwP6SGmK0qibs82jIlb3w==

Additional Information

Common errors to look out for:

An invalid token will generate the following error.

{     "Message": "Unable to authorize user."}

A token without the required scope will through this error detailing the required scope for the request.

{     "Message": "Unable to authorize token, could not find scope athletes:read."}

And remember

It’s important to remember that the token is exactly the same as giving someone your email and password. They will have access to act on behalf of you, be careful who you share your token to.

Was this article helpful?

Like Dislike 0

Using an application like is an ideal way to test your API key. Appending the token you just generated with the Authorization header, will authorise the requests so long as the token has not expired and has the required scopes.

Athletes API request.

Additional information on the API requests available can be found within our API documentation here.

Postman
https://swiftperformance.blob.core.windows.net/api/docs/index.html?url=/api/public/SwiftAPI_latest.json