Build agents that know your business. On any model.

# List your knowledge blocks to find their slugs.
curl "https://api.getnoan.com/v1/blocks?in_use_only=true" \
  -H "Authorization: Bearer $NOAN_API_KEY"

# Pull the verified facts for one block.
curl "https://api.getnoan.com/v1/facts?block_slug=<your-block-slug>" \
  -H "Authorization: Bearer $NOAN_API_KEY"

# items[].content are your verified facts.
# Feed them to any model as grounding.

const API = "https://api.getnoan.com/v1";
const headers = { Authorization: "Bearer " + process.env.NOAN_API_KEY };

// The identity your API key belongs to.
const { identity } = await fetch(API + "/me", { headers }).then((r) =>
  r.json(),
);

// Pick up work: backlog tasks carrying your agent's trigger
// tag, assigned to your agent. The tag says which agent the
// task is for. Assignment is the permission to act.
const { items } = await fetch(API + "/tasks?status=backlog", {
  headers,
}).then((r) => r.json());
const mine = items.filter(
  (t) =>
    t.tags.some((tag) => tag.name === "my-agent") &&
    t.assignees.some((a) => a.id === identity.id),
);

// Claim one. The whole team sees it move on the board.
await fetch(API + "/tasks/" + mine[0].id, {
  method: "PATCH",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ status: "in-progress" }),
});