Skip to content

search

Search across all CloudSprite resources (projects, datasets, notebooks).

Signature

search(query: str, **kwargs: object) -> list[object]

Parameters

Name Type Required Default
query str yes -
**kwargs object no -

HTTP parameters

Name In Type Required Default
limit query integer no 5
q query string yes -

Fields

Field
query
**kwargs

Return shape

HTTP 200 — OK

Schema: SearchResponse

Field Type Required
datasets array<SearchResultItem> yes
instruments array<SearchResultItem> yes
notebooks array<SearchResultItem> yes
parameters array<SearchResultItem> yes
projects array<SearchResultItem> yes
tags array<SearchResultItem> yes

Permission

Required permission: Any signed-in user

HTTP

GET /api/search/ (search)

Usage

results = cs.search("cable 25C")
for r in results:
    print(r.type, r.name)