Mode Memberships API
The Memberships API from Mode — 2 operation(s) for memberships.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mode-memberships-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 0.0.1
title: Mode Account Memberships API
description: 'Mode provides a REST API for many common operations, such as:
* Listing spaces and reports
* Running reports
* Downloading query results
## Authentication
For most Mode API calls, the client must supply an API token and secret for
HTTP basic authentication.
If authentication is required for a given resource, unauthenticated requests
will result in a `401 Unauthorized` response.
[Create and Manage API Tokens](https://modeanalytics.com/settings/access_tokens)
'
termsOfService: https://mode.com/tos/
contact:
name: Mode API Team
email: support@modeanalytics.com
license:
name: MIT
servers:
- url: https://modeanalytics.com/api
security:
- accessTokenAuth: []
tags:
- name: Memberships
paths:
/{workspace}/memberships:
x-summary: Workspace Memberships
get:
operationId: listMemberships
summary: List memberships
description: Returns a list of `Membership`s
responses:
'401':
description: Unauthorized
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Unauthorized'
'404':
description: '`Workspace` not found'
content:
application/hal+json:
schema:
$ref: '#/components/schemas/NotFound'
parameters:
- name: workspace
in: path
description: '`Workspace` username'
required: true
schema:
type: string
tags:
- Memberships
/{workspace}/memberships/{membership}:
x-summary: Workspace Membership
get:
operationId: getMembership
summary: Get a membership
description: Returns a representation of a `Membership`
responses:
'401':
description: Unauthorized
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Unauthorized'
'404':
description: '`Membership` not found'
content:
application/hal+json:
schema:
$ref: '#/components/schemas/NotFound'
'200':
description: '`Membership` response'
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Membership'
parameters:
- name: workspace
in: path
description: '`Workspace` username'
required: true
schema:
type: string
- name: membership
in: path
description: '`Membership` token'
required: true
schema:
type: string
tags:
- Memberships
delete:
operationId: deleteMembership
summary: Delete a membership
description: Deletes a `Membership`
responses:
'401':
description: Unauthorized
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Unauthorized'
'404':
description: '`Membership` not found'
content:
application/hal+json:
schema:
$ref: '#/components/schemas/NotFound'
'400':
description: Bad request
content:
application/hal+json:
schema:
$ref: '#/components/schemas/BadRequest'
'200':
description: '`Membership` response'
content:
application/hal+json:
schema:
$ref: '#/components/schemas/Membership'
parameters:
- name: workspace
in: path
description: '`Workspace` username'
required: true
schema:
type: string
- name: membership
in: path
description: '`Membership` token'
required: true
schema:
type: string
tags:
- Memberships
components:
schemas:
MembershipEmbeds: {}
BadRequest:
required:
- id
- message
properties:
id:
type: string
enum:
- bad_request
message:
type: string
Unauthorized:
required:
- id
- message
properties:
id:
type: string
enum:
- unauthorized
message:
type: string
Membership:
properties:
admin:
type: boolean
invited:
type: boolean
state:
type: string
member_username:
type: string
member_token:
type: string
activated_at:
type: string
managed_by_scim:
type: boolean
_links:
$ref: '#/components/schemas/MembershipLinks'
_embedded:
$ref: '#/components/schemas/MembershipEmbeds'
required:
- _links
- admin
- state
- member_username
- member_token
- activated_at
NotFound:
required:
- id
- message
properties:
id:
type: string
enum:
- not_found
message:
type: string
MembershipLinks:
properties:
self:
$ref: '#/components/schemas/Link'
web_self:
$ref: '#/components/schemas/Link'
web_self_unban:
$ref: '#/components/schemas/Link'
web_self_approve:
$ref: '#/components/schemas/Link'
organization:
$ref: '#/components/schemas/Link'
user:
$ref: '#/components/schemas/Link'
web_self_download_profile:
$ref: '#/components/schemas/Link'
web_self_confirm_destroy:
$ref: '#/components/schemas/Link'
groups:
$ref: '#/components/schemas/Link'
required:
- self
- web_self
- organization
- groups
Link:
required:
- href
properties:
href:
type: string
templated:
type: boolean
default: false
securitySchemes:
accessTokenAuth:
type: http
scheme: basic