ToolOauth start
POST
https://api.todofor.ai/api/v1
/tool-oauth/start
Begin an OAuth sign-in for a CLI tool on one of the user's devices.
Request Body
toolstring · requiredTOOL_CATALOG key with a registered OAuth provider (see
toolOauthProviders.ts).deviceIdstring · requiredDevice whose CLI receives the token. Must be owned by the caller and online.
Responses
Successful response
authUrlstring · requiredProvider's authorization URL — open in a popup.
flowIdstring · requiredPoll
toolOauth.status({ flowId })for the outcome.
ToolOauth status
GET
https://api.todofor.ai/api/v1
/tool-oauth/status
Poll the outcome of a tool OAuth flow.
Responses
Successful response
oneOf
Exactly one variant must match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: status | |
| type = object · requires: status | |
| type = object · requires: status | |
| type = object · requires: status, error |
statusconst · requiredConst value: pending