Search the library
/librarySearches every script you can use: your own, Chartnaut's built-ins, other people's public scripts and the ones you added to your library. Call it to find a script's ref before you run it.
Scope | Heavy call | Long poll | CLI |
|---|---|---|---|
| No | No |
|
Guidance
scopepicks whose scripts come back.libraryis what your library in the app shows.all, the default, adds the community on top.
| Returns |
|---|---|
| Your own scripts, whatever their visibility |
| Your own public scripts |
| Chartnaut's built-ins |
| Other people's public scripts |
| Other people's public or unlisted scripts you added to your library |
|
|
|
|
Each item's
refgoes straight intoscripton Create a run:my-emafor yours,chartnaut/rsifor a built-in,jane/orb-breakoutfor someone else's. Add@Nto pin a version.Studies are never shared. Only your own and Chartnaut's studies come back, whatever the
scope, andadoptionsisnullon them.Source never comes back, from this call or from Get a library script, whatever the script's author allows in the app. Read your own source with Get a script.
Every word of
qmust appear, in any letter case, in the script's name, slug, description, tags, category or author. Built-ins matchchartnautas their author. Only the first eight words filter.With
q, the default order isrelevance: an exact slug or name first, then names and slugs that start withq, then ones that contain it, then the rest, each group byadoptionsand then most recently updated. Withoutqit isupdated.authornarrows to one person: a username,chartnautfor built-ins, orme. It works insidescope, soscope=community&author=meis always empty. An author with nothing you can see returns an empty page.include=interfaceadds each script's Interface at its latest version, so you can see its settings and outputs without a second call.Page with
limitandcursoras on every list. Archived and deleted scripts never appear, and neither do other people's scripts whose owner has no username, since they have no ref to run by.
Query parameters
Name | Type | Required | Default | Description |
|---|---|---|---|---|
| string | No | None | Search words, at most 200 characters |
| string | No | All kinds |
|
| string | No |
|
|
| string | No | Anyone | A username, |
| string | No |
|
|
| string | No | None |
|
| integer | No | 50 | Most 200 |
| string | No | None | From the previous page's |
Response
200 with a page whose data is an array of Library script in its list form.
Status codes
Status | Code | Meaning |
|---|---|---|
| - | A page of scripts |
|
|
|
|
| The library could not be read. Retry |
