Get one command
Requires commands:manage.
/commands/{commandName}AuthorizationBearer token (tp_live_... or tpat_...) · headerrequiredA TipPage API key (tp_live_..., created in Dashboard → Settings → Developer) or an OAuth 2.0 access token (tpat_..., see the OAuth guide). Both carry the same scopes and are accepted on every endpoint.
commandNamestringrequiredThe command's name - its trigger without the ! prefix.
The command.
commandCustomCommandShow propertiesHide properties
namestringThe trigger, without the ! prefix.
responsestringWhat the bot answers. Template variables supported.
descriptionstring | nullOptional viewer-facing blurb shown on the tip page's command list instead of the response. null = the page shows a preview of the response with variables rendered as labels ({urlfetch:} addresses and {ai:} prompts are never shown).
listedbooleanWhether the command appears on the tip page's command list. It works in chat either way.
ai_memoryboolean{ai:} conversation memory - when true the character remembers this command's last 15 exchanges (with timestamps, kept until the command is deleted) and reacts to repeats and returning viewers. Only meaningful for responses containing {ai:}. Memory is per platform unless ai_memory_shared.
ai_memory_sharedbooleanOne memory for Twitch and Kick instead of one per platform. Only meaningful with ai_memory.
platformsstring[]Which chat(s) it runs in. Default both. A platform the streamer hasn't connected is simply skipped; the set can't be empty (use enabled: false to bench it).
permissionstringWho can trigger it. subscriber includes moderators; moderator includes the streamer.
everyonesubscribermoderatorcooldown_secondsintegercooldown_typestringglobal = one shared cooldown for the whole channel; per_user = each viewer gets their own.
globalper_useraliasesstring[]Extra triggers for the same command, also without the !.
enabledbooleancreated_atstring<date-time>updated_atstring<date-time>Missing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The key lacks the required scope (missing_scope).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
required_scopestringNo such resource.
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Rate limit exceeded - check the RateLimit-* headers.
errorstring