API reference

Loop skills

Loops: a LoopDefinition (the loop builder's flow), its revisions (who changed it: a person, the Agent in a chat, an MCP agent or an API key) and the Agent chat that holds its history, shared with everyone who can see the loop.

GET/loop-skills

List skills for loops

The skills a loop's Agent and Write reply steps can use: the skills shared with the workspace, then Pluto's own that work in loops, each at its current version. Pin one by name in a step's skills (up to 5); a step also loads any of them on its own when the item matches the skill's description. A person's own skills aren't listed: a loop runs for the whole workspace. Guests don't see loops (403).

Permission: read

Parameters

NameTypeRequiredDescription
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

itemsarray of objectsRequired
The workspace's shared skills by name, then Pluto's.
items[].descriptionstringRequired
What it's for and when a step uses it.
items[].namestringRequired
The name a step pins it by.
items[].sourcestringRequired
Shared with the workspace, or Pluto's.One of workspace, pluto
items[].versionstringRequired
Its current version (empty for a Pluto skill without one).

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/loop-skills" \
  -H "Authorization: Bearer $PLUTO_KEY"