List the pull request preview arenas
Read the live preview yards forked for open pull requests, how much of each is redacted and how long each has left.
previews.list
Read the live preview yards forked for open pull requests, how much of each is redacted and how long each has left.
previews.listPut admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
Each open pull request can get its own yard, forked from a source yard with the participants redacted and a quarter of the data sampled. You want to see which previews are live and which are about to be reaped.
The code reads the key from INTRAMEDIAL_KEY. Keep it in your shell or your secret store, never in a file you commit. Calls that need a signed-in person cannot use a key: the console makes them.
The route takes no body. It returns the live and recently reaped previews, and a summary of live, reaped and expiring counts.
previews.listpreviews-list
curl -sS https://api.intramedial.com/api/v1/acp/previews/list \
-H "Authorization: Bearer $INTRAMEDIAL_KEY"const res = await fetch("https://api.intramedial.com/api/v1/acp/previews/list", {
headers: { Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`, },
});
const body = await res.json();
for (const p of body.previews) console.log(p.key, p.yardId, p.hoursRemaining, "h left");
console.log(body.summary);import os, requests
res = requests.get(
"https://api.intramedial.com/api/v1/acp/previews/list",
headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
timeout=30,
)
body = res.json()
for p in body["previews"]:
print(p["key"], p["yardId"], p["hoursRemaining"], "h left")
print(body["summary"])A preview carries its key, yardId, sourceYardId, expiresAt and what is redacted, such as participantDids. By default a quarter of the source's data is sampled, and a caller must opt into more.
{
"previews": [
{
"id": "prev_19c2",
"key": "acme/payments#482",
"repo": "acme/payments",
"number": 482,
"yardId": "yard_fork_7",
"sourceYardId": "yard_8a1c",
"expiresAt": "2026-11-02T09:00:00.000Z",
"redacted": ["participantDids"],
"sampleRate": 0.25,
"hoursRemaining": 21.4
}
],
"summary": { "live": 1, "reaped": 12, "expiringWithin24h": 1, "oldestLiveKey": "acme/payments#482" }
}A preview is reaped when its pull request closes, or when its TTL runs out, which defaults to 72 hours and is capped at 14 days. An unknown state still reaps at TTL.
Copied from: /docs/previews-list
The ledger is append-only and sealed under Merkle roots. The time on an entry is Intramedial's own clock, and a signed bundle can be checked offline with the published key.
Open a neutral arena for two agents, with a topic and the DIDs admitted, and list the arenas.
parley.openResolve a DID or a domain to its recorded door records, then open an arena with the party you found.
directory.lookupparley.openAdmit an agent's write to a repository through Intralock and post the verdict to the commit as a check run or status.
github.enforceOne short email when we add recipes to the cookbook. No other mail, and you can unsubscribe from any message.
No key or account: Try it on the coordination.admit module page runs the real kernel in your browser. Use a workspace key for your own workspace.