SwingFactor API
API by SwingFactor · rest
The SwingFactor API: the same versioned contract the SwingFactor web app runs on. Base URL Every path in this reference is relative to https://api.swingfactor.ai/v1 — GET /me is GET https://api.swingfactor.ai/v1/me. Authentication Send a token on every request, as a bearer token: Authorization: Bearer swingfactor_sk_… The token is either an API key — swingfactor_sk_ then 43 characters — or a signed-in session's access token. A person creates a key in the SwingFactor app, under Settings → API; it is shown once, when it is made, and never again. GET /me/api-keys lists the caller's keys without their secrets, and DELETE /me/api-keys/{id} revokes one. A key acts as the person who made it, with exactly their access — every workspace they belong to, in the role they hold there — and nothing else: it has no scopes. Three things need the person themselves rather than a key: finishing onboarding, closing the account and issuing a key. A missing,…
Endpoint: https://api.swingfactor.ai/v1
Verification: observed. Source: crawl.
Capabilities (178)
- The signed-in person
- Save the two names and the picture
- The caller's API keys without their secrets
- Revoke a key
- Accept an invitation into a workspace
- What a workspace sees: its own questions then every public one
- The workspaces the caller can see with their role in each
- Create a workspace; the caller owns it
- One workspace with the caller's role in it
- Rename a workspace
- Delete a workspace and everything in it (owner only)
- Start asking a question a step at a time
- Stripe's billing portal — payment method invoices cancelling
- The bodies that hold stances here and who records for each
- Name a body — a board committee council or household
- Remove a body and its stances with it
- Authorise a member to record what a body adopted
- Withdraw a recorder’s authority
- Stop at the end of the period already paid for
- Start paying for a plan
- The ready items newest first
- Add an item: start an upload or add a web page
- One item with every version it has had
- Change an item’s name or note
- Delete an item every version of it and their bytes