Sign in
latestOpenAPI 3.1.02026-08-10386.5 KB

edf00deb3363

Presentation Agent

Create and start an AI agent session

Creates a new agent session, posts the initial prompt, and starts the agent. Returns a polling URL to track progress.

Optionally seeds the session with an existing PowerPoint file (pptxFileId) and/or file attachments (attachments[].fileId). File IDs must reference files owned by the caller's organization (e.g. uploaded via PUT /r/v0/files/upload).

post/r/v0/agent/sessions

Request body

promptstring required

The initial instruction for the agent.

pptxFileIdstring

ID of an existing PowerPoint file (uploaded via the files API) to seed the session with. Must reference a .pptx/PowerPoint file.

languagestring

Target language. Defaults to auto.

callbackUrlstring uri

HTTPS URL invoked when the session changes state. Must be a public HTTPS address (no localhost/private IPs).

model'claude-opus-4-8' | 'claude-opus-4-7' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'gpt-5.4' | 'gpt-5.4-nano' | 'gpt-5.4-mini' | 'gpt-5.5'

The model to use.

Response

Session created and started.

sessionIdstring required
pollingUrlstring uri required

URL to poll for session state.