aid: polycode-co-uk
name: Polycode
description: 'Polycode Limited is a UK information-technology consultancy (Companies House 10172940, Leeds, incorporated
  2016) that operates marginalia, a small public chat experiment built on a shared, provenance-tracked memory graph:
  a language model synthesises conversations into an OWL-typed graph and questions are answered by narrowing that
  graph with SPARQL. marginalia publishes a public REST API (OpenAPI 3.0.3, 50 operations at https://marginalia.polycode.co.uk/api
  — async chat with task polling, session search and history, insights, projects, usage and budget, key-authed private
  graphs; no key for reads and chat), an A2A 0.3.0 agent card at /.well-known/agent-card.json with a live JSON-RPC
  endpoint (message/send, message/stream, tasks/get) advertising chat, recall-memory and research-projects skills,
  an OpenAI-shaped zero-token completion shim, a first-party CLI and the AGPL-3.0 source on GitLab. Visitor contributions
  are PII-redacted at ingest and republished under CC-BY-SA 4.0; a volatile flag keeps a turn out of shared memory.
  The corporate apex polycode.co.uk did not resolve when profiled; the product host is the live web presence.'
url: https://raw.githubusercontent.com/api-evangelist/polycode-co-uk/refs/heads/main/apis.yml
image: https://marginalia.polycode.co.uk/favicon.svg
x-type: company
x-source: harvest:a2a-registry
x-tier: profiled
x-tier-reason: enrichment pass 2026-09-19 (local-v3; was a2a-registry harvest stub)
specificationVersion: '0.20'
created: '2026-09-19'
modified: '2026-09-19'
tags:
- Chat
- Memory
- Agents
- A2A
- Knowledge Graph
- Research
- Artificial Intelligence
- Open Source
- Consulting
- United Kingdom
tags_raw:
- Chat
- Memory
- Agents
- A2A
- Knowledge Graph
- Research
- Artificial Intelligence
- Open Source
- Consulting
- United Kingdom
- Open-Source
apis:
- aid: polycode-co-uk:marginalia-a2a-agent
  name: marginalia A2A Agent
  description: >-
    Agent2Agent (A2A) surface for marginalia: an agent card served from https://marginalia.polycode.co.uk/.well-known/agent-card.json
    (protocolVersion 0.3.0, JSONRPC, version 0.2.0) advertising three skills (open chat, recall memory,
    research projects) and a live JSON-RPC endpoint at https://marginalia.polycode.co.uk/api/a2a.
  humanURL: https://marginalia.polycode.co.uk/
  baseURL: https://marginalia.polycode.co.uk/api/a2a
  tags:
  - A2A
  - Agents
  - Chat
  - Memory
  properties:
  - type: AgentCard
    url: a2a/polycode-co-uk-a2a.yml
  - type: AgentCard
    name: A2A Agent Card (provider-hosted)
    url: https://marginalia.polycode.co.uk/.well-known/agent-card.json
  - type: Documentation
    name: 'README — Talk to it: the A2A API'
    url: >-
      https://gitlab.com/polycode-projects/marginalia/-/blob/main/README.md#talk-to-it--the-a2a-api
- aid: polycode-co-uk:polycode-co-uk-admin-api
  name: Polycode Admin API
  description: The Admin API from Polycode — 3 operation(s) for admin.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Admin
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-admin-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-budget-api
  name: Polycode Budget API
  description: The Budget API from Polycode — 1 operation(s) for budget.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Budget
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-budget-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-chat-api
  name: Polycode Chat API
  description: The Chat API from Polycode — 3 operation(s) for chat.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Chat
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-chat-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-diverts-api
  name: Polycode Diverts API
  description: The Diverts API from Polycode — 1 operation(s) for diverts.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Diverts
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-diverts-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-flag-api
  name: Polycode Flag API
  description: The Flag API from Polycode — 1 operation(s) for flag.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Flag
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-flag-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-graph-api
  name: Polycode Graph API
  description: The Graph API from Polycode — 11 operation(s) for graph.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Graph
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-graph-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-graphs-api
  name: Polycode Graphs API
  description: The Graphs API from Polycode — 8 operation(s) for graphs.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Graphs
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-graphs-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-hooks-api
  name: Polycode Hooks API
  description: The Hooks API from Polycode — 3 operation(s) for hooks.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Hooks
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-hooks-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-keys-api
  name: Polycode Keys API
  description: The Keys API from Polycode — 2 operation(s) for keys.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Keys
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-keys-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-me-api
  name: Polycode Me API
  description: The Me API from Polycode — 1 operation(s) for me.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Me
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-me-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-openapi-json-api
  name: Polycode Openapi.json API
  description: The Openapi.json API from Polycode — 1 operation(s) for openapi.json.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Openapi.json
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-openapi-json-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-project-api
  name: Polycode Project API
  description: The Project API from Polycode — 1 operation(s) for project.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Project
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-project-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-projects-api
  name: Polycode Projects API
  description: The Projects API from Polycode — 3 operation(s) for projects.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Projects
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-projects-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-sessions-api
  name: Polycode Sessions API
  description: The Sessions API from Polycode — 2 operation(s) for sessions.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Sessions
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-sessions-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-status-api
  name: Polycode Status API
  description: The Status API from Polycode — 1 operation(s) for status.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Status
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-status-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-test-api
  name: Polycode Test API
  description: The Test API from Polycode — 1 operation(s) for test.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Test
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-test-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-usage-api
  name: Polycode Usage API
  description: The Usage API from Polycode — 2 operation(s) for usage.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-usage-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
- aid: polycode-co-uk:polycode-co-uk-visitor-api
  name: Polycode Visitor API
  description: The Visitor API from Polycode — 2 operation(s) for visitor.
  humanURL: https://marginalia.polycode.co.uk/developers
  baseURL: https://marginalia.polycode.co.uk/api
  tags:
  - Visitor
  properties:
  - type: OpenAPI
    url: openapi/polycode-co-uk-visitor-api-openapi.yml
  - type: Documentation
    url: https://marginalia.polycode.co.uk/developers
  - type: APIReference
    url: https://marginalia.polycode.co.uk/api/openapi.json
  - type: Sandbox
    url: sandbox/polycode-co-uk-sandbox.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Overlay
  url: overlays/polycode-co-uk-marginalia-overlay.yaml
- type: Website
  url: https://marginalia.polycode.co.uk/
- type: DeveloperPortal
  url: https://marginalia.polycode.co.uk/developers
  name: 'developers page (client-rendered: model, deployed commit, Swagger UI at /developers/api)'
- type: Documentation
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/README.md
- type: APIReference
  url: https://marginalia.polycode.co.uk/api/openapi.json
- type: GettingStarted
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/README.md#talk-to-it--the-a2a-api
  name: 'README — Talk to it: the A2A API (curl examples)'
- type: Login
  url: https://marginalia.polycode.co.uk/auth/login
  name: Tier-1 login (Google via Amazon Cognito)
- type: Support
  url: mailto:antony@polycode.co.uk
  name: Operator contact (email) — issues, security disclosures, GDPR requests
- type: TermsOfService
  url: https://marginalia.polycode.co.uk/#legal-text-terms
  name: Terms (inline dialog on the chat surface, static HTML)
- type: PrivacyPolicy
  url: https://marginalia.polycode.co.uk/#legal-text-privacy
  name: Privacy (inline dialog on the chat surface, static HTML)
- type: PrivacyPolicy
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/_developers/ETHICS.md
  name: ETHICS.md — redact-at-ingest privacy policy and visitor rights
- type: License
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/LICENSE
  name: AGPL-3.0-only (code); CC-BY-SA 4.0 (visitor contributions)
- type: OpenSource
  url: https://gitlab.com/polycode-projects/marginalia
- type: GitLabRepositories
  url: https://gitlab.com/polycode-projects/marginalia
- type: GitLabOrganizations
  url: https://gitlab.com/polycode-projects
- type: RoadMap
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/NEXT.md
  name: NEXT.md — living handover and open items
- type: AgentCard
  url: a2a/polycode-co-uk-a2a.yml
- type: WellKnown
  url: well-known/polycode-co-uk-well-known.yml
- type: LLMsTxt
  url: llms/polycode-co-uk-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Authentication
  url: authentication/polycode-co-uk-authentication.yml
- type: Conventions
  url: conventions/polycode-co-uk-conventions.yml
- type: ErrorCatalog
  url: errors/polycode-co-uk-problem-types.yml
- type: Lifecycle
  url: lifecycle/polycode-co-uk-lifecycle.yml
- type: Conformance
  url: conformance/polycode-co-uk-conformance.yml
- type: DataModel
  url: data-model/polycode-co-uk-data-model.yml
- type: Sandbox
  url: sandbox/polycode-co-uk-sandbox.yml
- type: Plans
  url: plans/polycode-co-uk-plans-pricing.yml
- type: RateLimits
  url: rate-limits/polycode-co-uk-rate-limits.yml
- type: Packages
  url: packages/polycode-co-uk-packages.yml
- type: CLI
  url: cli/polycode-co-uk-cli.yml
- type: AgenticAccess
  url: agentic-access/polycode-co-uk-agentic-access.yml
- type: DomainSecurity
  url: security/polycode-co-uk-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/polycode-co-uk-vulnerability-disclosure.yml
- type: Security
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/_developers/ETHICS.md
  name: Security disclosures — email channel stated in ETHICS.md ("Issues, security disclosures, GDPR requests")
- type: DataSubjectRequest
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/_developers/ETHICS.md
  name: UK GDPR access / rectification / erasure by email with the session UUID
- type: AITransparency
  url: https://marginalia.polycode.co.uk/
  name: AI-system disclaimer shown before the first message (model, region, operator)
- type: NoticeAndAction
  url: https://marginalia.polycode.co.uk/
  name: Flag this memory (dialog + POST /api/flag) — operator review flow
- type: DataResidency
  url: https://gitlab.com/polycode-projects/marginalia/-/blob/main/README.md#operating
  name: Hosting/inference region statement (Amazon Bedrock, eu-west-2)
x-enrichment:
  date: '2026-09-19'
  status: enriched
  artifacts_added: 26
  pass: local-v3
x-legal-name: Polycode Limited
x-a2a:
  verified: true
  probed: '2026-09-26'
  url: "https://marginalia.polycode.co.uk/.well-known/agent-card.json"
  grade: "conformant"
  protocol_version: "0.3.0"
  control: 403