Skip to main content

​
Overview

An app is a deployed, configured AI application in your workspace (a chat assistant, a widget, an embedded copilot). The Apps API lets you talk to it programmatically and manage its conversation state — independent of the Agents API, which is for provisioning and running autonomous managed agents.

​
Base URL

https://suite.sundaypyjamas.com/api/v1/apps/{appId}

​
Authentication

Authorization: Bearer spj_ai_your_api_key_here
Widget tokens are also accepted as a fallback, scoped to a specific app — useful for calling these endpoints directly from a browser-embedded widget.

​
Resources

Chat

Send a message and get a reply, non-streaming or streamed via SSE.

Memory

Manage threads and messages — an app’s persistent conversation history.

Usage

Retrieve usage statistics for an app over a time window.