decision_doc_create
tools/call
Ask your person several questions in one decision doc, which they answer in the Specify Inbox from any device. Each question has details (Markdown), 2 to 6 options with the one you recommend and why, and Something else unless allowOther is false; up to 12 questions. Background cards come before the questions. The doc, each card and each question can show images, videos and audio (up to 8 each; a diagram is an image file), comparison tables and bar charts as data, glossary terms, and https links. Upload every file first with file_upload_begin and wait until it is available; this call attaches each one to the doc, which needs link:files, and refuses the whole doc if a file is missing, still uploading, of the wrong kind, or one you cannot attach, such as a person's private file. It is addressed to the person who made your key and the people you name in readers, and waits 7 days unless you set a shorter expiresInMinutes. Returns the docId and the url to send them. Link your session with sessionId and the answers arrive as an instruction on your next session_heartbeat, as does a reader closing it unanswered; read them any time with decision_doc_status.
Scopes
request:approvals
Only docs this key asked. A doc is addressed to the person who made the key and the people named in readers; only they read and answer it. A doc that names files (visuals or posters) also needs link:files: decision_doc_create attaches them itself.
Inputs
- titlestringRequired
- summarystring
- Markdown: what this doc is about and what happens after
- visualsobject[]
- linksobject[]
- cardsobject[]
- questionsobject[]Required
- readersstring[]
- Other people who may read and answer it: each person's actorId from people_list
- sessionIdstring
- Your open session, from session_create
- expiresInMinutesnumber
- After this the doc expires and takes no more answers. Default and longest: 10080 (7 days).
- idempotencyKeystringRequired
- A retry key you choose, 8 to 200 characters; the same call sent again with it changes nothing new
Returns
The doc's docId, its url in the Specify Inbox, its status and the questions still open. A call returns content[0].text with the JSON result and structuredContent.result with the same value.
Listed when
The key has request:approvals and decision docs are open for the organization.