AkiiAkii
  • Platform
    Commerce GraphKeep offers, rules, hours, and sources in one trusted place.Agent GatewayGive AI and partner systems a clean, approved way to read each client.Action RegistryMap each offer to the right booking, quote, call, WhatsApp, or checkout path.Answer QACatch wrong facts and broken customer paths before they cost demand.Protocol CompatibilityPrepare client data for ACP, UCP, MCP, A2A, AP2, and agent UI flows.ACP ReadinessCheck seller details, prices, rules, offers, and next steps.
  • Resources
    Solutions overviewStart with common agency client needs, then open the main platform pages.DocsRead practical guides for Commerce Graph, Agent Gateway, and readiness.BlogPlain notes on AI commerce, business data, and daily work.FAQShort answers for buyers, teams, agencies, and partners.ResearchNotes on agent commerce, action paths, checks, and sources.
  • Company
    AboutLearn what Akii is building and where the company fits.ContactReach Akii for sales, support, partnership, or account questions.
  • Pricing
LoginContactSign up
AkiiAkii

Platform

Commerce GraphKeep offers, rules, hours, and sources in one trusted place.Agent GatewayGive AI and partner systems a clean, approved way to read each client.Action RegistryMap each offer to the right booking, quote, call, WhatsApp, or checkout path.Answer QACatch wrong facts and broken customer paths before they cost demand.Protocol CompatibilityPrepare client data for ACP, UCP, MCP, A2A, AP2, and agent UI flows.ACP ReadinessCheck seller details, prices, rules, offers, and next steps.

Resources

Solutions overviewStart with common agency client needs, then open the main platform pages.DocsRead practical guides for Commerce Graph, Agent Gateway, and readiness.BlogPlain notes on AI commerce, business data, and daily work.FAQShort answers for buyers, teams, agencies, and partners.ResearchNotes on agent commerce, action paths, checks, and sources.

Company

AboutLearn what Akii is building and where the company fits.ContactReach Akii for sales, support, partnership, or account questions.
Sign up
PricingContact
Login
Home/Docs/Schemas
Reference

Updated 2026-07-07

Schemas

Schema references for Commerce Graph, Action Path, Protocol Profile, Public Output, and Export shapes where implemented.

Start Here

  • Akii Documentation
  • Getting started with Akii
  • What is Akii?
  • Core concepts
  • Glossary

Core Platform

  • Commerce Graph
  • Agent Gateway
  • Action Registry
  • Protocol Compatibility
  • Answer QA
  • Monitoring
  • Fix Queue
  • Sources

Protocol Compatibility

  • AI commerce protocols
  • Agentic Commerce Protocol readiness
  • Universal Commerce Protocol readiness
  • Model Context Protocol support
  • Agent2Agent support
  • Agent Payments Protocol readiness
  • Agent UI payloads
  • Protocol comparison
  • Safe protocol claims and certifications

Publishing and Partner Access

  • Publishing overview
  • Access boundaries
  • Commerce Graph publishing
  • Approved data publishing
  • Read-only AI access
  • Agent discovery profile
  • UCP-style client profile
  • Exports
  • Availability and access messages
  • Traffic limits
  • Versioning

Implementation Guides

  • Create your first Commerce Graph
  • Publish your Agent Gateway
  • Map customer action paths
  • Run Answer QA
  • Configure protocol compatibility
  • Set up MCP access
  • Create an A2A Agent Card
  • Prepare for ACP-style flows
  • Prepare for UCP-style flows
  • Monitor drift
  • Manage fixes

Agencies and Partners

  • Agency guide
  • Client onboarding for agencies
  • Manage multiple client brands
  • Client reports
  • Fix Queue workflows for agencies
  • Reselling and packaging Akii
  • Partner guide
  • Batch client onboarding
  • Protocol exports
  • Partner readiness reports

Use Cases

  • Use cases
  • Ecommerce and complex catalogs
  • Service businesses
  • Local businesses
  • B2B companies
  • Hospitality
  • Wellness and clinics
  • Venues and events
  • Tours and experiences
  • Marketplaces
  • Multi-location brands

Security and Compliance

  • Security overview
  • Data handling
  • Public vs private data
  • MCP security
  • Payment boundaries
  • Roles and access
  • Audit logs
  • Certification and platform-claim rules

Reference

  • Reference
  • Entities
  • Commerce Graph schema
  • Action types
  • Protocol statuses
  • Issues
  • Readiness statuses
  • Plan limits
  • FAQ
  • Changelog
  • Schemas

Overview

Schema references for Commerce Graph, Action Path, Protocol Profile, Public Output, and Export shapes where implemented.

  • Commerce Graph schema.
  • Action Path schema.
  • Protocol profile schema.
  • Public output schema.

Commerce Graph schema

The Commerce Graph schema describes the approved business profile: identity, locations, offers, policies, sources, actions, graph version, and public/private field boundaries.

Action Path schema

The Action Path schema describes the approved next step for a customer intent: buy, book, inquire, request quote, call, WhatsApp, pay deposit, submit form, checkout, or fallback.

Protocol Profile schema

The Protocol Profile schema describes readiness and export status for ACP, UCP, MCP, A2A, AP2, AG-UI, A2UI, and JSON-LD surfaces without turning readiness into certification.

Public Output schema

Public output includes client id, graph version, status, data, links, and error envelopes. It exposes approved public data only unless partner access is explicitly configured and scoped.

Export schema

Partner and protocol exports identify what was included, what was excluded, when the export was generated, and which client brand and output type it belongs to.

Commerce Graph JSON schema excerpt

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://akii.com/schemas/commerce-graph.schema.json",
  "type": "object",
  "required": ["merchant_id", "graph_version", "business", "sources", "offers", "actions"],
  "properties": {
    "merchant_id": { "type": "string" },
    "graph_version": { "type": "string" },
    "status": { "enum": ["draft", "approved", "published"] },
    "business": {
      "type": "object",
      "required": ["name", "website"],
      "properties": {
        "name": { "type": "string" },
        "website": { "type": "string", "format": "uri" },
        "category": { "type": "string" },
        "locations": { "type": "array", "items": { "$ref": "#/$defs/location" } }
      }
    },
    "offers": { "type": "array", "items": { "$ref": "#/$defs/offer" } },
    "actions": { "type": "array", "items": { "$ref": "#/$defs/action_path" } },
    "sources": { "type": "array", "items": { "$ref": "#/$defs/source" } }
  }
}

Action Path JSON schema excerpt

{
  "$id": "https://akii.com/schemas/action-path.schema.json",
  "type": "object",
  "required": ["id", "type", "target", "status"],
  "properties": {
    "id": { "type": "string" },
    "type": { "enum": ["buy", "book", "inquire", "request_quote", "call", "whatsapp", "pay_deposit", "submit_form", "checkout", "fallback"] },
    "target": { "type": "string" },
    "provider": { "type": "string" },
    "required_inputs": { "type": "array", "items": { "type": "string" } },
    "safe_test_status": { "enum": ["not_tested", "passing", "failing"] },
    "status": { "enum": ["draft", "approved", "published", "disabled"] }
  }
}

Protocol Profile JSON schema excerpt

{
  "$id": "https://akii.com/schemas/protocol-profile.schema.json",
  "type": "object",
  "required": ["merchant_id", "protocol", "status", "checked_at"],
  "properties": {
    "merchant_id": { "type": "string" },
    "protocol": { "enum": ["acp", "ucp", "mcp", "a2a", "ap2", "ag-ui", "a2ui", "json-ld"] },
    "status": { "enum": ["supported", "partial", "readiness", "export", "planned", "watchlist", "requires_verification"] },
    "missing_fields": { "type": "array", "items": { "type": "string" } },
    "safe_claim": { "type": "string" },
    "limitations": { "type": "array", "items": { "type": "string" } },
    "checked_at": { "type": "string", "format": "date-time" }
  }
}

Public Output JSON schema excerpt

{
  "$id": "https://akii.com/schemas/public-output.schema.json",
  "type": "object",
  "required": ["merchant_id", "graph_version", "status", "data"],
  "properties": {
    "merchant_id": { "type": "string" },
    "graph_version": { "type": "string" },
    "status": { "enum": ["published", "disabled", "not_found", "error"] },
    "data": { "type": "object" },
    "links": { "type": "object", "additionalProperties": { "type": "string" } },
    "error": { "$ref": "#/$defs/error" }
  }
}

Export JSON schema excerpt

{
  "$id": "https://akii.com/schemas/export.schema.json",
  "type": "object",
  "required": ["export_id", "merchant_id", "type", "included", "excluded"],
  "properties": {
    "export_id": { "type": "string" },
    "merchant_id": { "type": "string" },
    "type": { "enum": ["partner", "protocol", "readiness", "graph", "action"] },
    "included": { "type": "array", "items": { "type": "string" } },
    "excluded": { "type": "array", "items": { "type": "string" } },
    "generated_at": { "type": "string", "format": "date-time" }
  }
}

Related docs

Commerce Graph schema

Schema reference for structuring products, services, offers, policies, locations, availability, and customer actions for AI systems.

Commerce Graph publishing

How approved Commerce Graph data can be shared as client facts, offers, policies, actions, reviews, and structured data.

Previous
Changelog

On this page

  • Overview
  • Commerce Graph schema
  • Action Path schema
  • Protocol Profile schema
  • Public Output schema
  • Export schema
  • Commerce Graph JSON schema excerpt
  • Action Path JSON schema excerpt
  • Protocol Profile JSON schema excerpt
  • Public Output JSON schema excerpt
  • Export JSON schema excerpt
Akii

Akii helps agencies turn scattered service-business client details into data AI chatbots can read. ChatGPT, Gemini, Claude, and Perplexity can compare the client clearly and guide customers to the right next step.

Platform

  • Commerce Graph
  • Agent Gateway
  • Action Registry
  • Protocol Compatibility
  • ACP Readiness
  • Answer QA

Solutions

  • Solutions overview

Resources

  • Docs
  • Blog
  • FAQ
  • Research

Company

  • About
  • Contact
  • Privacy
  • Terms

Account

  • Sign up
  • Login
  • Pricing

© 2026 Akii Technologies, Ltd. All rights reserved.

CookiesPreferences