Skip to main content
Open a request, the collaboration thread a commission question is settled in, with the caller as author. One request can cover several statements, each linked once and about one of its records at most: open one request per question, not per statement. Only a request’s members are notified of its messages, and most users see only the requests they belong to. List in member_ids everyone who should follow it: the user a statement belongs to, and anyone message @-mentions. A mention alone neither adds nor notifies them. Close, reassign or re-file the request later with update_request. Attachments are not supported. Every write is recorded in the audit trail as the Qobra MCP agent.

Parameters

Body

string
required
Title shown on the requests board, 255 characters at most. The detail goes in message.
string
First message, posted as the caller. Plain text: refused when it holds a < and a later > (Qobra would strip what lies between), so write no HTML and spell comparisons out in words (“more than”, not >). A link is [label](https://…), a [ or ] of the label escaped with a backslash. To @-mention a user, write @ followed by their user id. Omit for an empty thread.
object[]
The statements the request is about, one user and one month each, optionally narrowed to one record. Omit for none.
string
Id of one of requests.topics from get_company_settings. Omit for no topic. The call is refused when the company defines no topics, or when the id names none of them; the refusal lists the available topics and their ids.
string[]
Ids or emails of the people to add beside the author, as list_users returns them. Emails match case-insensitively. Each can read and answer the thread and is notified they were added. Omit for the author alone.
string
Id or email of the person expected to handle it, as list_users returns it. They become a member and are notified. Omit to leave it unassigned.

Response

Body

object
The request as it now exists, with its members and linked statements, so the id can be reused straight away.
object
The first message, when one was posted with the request; null when the request was opened with no message.