Ask GC AI a legal question or give it a task. Optionally ground it in uploaded files (file_ids), playbooks (playbook_ids), or skills (skill_ids). Returns a job envelope, not a final answer: while status is pending or running, keep polling ask_gcai_status with the returned job_id until status is succeeded (then result holds the answer). Pass chat_id to continue a prior conversation, sending only the new message (conversation state is kept server-side).
Optional playbook IDs to ground the completion in (up to 20). The model uses each playbook’s checks and guidance to structure its review of the attached files. Discover playbooks via GET /playbooks.Org-scoped keys can use org-visible and official playbooks.
Deprecated and no longer accepted. Use playbook_ids (an array) instead. Requests that include this field are rejected with a 400 so the playbook is never silently dropped.
Optional skill IDs to run on the first turn. Each skill’s instructions are injected as context for this completion. Discover skills via GET /skills.Only valid when starting a new chat; omit them when continuing with chat_id.
Optional chat ID to continue an existing conversation, from the chat_id of a prior completion. Omit to start a new chat.Conversation state is held server-side, so send only your new message (plus any new file_ids); do not re-send prior turns or previously returned documents/emails/diagrams. Only one turn may be in flight per chat at a time. See Multi-turn Conversations.
The chat ID. API chats stay out of chat history until you materialize them. Pass this ID to POST /chat/{id}/materialize to surface the chat. See Chat Visibility.
Documents produced during this completion: either edits of an attached file (the document editing tool) or newly generated files (the document or slide generation tools). Present only when at least one document was produced. Each entry exposes a new file_id and a signed download URL; edits also reference the preserved original via original_file_id.
The new uploaded file ID for the produced document. Use it with POST /chat/completionsfile_ids to apply further edits to this version. Download via signed_url for the finished file.
Time-limited direct download URL (no login required). Valid for 7 days from job completion. Download promptly; the URL is not re-minted, so re-fetching the job after expiry returns the same expired URL. For a link you intend to store or email, use download_url instead.
Permanent, login-gated download link for the produced document. Unlike signed_url it never expires: it points at a GC AI web page that mints a fresh download for a signed-in user with access to the file, and redirects to GC AI login otherwise. Use this for links you store or email. The produced document inherits the source document’s access, so it opens for whoever can already see the source: a document uploaded to the organization is org-visible, one in a project is visible to that project’s members, and one in personal files stays private to the uploader. Recipients still need a GC AI login.
Email drafts produced during this completion by the email drafting tool. Present only when at least one email was drafted. Each entry is a structured draft (to, subject, body, …) ready to send via your own mail client or provider.
Diagrams produced during this completion by the diagram tool. Present only when at least one diagram was produced. Each entry exposes validated Mermaid source (mermaid) you can render with any Mermaid-compatible renderer.
