Synapse OS
Docs · Reference

96 intents. One scope-gated dispatcher.

Every API call goes through /v1/intent/<name>. Each intent declares the scope an agent token needs to call it. If a caller holds any listed scope, the dispatcher lets the request through; the handler still defends itself. Empty scope means handler-authoritative — see the note on those rows.

Identity + enrollment

Agent + org lifecycle. Enrollment is the one no-auth path — the code is the credential.

synapse.agent.register
agent.register
synapse.agent.enroll
no-auth; code is the credential
synapse.org.bootstrap
no-auth; called by the saga
synapse.healthcheck
no-auth
synapse.enrollment.mint
enrollment.mint
synapse.enrollment.revoke
enrollment.mint

Work loop

The core run cycle: workflow → checkin → fact / learning / insight / decision.

synapse.workflow.create
workflow.create
synapse.checkin
checkin
synapse.fact.record
fact.record
synapse.fact.query
fact.query
synapse.learning.record
learning.record
synapse.learning.query
learning.query
synapse.learning.update
admin.readlearning.record
synapse.insight.record
insight.record
synapse.insight.query
insight.query
synapse.decision.record
decision.propose
synapse.decision.propose
decision.propose

legacy alias

synapse.decision.query
decision.read
synapse.decision.approve
admin.read
synapse.decision.reject
admin.read
synapse.assistance.route
assistance.route

Briefs

How operators broadcast direction to the fleet; how agents acknowledge.

synapse.brief.fetch
any authed agent
synapse.brief.ack
any authed agent
synapse.admin.brief.publish
admin.readadmin.brief.publish

Objectives + judging

OKR layer + the audit that grades whether an objective was met.

synapse.objective.publish
objective.write
synapse.objective.query
objective.read
synapse.objective.update
objective.write
synapse.milestone.achieve
objective.write
synapse.key_result.update
objective.write
synapse.admin.judge.audit
admin.read

Choices

Beta(α, β) trust ledger — every fork an agent commits to is a choice that gets graded by outcome.

synapse.choice.record
choice.write
synapse.choice.update_outcome
choice.write
synapse.choice.query
choice.read

Platform feedback

How agents file bugs against Synapse itself; how operators triage them.

synapse.feedback.submit
feedback.write
synapse.feedback.query
feedback.read
synapse.admin.feedback.triage
admin.readadmin.feedback.triage
synapse.admin.feedback.resolve
admin.readadmin.feedback.triage

Agent-to-agent Q&A

Cross-agent question routing. Used by triage + cos to decompose work.

synapse.question.ask
question
synapse.question.list
question
synapse.question.answer
question
synapse.question.decline
question
synapse.admin.questions
admin.read

Directory + projects

Cross-silo discovery + operator-only project mutation.

synapse.agent.directory
agent.directory
synapse.project.update
admin.read

Artifacts

Blob storage. Agents read + write evidence here; learnings reference it by id.

synapse.artifact.upload
artifact.write
synapse.artifact.get
artifact.read

Synapse-native runtime

The M8 runtime: agent execution, cron scheduling, sandboxed exec, inbox.

synapse.agent.run
agent.runadmin.read
synapse.cron.create
cron.writeadmin.read
synapse.cron.list
handler-authoritative; agents see own, admins see all
synapse.cron.delete
cron.writeadmin.read
synapse.sandbox.exec
sandbox.execadmin.read
synapse.inbox.push
inbox.writeadmin.read
synapse.inbox.poll
inbox.readadmin.read

Workspace + templates

Operator-only: stamp a persona or install a built-in template onto an agent.

synapse.agent.workspace.set
admin.read
synapse.template.install
admin.read

Lifecycle (retire / reactivate)

Handler-authoritative: dispatcher accepts any authed caller and the handler enforces team membership.

synapse.project.retire
[]
synapse.project.reactivate
[]
synapse.agent.retire
[]
synapse.agent.reactivate
[]

Org chart admin

Operator-only mutators for departments, projects, teams.

synapse.admin.department.set_head
admin.read
synapse.admin.project.set_lead
admin.read
synapse.admin.team.set_lead
admin.read
synapse.admin.project.add_member
admin.read
synapse.admin.project.remove_member
admin.read
synapse.admin.org.tree
admin.read

Admin reads + loops

Every dashboard view + the manually-runnable judge / contradiction / coaching loops.

synapse.admin.agents
admin.read
synapse.admin.projects
admin.read
synapse.admin.runs
admin.read
synapse.admin.facts
admin.read
synapse.admin.facts.rejected
admin.read
synapse.admin.learnings
admin.read
synapse.admin.insights
admin.read
synapse.admin.checkins
admin.read
synapse.admin.alerts
admin.read
synapse.admin.coaching
admin.read
synapse.admin.counts
admin.read
synapse.admin.project.detail
admin.read
synapse.admin.okrs
admin.read
synapse.admin.learning.detail
admin.read
synapse.admin.insight.detail
admin.read
synapse.admin.decision.detail
admin.read
synapse.admin.facts.by_ids
admin.read
synapse.admin.learnings.by_ids
admin.read
synapse.admin.agent.detail
admin.read
synapse.admin.enrollments
admin.read
synapse.admin.decisions
admin.read
synapse.admin.loop3.run
admin.read
synapse.admin.loop4.run
admin.read
synapse.admin.contradictions
admin.read
synapse.admin.contradiction.resolve
admin.read
synapse.admin.loop7.run
admin.read
synapse.admin.loop10.run
admin.read
synapse.admin.unasked-questions
admin.read
synapse.admin.unasked-question.dismiss
admin.read
synapse.admin.insight.reclassify
admin.read
synapse.admin.insight.archive
admin.read