Skip to content

Conversation commands: escalate, reopen

The Conversation Verbs escalate, reopen as CLI commands, with inputs, result, refusals and an example.

Reference for Conversation, one group of Conversation commands.

Conversation.escalate

Escalate hands a Conversation and its summary to the Worker in the Role above, a Human only where one holds it. Verb page.

Text
npx startup-builder do Conversation.escalate --json '<input>' [--try | --send | --do]

Emits Conversation.escalated.

Inputs

InputTypeRequiredDescription
conversationConversationrequiredThe Conversation to hand off.
reasonstringrequiredWhy it moves up.

Returns

OutputTypeRequiredDescription
conversationConversationrequiredThe Conversation, with its new Worker.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Conversation.escalate --json '{"conversation":"conversation_0vg6SDjB6k","reason":"lowConfidence"}'

Conversation.reopen

Reopen reverses a Conversation’s resolution when a reversal signal arrives within 7 days, and grades the resolution a failure. Verb page.

Text
npx startup-builder do Conversation.reopen --json '<input>' [--try | --send | --do]

Emits Conversation.reopened.

Inputs

InputTypeRequiredDescription
conversationConversationrequiredThe resolved Conversation.
signalstringrequiredWhat reversed it: a new Message on the subject, a request for a person, a rating of 2 or lower, or a Dispute.

Returns

OutputTypeRequiredDescription
conversationConversationrequiredThe Conversation, open again.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
npx startup-builder do Conversation.reopen --json '{"conversation":"conversation_0vg6SDjB6k","signal":"askedForPerson"}'