Presentation Agent

Create and drive AI presentation agent sessions.

Create and start an AI agent session

post

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).

Authorizations

AuthorizationstringRequired

API key issued for your Plus organization, sent as a bearer token.

Body

promptstringRequired

The initial instruction for the agent.

pptxFileIdstringOptional

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

languagestringOptional

Target language. Defaults to auto.

Default: auto

callbackUrlstring · uriOptional

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

modelstring · enumOptional

The model to use.

Possible values:

Responses

201

Session created and started.

application/json

sessionIdstringRequired

pollingUrlstring · uriRequired

URL to poll for session state.

400

The request was malformed or missing required fields.

application/json

401

Missing or invalid API key.

application/json

402

Insufficient AI agent credits for the billing cycle.

application/json

500

An unexpected error occurred.

application/json

post/r/v0/agent/sessions

POST /r/v0/agent/sessions HTTP/1.1
Host: api.plusdocs.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "prompt": "text",
  "pptxFileId": "text",
  "language": "auto",
  "attachments": [
    {
      "fileId": "text"
    }
  ],
  "callbackUrl": "https://example.com",
  "model": "claude-opus-4-8"
}

{
  "sessionId": "text",
  "pollingUrl": "https://example.com"
}

Get the current state of an agent session

get

Returns the current status of an agent session. Poll this endpoint until status reaches a terminal value. When the agent finishes, pdfUrl, pptxUrl, and thumbnailUrl are populated with download URLs.

Authorizations

AuthorizationstringRequired

API key issued for your Plus organization, sent as a bearer token.

Path parameters

sessionIdstringRequired

Responses

200

The current session state.

application/json

sessionIdstringRequired

statusstring · enumRequiredPossible values:

pdfUrlstring · nullableOptional

Download URL for the generated PDF (populated when finished).

pptxUrlstring · nullableOptional

Download URL for the generated PPTX (populated when finished).

thumbnailUrlstring · nullableOptional

Download URL for a thumbnail image (populated when finished).

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

400

The request was malformed or missing required fields.

application/json

401

Missing or invalid API key.

application/json

404

Session not found.

application/json

get/r/v0/agent/sessions/{sessionId}

GET /r/v0/agent/sessions/{sessionId} HTTP/1.1
Host: api.plusdocs.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "sessionId": "text",
  "status": "READY",
  "pdfUrl": null,
  "pptxUrl": null,
  "thumbnailUrl": null,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}