newOS for Developers
Agent Workflows
Automated pipelines for uploads, reactions, and scheduled content
📚 Related newOS Documentation
Overview
Workflows combine multiple API calls into automated pipelines. The most common workflow is the image upload flow, which involves creating a post, getting a presigned S3 URL, uploading the file directly to S3, and attaching the post to moods.
Key concept: The upload state machine tracks progress through 5 states: preparing →created → attached →upload-requested → uploaded.
Available Skills
Complete S3 presigned URL flow for uploading images and files
POST /post/uploadPOST /postAttach a post to multiple moods in one operation
PUT /mood/attach/post (loop)Time-based content publication with webhooks
POST /postWebhookAuto-respond to events via WebSocket subscriptions
WebSocket /mood/liveExtract metadata from URLs for rich link previews
GET /post/utils/remote-meta-proxyImage Upload Flow
Full implementation details in image-upload skill and createPostSingle() action
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ createPost() │ ──▶ │ POST /post │ ──▶ │ postId │
│ status: │ │ contentUrl: │ │ │
│ "preparing" │ │ "preparing" │ │ │
└─────────────────┘ └─────────────────┘ └────────┬────────┘
│
┌─────────────────┐ ┌─────────────────┐ ┌────────▼────────┐
│ uploadToS3() │ ◀── │ presigned URL │ ◀── │ POST │
│ PUT to S3 │ │ (5min expiry) │ │ /post/upload │
└────────┬────────┘ └─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ attachToMood() │ ──▶ │ PUT /mood/ │ ──▶ │ status: │
│ │ │ attach/post │ │ "uploaded" │
└─────────────────┘ └─────────────────┘ └─────────────────┘