roblox-open-cloud · el4cteo — Claude Code skill for Roblox APIs
This Claude Code skill covers Roblox Open Cloud APIs and HttpService. It applies to external tools, bots, CI/CD, and web requests from a game.
MIT 1,200 installs ★ 131 updated 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a claude-codeWhat roblox-open-cloud does
The skill explains how to use Roblox Open Cloud APIs and make web requests from a game with HttpService. It covers API-key and OAuth 2.0 authentication, data and memory stores, cross-server messages, place publishing, and user restrictions. Webhooks and server settings are included too.
Examples show API requests and Luau code for a webhook and a player restriction. Open Cloud requests need an API key or OAuth 2.0; in-game HTTP calls require Allow HTTP Requests and a key stored in the Secrets store. Never put keys in client code. Data store budgets are shared by Open Cloud and live game servers.
What it helps with
- read and update Data Store entries through Open Cloud
- send messages to active game servers
- publish an updated place file
- make web requests from server-side game code
Example prompts for the agent
- Show me how to read a player's Data Store entry through Open Cloud.
- Write Luau server code that sends a webhook request with HttpService.
- How can I restrict a player through the Open Cloud API?
How to install roblox-open-cloud
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a claude-code2Manually: put the files in place
~/.claude/skills/roblox-open-cloud/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/roblox-open-cloud/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a codex2Manually: put the files in place
.agents/skills/roblox-open-cloud/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a cursor2Manually: put the files in place
.cursor/skills/roblox-open-cloud/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-open-cloud2Manually: put the files in place
.github/skills/roblox-open-cloud/SKILL.md1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a gemini-cli2Platform CLI
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-open-cloudManually: put the files in place
.devin/skills/roblox-open-cloud/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about roblox-open-cloud
How do I install roblox-open-cloud in Claude Code?
Run npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a claude-code. The skill file is at ~/.claude/skills/roblox-open-cloud/SKILL.md.
What does roblox-open-cloud do?
It explains how to use Roblox Open Cloud APIs and HttpService for game data, server messaging, place publishing, and other API tasks.
What does roblox-open-cloud require?
Open Cloud access uses an API key or OAuth 2.0. In-game HTTP requests require Allow HTTP Requests, and keys can be stored in the Secrets store.
Source text
SKILL.md · MIT
---
name: roblox-open-cloud
description: Open Cloud REST APIs and HttpService - API keys/OAuth, v2 patterns, data/memory stores from outside, publishMessage, place publishing, server restarts, Luau execution, bans, configs/experiments, notifications, webhooks with roblox-signature verification, rate limits, Secrets. Use when building external tools, dashboards, bots, CI/CD, admin panels, or calling web APIs from a game.
---
# Roblox Open Cloud and HttpService
Base URL: `https://apis.roblox.com`. Prefer **Open Cloud** endpoints (API key or OAuth 2.0, stable).
Legacy cookie-authenticated `*.roblox.com` web APIs can break without notice — don't build on them.
## Authentication
- **API keys** (Creator Dashboard → Open Cloud → API Keys): for your own/your group's resources and
automation. Grant the minimum scopes per universe, set an **IP allowlist** (CIDR) and **expiration**,
store as a secret (CI secret, vault), send as header `x-api-key: <key>`. Group-owned resources need a
key created under the group. Introspect a key with `POST /api-keys/v1/introspect`.
- **OAuth 2.0** (authorization code + PKCE): apps acting on behalf of other users (third-party tools).
- Never ship keys in game scripts, attributes, or client code.
## Common endpoints (v2 unless noted)
| Task | Endpoint |
| --- | --- |
| Data store entries | `GET/POST /cloud/v2/universes/{u}/data-stores/{ds}/entries`, `GET/PATCH/DELETE .../entries/{id}`, `:increment`, `:listRevisions`; scopes via `/scopes/{scope}/entries` |
| Ordered data stores | `/cloud/v2/universes/{u}/ordered-data-stores/{ods}/scopes/{scope}/entries[...]` |
| Memory stores | `/cloud/v2/universes/{u}/memory-store/sorted-maps/{map}/items`, `/queues/{q}/items[:read|:discard]`, `memory-store:flush` |
| Cross-server message into live servers | `POST /cloud/v2/universes/{u}:publishMessage` `{ "topic": "...", "message": "..." }` |
| Publish a place file | `POST /universes/v1/{u}/places/{p}/versions?versionType=Published|Saved` (body: `.rbxl`) |
| Restart servers (after an update) | `POST /cloud/v2/universes/{u}:restartServers` |
| Run Luau in a cloud server | `POST /cloud/v2/universes/{u}/places/{p}[/versions/{v}]/luau-execution-session-tasks` |
| Bans | `PATCH /cloud/v2/universes/{u}/user-restrictions/{userId}?updateMask=gameJoinRestriction` (scope `universe.user-restriction:write`), `user-restrictions:listLogs` |
| Experience notifications | `POST /cloud/v2/users/{userId}/notifications` |
| Secrets store | `/cloud/v2/universes/{u}/secrets` |
| Configs / experiments | `/creator-configs-public-api/v1/configs/universes/{u}/repositories/{repo}[/draft|/publish]`, `/experimentation/...` |
| Universe/place settings | `GET/PATCH /cloud/v2/universes/{u}`, `/cloud/v2/universes/{u}/places/{p}` |
| Assets, badges, game passes, developer products, groups, users, inventory | See the Open Cloud reference by feature. |
The authoritative list with scopes and per-endpoint rate limits is the Open Cloud reference
(`create.roblox.com/docs/cloud/reference`) and its OpenAPI description — check it before writing a client.
## Patterns
- **Pagination**: pass `maxPageSize`; follow `nextPageToken` → `pageToken` until empty.
- **Long-running operations**: some calls return an operation `path`; poll `GET /cloud/v2/{path}` until `done`.
- **Filtering**: `filter` query parameter on list endpoints that support it.
- **Rate limits**: read the `x-ratelimit-*` response headers; on `429`, back off exponentially with jitter.
Data store budgets are **shared** between Open Cloud and live game servers — throttle bulk scripts so they
don't starve the game (see `roblox-data-stores`).
- **Errors**: JSON `{ code, message }`; retry only `429` and `5xx`.
- **Legacy web APIs** (cookie or unauthenticated IP): after Oct 19, 2026, limits on the badges, datastores,
game-persistence, inventory, thumbnails, and users APIs drop sharply (often to 100 requests/min). Open Cloud
limits don't change: use Open Cloud with an API key for tools and bots, and cache responses.
- **Thumbnails**: from Oct 26, 2026 an unapproved or broken thumbnail returns `200` with a completed
operation containing an `error` object (not `503`); check `error` before reading `response.imageUri`.
```bash
# Read one player's data store entry
curl -s "https://apis.roblox.com/cloud/v2/universes/$UNIVERSE_ID/data-stores/PlayerData/entries/User_$USER_ID" \
-H "x-api-key: $ROBLOX_API_KEY"
# Announce to all live servers (the game subscribes to the "Announcements" topic)
curl -s -X POST "https://apis.roblox.com/cloud/v2/universes/$UNIVERSE_ID:publishMessage" \
-H "x-api-key: $ROBLOX_API_KEY" -H "Content-Type: application/json" \
-d '{"topic":"Announcements","message":"{\"text\":\"Update in 5 minutes\"}"}'
```
## HttpService inside games
- Enable **Allow HTTP Requests** (Experience Settings → Security). Server-side only.
- Limits: 500 requests/min per server for external URLs; Open Cloud calls have a separate
2,500/min per server budget. Always `pcall`; handle non-2xx (`response.Success`).
- Store keys in the experience **Secrets store** (Creator Hub) and read with `HttpService:GetSecret(name)`,
which returns an opaque `Secret` usable in headers (and `AddPrefix`/`AddSuffix`), not a readable string.
- Only a **subset** of Open Cloud endpoints can be called from games (assets, bans, configs, data/memory
stores, messaging, notifications, and more — check the in-game HTTP docs list). Calls to other
`roblox.com` domains are blocked.
```luau
--!strict
local HttpService = game:GetService("HttpService")
local function postToWebhook(url: string, payload: { [string]: any }): boolean
local ok, response = pcall(function()
return HttpService:RequestAsync({
Url = url,
Method = "POST",
Headers = { ["Content-Type"] = "application/json" },
Body = HttpService:JSONEncode(payload),
})
end)
if not ok then
warn("HTTP request failed to send:", response)
return false
end
if not response.Success then
warn(`HTTP {response.StatusCode}: {response.StatusMessage}`)
end
return response.Success
end
local function banViaOpenCloud(universeId: number, userId: number, reason: string): boolean
local ok, response = pcall(function()
return HttpService:RequestAsync({
Url = `https://apis.roblox.com/cloud/v2/universes/{universeId}/user-restrictions/{userId}?updateMask=gameJoinRestriction`,
Method = "PATCH",
Headers = {
["Content-Type"] = "application/json",
["x-api-key"] = HttpService:GetSecret("OpenCloudKey"),
},
Body = HttpService:JSONEncode({
gameJoinRestriction = { active = true, displayReason = reason, privateReason = reason },
}),
})
end)
return ok and response.Success
end
return { postToWebhook = postToWebhook, banViaOpenCloud = banViaOpenCloud }
```
In-game, prefer native APIs (`Players:BanAsync`, `DataStoreService`) over calling Open Cloud for the same thing.
Never log or send player chat/PII to third parties without a legitimate purpose and compliance review.
## Webhooks (Roblox → your server)
Configure in Creator Hub → Account Settings → Webhooks (max 5; for group games only the group owner).
Triggers: subscription purchased/renewed/cancelled/refunded/resubscribed, right-to-erasure requests,
commerce order paid/refunded, **transaction refunded** (Robux refunds/chargebacks of developer products,
passes, private servers, Paid Access — revoke developer product benefits yourself).
Verification details and a Node/Python verifier: [references/webhooks.md](references/webhooks.md).
## Related skills
`roblox-data-stores` (budgets, schema), `roblox-tooling` (CI publishing), `roblox-testing` (Luau
execution tests), `roblox-analytics-liveops` (configs, experiments), `roblox-security` (bans, secrets).
© EL4CTEO · MIT · EL4CTEO/roblox-skills
Similar skills
All skills for Backend and APIs →roblox-open-cloud by other authors comes first.