Buy a track
purchase_musicBuy permanent access to one track. Spends the user's Orbit credits and cannot be undone, so confirm with the user first. Needs an authorized session (authorize_with_code); without one it returns authorization.required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"articleId": "<articleId>"
},
"name": "purchase_music"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| articleId | Yes | Article ID of the music to purchase. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call did not succeed. | |
| success | No | ||
| displayCard | No | Markdown to show to the user. | |
| authorization | No | Present when the session must be authorized first. |