rest-endpoints

rest-endpoints is an agent for coding agents from TAJD/projektor. It costs 20 tokens per session (1,194 once invoked), scanned A, original, MIT.

A reference for the small part of a web application's REST API that other tools can safely use. REST is a common way for programs to exchange data over web addresses; this reference lists the supported exceptions to the preferred MCP interface.

In plain words
What is it for?
Use it when building scripts, CI jobs, setup tools, or integrations that need to upload files, download files, follow redirects, or fetch published specifications over HTTP.
Why use it?
It prevents developers from relying on undocumented API routes that may change. It explains authentication and operations such as file transfers and public links.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/tajd/projektor/rest-endpoints
Clone the repo
git clone --depth 1 https://github.com/TAJD/projektor

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for rest-endpoints

README.md
[![agentmods](https://agentmods.dev/badge/agents/tajd/projektor/rest-endpoints.svg)](https://agentmods.dev/agents/tajd/projektor/rest-endpoints)
Your own site
<a href="https://agentmods.dev/agents/tajd/projektor/rest-endpoints"><img src="https://agentmods.dev/badge/agents/tajd/projektor/rest-endpoints.svg" alt="Measured on agentmods" height="20"></a>
Per session 20 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,194 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00020 $0.01194
Opus 5 $0.00010 $0.00597
Sonnet 5 $0.00004 $0.00239
Haiku 4.5 $0.00002 $0.00119

Measured 3d ago against content hash 6124f9dd215d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

rest-endpoints scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

apps/docs/src/content/docs/agents/rest-endpoints.md · 102 lines

How it starts

The opening of the file, as written. The whole thing — 102 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Projektor's REST API (/api/*) is the SPA's private, versionless contract — it can change shape without notice, and agents should use MCP instead wherever a tool exists. A handful of endpoints are the deliberate exception, documented here as a stable subset you can depend on. Two kinds qualify:

  • No MCP equivalent — things the browser can do that don't fit the JSON-RPC/tool-call shape at all (binary uploads, redirects, public unauthenticated links).
  • Fetchable without an MCP session — the shipped specs and playbooks, which have MCP tools too, but which CI jobs and setup scripts need to pull over plain HTTP before any agent is connected.

All /api/* endpoints below require the same bearer-token auth as MCP (Authorization: Bearer pk_... plus X-Workspace-Slug) unless marked public. The /auth/* endpoints are the exception — they authenticate the user, not a workspace, so they take a Cloudflare Access session (or no auth at all) instead.

File attachments

Binary upload/download doesn't fit JSON-RPC, so attachments are REST-only.

Method Path Notes
GET /api/files List attachments for an issue or wiki page (?entityType=issue|wiki_page&entityId=)
POST /api/files Upload a file (multipart)
POST /api/files/links Attach an external link instead of a binary
GET /api/files/:id Download an attachment
DELETE /api/files/:id Delete an attachment

Auth and tokens

Logging in and minting long-lived tokens are browser flows, not agent tool calls.

Method Path Notes
GET /auth/login Login redirect (browser only)
POST /auth/tokens Mint an API token for the current user
DELETE /auth/tokens/:id Revoke a token

Workspace-scoped API tokens

Method Path Notes
POST /api/workspaces/:slug/tokens Create a token scoped to a workspace
GET /api/workspaces/:slug/tokens List a workspace's tokens
DELETE /api/workspaces/:slug/tokens/:tokenId Revoke a workspace token
GET /api/workspaces/:slug/mcp-info Ready-to-use MCP connection details for a workspace

Read the full file on GitHub · 102 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 102 lines · 20 tokens per session scan A 6124f9dd215d

Subscribe to this mod's changes

rest-endpoints is an agent published in the GitHub repository TAJD/projektor (39 stars, last pushed 9d ago), licensed MIT. It adds 20 tokens to every session and 1,194 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.