Scispot Scispot API - ELN API - Permissions (Super Admin Only) API

### Permissions Endpoint These endpoint allows you to list, add, remove useres from a private folder. #### **Notes**: - The owner of the API token must have Super Admin permissions - These endpoints only work for folders that are already privated

GitHub OpenAPI

Operations 5

GET /labspace/folder/fetch-permissions List Permissions #
POST /labspace/folder/add-permissions Add Permissions #
POST /labspace/folder/lock Lock Folder #
POST /labspace/folder/unlock Unlock Folder #
POST /labspace/folder/remove-permissions Remove Permissions #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/scispot:scispot-scispot-api-eln-api-permissions-super-admin-only-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

scispot-scispot-api-eln-api-permissions-super-admin-only-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Scispot's API Documentation Scispot API - ELN API…
  description: '### Welcome! Feel Free To Visit Scispot.com


    #### Overview


    This is a documentation listing API calls for the following Scispot applications:


    1. Labsheets (LIMS)


    2. ELN


    3. Manifests (plates, boxes, racks, etc.)


    4. Sequences


    ## Getting Started


    ### Create a new API Key in account settings


    - Go to Scispot


    - Click on the "Account" button in the navigation bar on the bottom left corner of your screen


    - Click "Personal Tokens" on the left side of the pop-up modal


    - Click "Generate New Token"


    - Name your token, select token access, and click "Generate"


    - Copy the API Key and save it somewhere safe - this token cannot be retrieved once it is generated


    - This token will be used as "apiKey" in all API requests'
  version: 1.0.0
servers:
- url: https://cloudlab.scispot.io
  description: Scispot Cloud Lab
security:
- bearerAuth: []
tags:
- name: Scispot API - ELN API - Permissions (Super Admin Only)
  description: '### Permissions Endpoint


    These endpoint allows you to list, add, remove useres from a private folder.


    #### **Notes**:


    - The owner of the API token must have Super Admin permissions


    - These endpoints only work for folders that are already privated'
paths:
  /labspace/folder/fetch-permissions:
    get:
      tags:
      - Scispot API - ELN API - Permissions (Super Admin Only)
      summary: List Permissions
      description: 'This endpoint allows you to list permissions to a private folder in the labspace.


        #### **Notes**:


        - The owner of the API token must have Super Admin permissions


        - The folder must already be privated


        Validation notes: provide at least one of uuid, location.


        Provide one of uuid or location. Requires Super Admin API token and a private folder.'
      parameters:
      - name: uuid
        in: query
        schema:
          type: string
          example: <uuid>
        description: The uuid of the folder. If both location and uuid are provided uuid is priortized over location
      - name: location
        in: query
        schema:
          type: string
          example: My Labspace:Protocols Folder
        description: "The location path from where the folders will be fetched. You can seperate the labspace,folders and subfolders by colon(:). It always starts from labspace name.\n  For Example: Labspace_Name:Folder_Name:Subfolder_Name"
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  users:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        name:
                          type: string
                        type:
                          type: string
                      additionalProperties: true
                  teams:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        type:
                          type: string
                      additionalProperties: true
                additionalProperties: true
              example:
                success: true
                users:
                - email: scientist@example.com
                  name: Lab Scientist
                  type: Editor
                teams: []
        '401':
          description: Invalid Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Invalid Authentication Token
        '403':
          description: Missing Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Missing Authentication Token
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Validation error
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Operation failed
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Bad request
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Not found
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Conflict
      operationId: getLabspaceFolderFetchPermissions
      x-operation-id-source: derived
  /labspace/folder/add-permissions:
    post:
      tags:
      - Scispot API - ELN API - Permissions (Super Admin Only)
      summary: Add Permissions
      description: 'This endpoint allows you to add permissions to a private folder in the labspace.


        #### **Notes**:


        - The owner of the API token must have Super Admin permissions


        - The folder must already be privated


        - You cannot add a user who already has permission to a private folder. (To edit a permission you must delete the user first and then add them back with the correct permission)


        Validation notes: provide at least one of users, teams; provide at least one of uuid, location.


        Provide uuid or location. teams is not supported by the current service. Requires Super Admin and a private folder.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                uuid:
                  type: string
                location:
                  type: string
                users:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                      permission:
                        type: string
                        enum:
                        - Viewer
                        - Editor
                    required:
                    - email
                    additionalProperties: true
              required:
              - users
              additionalProperties: true
            example:
              location: My Labspace:Protocols Folder
              users:
              - email: scientist@example.com
                permission: Editor
        required: true
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                additionalProperties: true
              example:
                success: true
        '401':
          description: Invalid Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Invalid Authentication Token
        '403':
          description: Missing Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Missing Authentication Token
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Validation error
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Operation failed
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Bad request
      parameters: []
      operationId: postLabspaceFolderAddPermissions
      x-operation-id-source: derived
  /labspace/folder/lock:
    post:
      tags:
      - Scispot API - ELN API - Permissions (Super Admin Only)
      summary: Lock Folder
      description: 'This endpoint allows you to add permissions to a private folder in the labspace.


        #### **Notes**:


        - The owner of the API token must have Super Admin permissions


        - The folder must already be privated


        - You cannot add a user who already has permission to a private folder. (To edit a permission you must delete the user first and then add them back with the correct permission)


        Validation notes: provide at least one of uuid, location.


        Provide uuid or location. Requires Super Admin API token.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                uuid:
                  type: string
                location:
                  type: string
              additionalProperties: true
            example:
              location: My Labspace:Protocols Folder
        required: true
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                additionalProperties: true
              example:
                success: true
        '401':
          description: Invalid Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Invalid Authentication Token
        '403':
          description: Missing Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Missing Authentication Token
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Validation error
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Operation failed
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Bad request
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Not found
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Conflict
      parameters: []
      operationId: postLabspaceFolderLock
      x-operation-id-source: derived
  /labspace/folder/unlock:
    post:
      tags:
      - Scispot API - ELN API - Permissions (Super Admin Only)
      summary: Unlock Folder
      description: 'This endpoint allows you to add permissions to a private folder in the labspace.


        #### **Notes**:


        - The owner of the API token must have Super Admin permissions


        - The folder must already be privated


        - You cannot add a user who already has permission to a private folder. (To edit a permission you must delete the user first and then add them back with the correct permission)


        Validation notes: provide at least one of uuid, location.


        Provide uuid or location. Requires Super Admin API token.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                uuid:
                  type: string
                location:
                  type: string
              additionalProperties: true
            example:
              location: My Labspace:Protocols Folder
        required: true
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                additionalProperties: true
              example:
                success: true
        '401':
          description: Invalid Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Invalid Authentication Token
        '403':
          description: Missing Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Missing Authentication Token
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Validation error
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Operation failed
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Bad request
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Not found
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Conflict
      parameters: []
      operationId: postLabspaceFolderUnlock
      x-operation-id-source: derived
  /labspace/folder/remove-permissions:
    post:
      tags:
      - Scispot API - ELN API - Permissions (Super Admin Only)
      summary: Remove Permissions
      description: 'This endpoint allows you to add permissions to a private folder in the labspace.


        #### **Notes**:


        - The owner of the API token must have Super Admin permissions


        - The folder must already be privated


        - You cannot remove a user who does not have any permission to a private folder


        Validation notes: provide at least one of users, teams; provide at least one of uuid, location.


        Provide uuid or location. teams is not supported by the current service. Requires Super Admin and a private folder.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                uuid:
                  type: string
                location:
                  type: string
                users:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                    required:
                    - email
                    additionalProperties: true
              required:
              - users
              additionalProperties: true
            example:
              location: My Labspace:Protocols Folder
              users:
              - email: scientist@example.com
        required: true
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                additionalProperties: true
              example:
                success: true
        '401':
          description: Invalid Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Invalid Authentication Token
        '403':
          description: Missing Authentication Token
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Missing Authentication Token
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Validation error
        '500':
          description: Operation failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Operation failed
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                additionalProperties: true
              example:
                success: false
                message: Bad request
      parameters: []
      operationId: postLabspaceFolderRemovePermissions
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: UUID
      description: Personal access token from Scispot Account → Personal Tokens