weegloo-upload-api

Implements file uploads to the Weegloo Upload REST API and creates Media or WebHosting resources from the returned Upload reference.

1|2|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/weeglooapi/weegloo-mcp-plugin --skill weegloo-upload-api-weeglooapi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weegloo-upload-api
Source: https://github.com/weeglooapi/weegloo-mcp-plugin/tree/main/plugins/weegloo/skills/weegloo-upload-api
Command: npx skills add https://github.com/weeglooapi/weegloo-mcp-plugin --skill weegloo-upload-api-weeglooapi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When building a file-upload feature in your own product (browser or server code), you need to know how to push bytes to Weegloo, receive a temporary Upload resource, and then attach it to a Media or WebHosting entity. This Skill documents that exact two-step REST flow, including authentication, plane selection, and plan-based size limits, so you avoid wiring your app to the wrong endpoint or the wrong MCP tool. ## Core Features & Use Cases - Two-step upload pattern: POST bytes to upload.weegloo.com (multipart or binary), receive an Upload resource with sys.id and sys.expiresAt, then create a Media (CMA or ACMA) or WebHosting referencing that Upload before it expires. - Identity-based plane selection: Weegloo User tokens create Media via the CMA plane; Service User tokens must use the ACMA plane, with the Upload API as the single shared surface. - Plan size-limit handling: Enforced server-side mid-stream with HTTP 429 and error code WGL429004, requiring client-side pre-validation and tailored user messaging (no plan-upgrade wording for Service Users). - Use Case: You are adding an avatar-upload feature to your SaaS app. Your frontend POSTs the image to the multipart endpoint, then your backend creates an ACMA Media referencing the returned Upload.sys.id, waiting for Published status before linking it to Content. ## Quick Start Use the weegloo-upload-api skill to implement a file upload in my app that posts an image to the Weegloo Upload API and creates a Media from the returned upload id.

Frequently Asked Questions about weegloo-upload-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload a file and attach it as Media in Weegloo?

Upload the bytes to the Upload API (POST /v1/spaces/{spaceId}/uploads or /uploads/multipart), then create a Media via CMA or ACMA referencing the returned Upload.sys.id in fields.file.{locale}.upload. Create the Media before the Upload's sys.expiresAt.

What is the difference between the Weegloo Upload API and the weegloo-upload MCP server?

The Upload API is a REST endpoint called by your product's own code to implement a runtime upload feature. The weegloo-upload MCP server is for the agent or LLM uploading local files during development, and should never be wired into your app's runtime.

Should I use CMA or ACMA to create Media after uploading?

Choose by identity: Weegloo User tokens (admin, PAT, console login) create Media through the CMA plane, while Service User tokens must use the ACMA plane. The Upload API accepts both Bearer types; only the Media-create plane differs.

Why does my Weegloo file upload fail with HTTP 429?

A 429 with error code WGL429004 means the file exceeds the Space plan's maximum upload size, enforced mid-stream server-side. Pre-validate file.size client-side, show a file-too-large message steering to a smaller file, and do not blindly retry.

When can I reference an uploaded Media from Content?

Only after the Media's sys.status reaches Published and the locale file state is no longer PENDING, PROCESSING, or FAILED. The platform processes the file after creation and auto-publishes on success.