Skip to content

docs(learning): add Learnings API page for AgentOS /learnings endpoints#683

Merged
ysolanky merged 5 commits into
mainfrom
ysolanky/quebec-v1
Jun 15, 2026
Merged

docs(learning): add Learnings API page for AgentOS /learnings endpoints#683
ysolanky merged 5 commits into
mainfrom
ysolanky/quebec-v1

Conversation

@ysolanky

Copy link
Copy Markdown
Member

Summary

Documents the /learnings REST CRUD endpoints added to AgentOS in agno-agi/agno#7826.

New page learning/managing-learnings.mdx ("Learnings API"), added to the Learning nav group in docs.json. Code-first, tables for decisions, per the docs style guide.

Covers:

  • Server setup (learning-enabled agent on AgentOS) — endpoints come up automatically
  • Endpoints table (all 7 verbs)
  • List & filter params (pagination, sorting, filters)
  • Create + deterministic id derivation (reconciliation with the agent's store, 422/409)
  • Update / delete, including bulk user delete
  • Auth & isolation matrix (opt-in user_isolation, 403/404 behavior, shared null-owner records admin-only to mutate) and RBAC scopes
  • db_id / table targeting

Validation

  • docs.json is valid JSON
  • mint broken-links: no new broken links (only pre-existing ones in TBD/); all four internal links on the new page resolve

🤖 Generated with Claude Code

ysolanky and others added 2 commits June 12, 2026 11:53
Document the /learnings REST CRUD endpoints added in agno-agi/agno#7826:
endpoints table, list/filter params, deterministic id derivation on create,
update/delete, user isolation + RBAC, and db/table targeting.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
Add the seven /learnings operations and their schemas (LearningResponse,
LearningCreate, LearningUpdate, LearningUserStats, paginated wrappers,
Forbidden/Conflict) to reference-api/openapi.yaml, stub MDX pages, and a
"Learnings" group in the API reference nav. Link the prose page to the reference.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@mintlify

mintlify Bot commented Jun 12, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
phidatainc 🟢 Ready View Preview Jun 12, 2026, 4:08 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@mintlify

mintlify Bot commented Jun 12, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
agno 🟢 Ready View Preview Jun 12, 2026, 4:18 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

These are AgentOS REST endpoints, so the page belongs under AgentOS
(alongside Knowledge management), not the SDK Learning concepts group.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
…tyle

Restructure to match agent-os/knowledge/manage-knowledge: lead with intro and
use cases, add Prerequisites, a framed Example, Best Practices, and a
Troubleshooting accordion group. Retitle to "Manage Learnings".

Co-Authored-By: Claude Opus 4.8 <[email protected]>
Cut Best Practices and Troubleshooting, which restated the status-code and
identity-field rules already covered in the create/auth sections. Fold the
db_id/table note into Endpoints and tighten the prose.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@ysolanky ysolanky merged commit 414f439 into main Jun 15, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant