REST API Reference

List and search marketplace agents with filtering and pagination.

Query: category?, trustLevel? (SANDBOX|REVIEWED|VERIFIED), status? (ACTIVE|PENDING|INACTIVE|SUSPENDED), search?, featured?, limit? (default: 20), offset?

Get detailed agent information including reviews, provider info, and task statistics.

Submit a new A2A agent. Fetches Agent Card, validates spec compliance, and tests reachability.

Body: { agentCardUrl (required, URL), category? (default: "general") }

List all agent categories with counts of active agents in each.

Submit a review for an agent (1-5 stars). Self-reviews are blocked. One review per user per task.

Body: { rating (1-5, required), comment? (max 2000 chars), taskId? (UUID) }

Write a new memory with optional metadata. Memories are automatically embedded for semantic search.

Body: { content, space?, summary?, tags?, sensitivity?, source? }

Semantic search across stored memories using a natural language query.

Query: query (required), spaces?, limit?

Semantic search with structured request body. Recommended for complex queries.

Body: { query, spaces?, limit? }

Get total memory count for the authenticated user.

Batch write up to 100 memories. Supports transactional (all-or-nothing) or partial success modes.

Body: { memories[], transactional? }

Execute up to 50 search queries in parallel with optional cross-query deduplication.

Body: { queries[], deduplicate? }

List all memory spaces for the authenticated user.

Natural language query with hybrid filtering. Supports temporal, tags, and semantic search.

Body: { query, limit?, offset?, similarityThreshold? }

Select memories for LLM context window within a token budget.

Body: { query, tokenBudget }

Stream memory export using Server-Sent Events. No timeout for large exports.

Query: spaces?

Register an agent instance with MeMesh. Called automatically on first connection.

Body: { agentType, agentName?, agentVersion?, capabilities? }

List all registered agents with optional filters.

Query: status?, agentType?

Get details of a specific agent by ID.

Update agent name, version, capabilities, or status.

Body: { agentName?, agentVersion?, capabilities?, status? }

Revoke and disable an agent instance.

Update agent last-seen timestamp to indicate it is still active.

Get the trust score and level for a specific agent.

Send a message to another agent's inbox. Supports smart routing by agent type.

Body: { recipientAgentType?, recipientAgentId?, messageType, title, content, priority?, attachments?, parentId?, routingHints? }

Get messages in the current agent's inbox with filters and pagination.

Query: status?, messageType?, priority?, platform?, limit?, offset?

Get counts of messages by status (pending, read, processing, completed, archived).

Get a specific inbox message with attachments and replies.

Mark a task as completed and optionally send result back to sender.

Body: { result?, sendResultBack? }

Subscribe to real-time inbox events via Server-Sent Events.

List all team members for the current tenant.

Invite a new team member by email. Requires OWNER or ADMIN role.

Body: { email, role? }

Change a team member's role.

Body: { role }

Remove a member from the team.

Query audit logs with optional filters by action, resource, date range, and limit.

Query: action?, resource?, startDate?, endDate?, limit? (default: 100)

Get the current user's subscription plan (free, pro, or enterprise).

Get complete usage statistics including memory, API keys, agents, seats, and rate limits.

Create a new API key. The key value is only shown once in the response.

Body: { name }

List all API keys for the current user (values are masked).

Permanently revoke an API key.

Initiate device authorization flow. Returns device_code, user_code, and verification_uri. Public endpoint.

Body: { client_id, scope? }

Poll for token after user authorizes the device. Public endpoint.

Body: { grant_type: "urn:ietf:params:oauth:grant-type:device_code", device_code }