Genialis

Genialis Basespace API

The Basespace API from Genialis — 12 operation(s) for basespace.

GitHub OpenAPI

Operations 12

GET /api/basespace/callback Api basespace callback retrieve #
GET /api/basespace/current_user Api basespace current user retrieve #
GET /api/basespace/files Api basespace files retrieve #
GET /api/basespace/logout_url Api basespace logout url retrieve #
GET /api/basespace/oauth_browse_url Api basespace oauth browse url retrieve #
GET /api/basespace/oauth_read_projects_url Api basespace oauth read projects url retrieve #
GET /api/basespace/projects Api basespace projects retrieve #
GET /api/basespace/read_projects_handle Api basespace read projects handle retrieve #
POST /api/basespace/revoke_browse_access Api basespace revoke browse access create #
GET /api/basespace/samples Api basespace samples retrieve #
POST /api/basespace/subscribe Api basespace subscribe create #
POST /api/basespace/unsubscribe Api basespace unsubscribe create #

Documentation

📖
Documentation
https://docs.genialis.com/resdk/
📖
APIReference
https://app.genialis.com/api/schema

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/openapi/genialis-basespace-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/json-schema/genialis-base-space-samples-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/json-schema/genialis-projects-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/json-schema/genialis-files-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/json-schema/genialis-observer-subscribe-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/json-schema/genialis-observer-subscription-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/genialis/refs/heads/main/json-schema/genialis-url-schema.json

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/genialis:genialis-basespace-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

genialis-basespace-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Genialis base Basespace API
  version: 0.0.0
  description: Backend of the Genialis platform.
servers:
- url: https://app.genialis.com
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Basespace
paths:
  /api/basespace/callback:
    get:
      operationId: api_basespace_callback_retrieve
      description: Get request handler.
      parameters:
      - in: query
        name: code
        schema:
          type: string
          minLength: 1
      - in: query
        name: error
        schema:
          type: string
          minLength: 1
      - in: query
        name: error_description
        schema:
          type: string
          minLength: 1
      - in: query
        name: state
        schema:
          type: string
          minLength: 1
        required: true
      tags:
      - Basespace
      security:
      - cookieAuth: []
      - {}
      responses:
        '200':
          content:
            text/html:
              schema:
                type: string
          description: ''
      summary: Api basespace callback retrieve
      x-summary-source: derived
  /api/basespace/current_user:
    get:
      operationId: api_basespace_current_user_retrieve
      description: Return currently logged in BaseSpace user.
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseSpaceUser'
          description: ''
      summary: Api basespace current user retrieve
      x-summary-source: derived
  /api/basespace/files:
    get:
      operationId: api_basespace_files_retrieve
      description: 'Return samples''s files.


        Request parameters:

        - limit (optional): the maximum number of items to return. Range: 0-1000. Default is 10.

        - offset (optional): The starting point of the collection to read. Default is 0.

        - sort_by (optional): The field to use for sorting. Can be ''id'', or ''datecreated''. Default is ''id''.

        - sort_dir (optional): The way to sort the collection. Can be ''asc'' or ''desc''. Default is ''asc''.'
      parameters:
      - in: query
        name: limit
        schema:
          type: integer
          default: 10
      - in: query
        name: offset
        schema:
          type: integer
          default: 0
      - in: query
        name: sample_id
        schema:
          type: string
          minLength: 1
        required: true
      - in: query
        name: sort_by
        schema:
          type: string
          default: id
          minLength: 1
      - in: query
        name: sort_dir
        schema:
          type: string
          default: asc
          minLength: 1
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Files'
          description: ''
      summary: Api basespace files retrieve
      x-summary-source: derived
  /api/basespace/logout_url:
    get:
      operationId: api_basespace_logout_url_retrieve
      description: Return URL to be used to logout BaseSpace user.
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Url'
          description: ''
      summary: Api basespace logout url retrieve
      x-summary-source: derived
  /api/basespace/oauth_browse_url:
    get:
      operationId: api_basespace_oauth_browse_url_retrieve
      description: Return URL to be used when requesting BaseSpace OAuth browse permissions.
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Url'
          description: ''
      summary: Api basespace oauth browse url retrieve
      x-summary-source: derived
  /api/basespace/oauth_read_projects_url:
    get:
      operationId: api_basespace_oauth_read_projects_url_retrieve
      description: 'Return URL to be used when requesting BaseSpace OAuth read projects permissions.


        Request parameters:

        - project_ids: list of project ids'
      parameters:
      - in: query
        name: project_ids
        schema:
          type: array
          items:
            type: string
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Url'
          description: ''
      summary: Api basespace oauth read projects url retrieve
      x-summary-source: derived
  /api/basespace/projects:
    get:
      operationId: api_basespace_projects_retrieve
      description: 'Return user''s projects.


        Request parameters:

        - limit (optional): the maximum number of items to return. Range: 0-1024. Default is 10.

        - offset (optional): The starting point of the collection to read. Default is 0.

        - sort_by (optional): The field to use for sotring. Can be ''id'', ''name'', or ''datecreated''. Default is ''id''.

        - sort_dir (optional): The way to sort the collection. Can be ''asc'' or ''desc''. Default is ''asc''.'
      parameters:
      - in: query
        name: limit
        schema:
          type: integer
          default: 10
      - in: query
        name: offset
        schema:
          type: integer
          default: 0
      - in: query
        name: sort_by
        schema:
          type: string
          default: id
          minLength: 1
      - in: query
        name: sort_dir
        schema:
          type: string
          default: asc
          minLength: 1
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Projects'
          description: ''
      summary: Api basespace projects retrieve
      x-summary-source: derived
  /api/basespace/read_projects_handle:
    get:
      operationId: api_basespace_read_projects_handle_retrieve
      description: 'Return access token secret handle to read BaseSpace projects.


        Request parameters:

        - project_ids: list of project ids'
      parameters:
      - in: query
        name: project_ids
        schema:
          type: array
          items:
            type: string
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Handle'
          description: ''
      summary: Api basespace read projects handle retrieve
      x-summary-source: derived
  /api/basespace/revoke_browse_access:
    post:
      operationId: api_basespace_revoke_browse_access_create
      description: Delete user's BaseSpace browse token.
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          description: No response body
      summary: Api basespace revoke browse access create
      x-summary-source: derived
  /api/basespace/samples:
    get:
      operationId: api_basespace_samples_retrieve
      description: 'Return projects''s samples.


        Request parameters:

        - limit (optional): the maximum number of items to return. Range: 0-1024. Default is 10.

        - offset (optional): The starting point of the collection to read. Default is 0.

        - sort_by (optional): The field to use for sorting. Can be ''Id'', ''name'', or ''datecreated''. Default is ''id''.

        - sort_dir (optional): The way to sort the collection. Can be ''asc'' or ''desc''. Default is ''asc''.'
      parameters:
      - in: query
        name: limit
        schema:
          type: integer
          default: 10
      - in: query
        name: offset
        schema:
          type: integer
          default: 0
      - in: query
        name: project_id
        schema:
          type: string
          minLength: 1
        required: true
      - in: query
        name: sort_by
        schema:
          type: string
          default: id
          minLength: 1
      - in: query
        name: sort_dir
        schema:
          type: string
          default: asc
          minLength: 1
      tags:
      - Basespace
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BaseSpaceSamples'
          description: ''
      summary: Api basespace samples retrieve
      x-summary-source: derived
  /api/basespace/subscribe:
    post:
      operationId: api_basespace_subscribe_create
      description: Register an Observer for a resource.
      tags:
      - Basespace
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ObserverSubscribeRequest'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/ObserverSubscribeRequest'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/ObserverSubscribeRequest'
        required: true
      security:
      - cookieAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObserverSubscription'
          description: ''
      summary: Api basespace subscribe create
      x-summary-source: derived
  /api/basespace/unsubscribe:
    post:
      operationId: api_basespace_unsubscribe_create
      description: Unregister a subscription.
      tags:
      - Basespace
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ObserverSubscription'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/ObserverSubscription'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/ObserverSubscription'
        required: true
      security:
      - cookieAuth: []
      responses:
        '200':
          description: No response body
      summary: Api basespace unsubscribe create
      x-summary-source: derived
components:
  schemas:
    Project:
      type: object
      description: BaseSpace project entity serializer.
      properties:
        id:
          type: string
        name:
          type: string
      required:
      - id
      - name
    ObserverSubscription:
      type: object
      description: Serializer for the subscribe response.
      properties:
        subscription_id:
          type: string
          format: uuid
      required:
      - subscription_id
    Projects:
      type: object
      description: BaseSpace projects serializer.
      properties:
        displayed_count:
          type: integer
          default: 0
        total_count:
          type: integer
          default: 0
        items:
          type: array
          items:
            $ref: '#/components/schemas/Project'
    ObserverSubscribeRequest:
      type: object
      description: Serializer for the subscribe endpoint.
      properties:
        ids:
          type:
          - array
          - 'null'
          items:
            type: integer
        session_id:
          type: string
      required:
      - session_id
    BaseSpaceSample:
      type: object
      description: BaseSpace sample entity serializer.
      properties:
        id:
          type: string
        name:
          type: string
        is_paired_end:
          type: boolean
      required:
      - id
      - is_paired_end
      - name
    Files:
      type: object
      description: BaseSpace files serializer.
      properties:
        displayed_count:
          type: integer
          default: 0
        total_count:
          type: integer
          default: 0
        items:
          type: array
          items:
            $ref: '#/components/schemas/File'
    Url:
      type: object
      description: BaseSpace url serializer.
      properties:
        url:
          type: string
          format: uri
      required:
      - url
    Handle:
      type: object
      description: Handle serializer.
      properties:
        handle:
          type: string
          format: uuid
    BaseSpaceSamples:
      type: object
      description: BaseSpace samples serializer.
      properties:
        displayed_count:
          type: integer
          default: 0
        total_count:
          type: integer
          default: 0
        items:
          type: array
          items:
            $ref: '#/components/schemas/BaseSpaceSample'
    File:
      type: object
      description: BaseSpace file entity serializer.
      properties:
        id:
          type: string
        name:
          type: string
      required:
      - id
      - name
    BaseSpaceUser:
      type: object
      description: BaseSpace user serializer.
      properties:
        email:
          type: string
        name:
          type: string
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: sessionid