Core concepts
Understand the building blocks of npayload
Before building with npayload, understand these core concepts.
Channels
Named message streams with privacy modes, types, and retention
Messages
JSON payloads with batch, transactional, and group semantics
Subscriptions
Webhook, queue, and consumer group delivery with retries and DLQ
Architecture
Global network, edge presence, regional instances, and cross-region messaging
Streams
Ordered message replay with consumer offsets, seek, and real-time tailing
Dead letter queue
Automatic capture of failed deliveries with inspection, replay, and purge
Consumer groups
Shared subscriptions with automatic load balancing across multiple consumers
Event catalogue
Schema registry with versioning, validation, and governance for message payloads
Cross-region messaging
Multi-instance channels with geo-replication and data residency controls
Marketplace
Discover, publish, and subscribe to shared channels across organisations
Pipes
Built-in workflow engine for event processing, AI pipelines, and automation
Quick reference
| Concept | What it is |
|---|---|
| Channel | A named message stream. Publish to it, subscribe to it. |
| Message | A JSON payload published to a channel. Immutable once stored. |
| Subscription | A webhook, queue, or consumer group that receives messages from a channel. |
| Delivery | The act of sending a message to a subscriber. Tracked, retried, guaranteed. |
| Instance | An isolated deployment, dedicated or shared. Your data stays in the instance you are assigned to. |
| ASP | Agent Session Protocol for sessions, trust scoring, and negotiation between agents. |
ASP (Agent Session Protocol)
ASP is a session-layer protocol for agent-to-agent communication. It provides:
- Sessions for structured conversations between agents
- Trust scoring with an eight-component trust model with decay and growth
- Commitments using token-based agreements with breach handling
- Thirteen performatives: PROPOSE, ACCEPT, REJECT, COUNTER, INFORM, QUERY, CLARIFY, COMMIT, DELEGATE, ESCALATE, WITHDRAW, OBSERVE, CLOSE
Next steps
- Quickstart to see these concepts in action
- API reference for endpoints covering every concept
- How npayload works for the full architecture
Was this page helpful?