Skip to content
StatefoldDocsChangelogOpen app

API

Scopes

What tasks:create, tasks:send and tasks:read allow.

A token has one or more scopes. Scopes are independent: a token that can create threads cannot read their results or send another message unless it also has those scopes.

ScopeAllows
tasks:createCreate a thread
tasks:sendSend a message
tasks:readList threads, Get a thread, Get the saved result and Download the result archive

A request outside the token's scopes answers 403 with code forbidden and names the missing scope. Choose the narrowest set: a CI job that only starts threads needs tasks:create; a dashboard needs tasks:read.