CreateDiscussionInput

Customer-scoped attachments. Used by EMAIL / SLACK / CURSOR discussions. Sidekick AGENT_SESSION discussions use workspaceFileIds instead.

Workspace-scoped files. Used by Sidekick AGENT_SESSION discussions, which are not customer-scoped. Other discussion types ignore this field.

The entity ID where this discussion was started (e.g. a company or customer ID). Used to provide context to agent sessions started outside of a thread.

The entity type for sourceEntityId. Required when sourceEntityId is provided.

Which agent to ask on an AGENT_SESSION discussion. Omit for Plain's Sidekick. Must reference a machine user marked as a custom agent; Plain starts nothing for one, so the agent is expected to reply over the API.

The page path where this discussion was started (e.g. '/insights', '/settings'). Used to provide context when the user is on a page without a specific entity. Also carries the reporting page link for a CHART source.

The page-fragment anchor (no '#') identifying the element the discussion was started from, e.g. a specific reporting chart. Kept separate from sourcePageLink, which is matched exactly as a page-scope key and must stay hash-free. Only meaningful for PAGE and CHART sources.

The kind of source. Pass CHART (with sourcePageLink) to start a discussion from a reporting chart. THREAD/PAGE/ENTITY are otherwise inferred from threadId / sourcePageLink / sourceEntityId.

Free-form context from the UI (e.g. active filters on the current page) injected into the agent's prompt, so it knows what data the user is currently looking at.

Ignored when agentMachineUserId is set. Plain builds the prompt only for its own Sidekick; an agent the workspace built receives the message over the discussion webhook, which does not carry this field. Passing it is accepted but has no effect.