BotSociety

Botsociety is a tool to design, preview, and prototype conversational interfaces — chatbots and voice assistants — before they are built. Its API lets applications retrieve the content of a design (messages, intents, variables, and integration data) at runtime, so bot content can be updated in the design tool without redeploying bot code. The API exposes design retrieval plus a legacy apisociety 2.0 surface for managing conversations, messages, and variables, authenticated with a user id and a public API key sent as request headers. Botsociety, backed by 500 Global, is winding down ("working on a new direction") and its API host is presently unreachable; the artifacts in this repo are reconstructed from the official first-party npm client and public API documentation. Surfaced originally as a 500 Global portfolio company and enriched into the API Evangelist network.

BotSociety publishes 4 APIs on the APIs.io network, including Conversations API, Designs API, Messages API, and 1 more. Tagged areas include Company, Chatbots, Conversational AI, Voice Assistants, and Bot Design.

BotSociety’s developer surface includes documentation, API reference, authentication, changelog, and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub

35.9/100 thin ▬ flat Agent 51/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5

AccessSelf serve

4 APIs 1 MCP Servers

CompanyChatbotsConversational AIVoice AssistantsBot DesignPrototypingDeveloper Tools

Kin Score

Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5

Composite quality — 35.9/100 · thin

Contract Quality 13.6 / 25

Developer Ergonomics 9.6 / 20

Commercial Clarity 0.0 / 20

Operational Transparency 2.7 / 13

Governance 0.0 / 12

Discoverability 10.0 / 10

Agent readiness — 51/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 0 / 15

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/botsociety: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

MCPServer

MCPServer

LLMsTxt

LLMsTxt

AgentSkill

AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

DataModel

Conformance

Lifecycle

Build 3

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Packages

Packages

SDKs

SDKs

Access & Security 2

Authentication, authorization, and security posture

Authentication

Authentication

DomainSecurity

DomainSecurity

Operate 1

Status, limits, changes, and where to get help

ChangeLog

ChangeLog

Company 1

The organization behind the API

Website

Website

Other 1

Properties that don't map to a standard resource type

Overlay

Overlay

Source (apis.yml)

aid: botsociety
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/botsociety.png
name: BotSociety
description: Botsociety is a tool to design, preview, and prototype conversational interfaces — chatbots and voice assistants
  — before they are built. Its API lets applications retrieve the content of a design (messages, intents, variables, and integration
  data) at runtime, so bot content can be updated in the design tool without redeploying bot code. The API exposes design
  retrieval plus a legacy apisociety 2.0 surface for managing conversations, messages, and variables, authenticated with a
  user id and a public API key sent as request headers. Botsociety, backed by 500 Global, is winding down ("working on a new
  direction") and its API host is presently unreachable; the artifacts in this repo are reconstructed from the official first-party
  npm client and public API documentation. Surfaced originally as a 500 Global portfolio company and enriched into the API
  Evangelist network.
url: https://raw.githubusercontent.com/api-evangelist/botsociety/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- 500-global
x-tier: enriched
x-tier-reason: portfolio-lead
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-18'
tags:
- Company
- Chatbots
- Conversational AI
- Voice Assistants
- Bot Design
- Prototyping
- Developer Tools
apis:
- aid: botsociety:botsociety-conversations-api
  name: BotSociety Conversations API
  description: Manage conversations (legacy apisociety 2.0 API)
  humanURL: https://botsociety.github.io
  baseURL: https://app.botsociety.io
  tags:
  - Conversations
  properties:
  - type: OpenAPI
    url: openapi/botsociety-conversations-api-openapi.yml
  - type: Documentation
    url: https://botsociety.github.io
  - type: APIReference
    url: https://botsociety.docs.apiary.io/
- aid: botsociety:botsociety-designs-api
  name: BotSociety Designs API
  description: Retrieve design/integration content (current API)
  humanURL: https://botsociety.github.io
  baseURL: https://app.botsociety.io
  tags:
  - Designs
  properties:
  - type: OpenAPI
    url: openapi/botsociety-designs-api-openapi.yml
  - type: Documentation
    url: https://botsociety.github.io
  - type: APIReference
    url: https://botsociety.docs.apiary.io/
- aid: botsociety:botsociety-messages-api
  name: BotSociety Messages API
  description: Manage messages within a conversation (legacy apisociety 2.0 API)
  humanURL: https://botsociety.github.io
  baseURL: https://app.botsociety.io
  tags:
  - Messages
  properties:
  - type: OpenAPI
    url: openapi/botsociety-messages-api-openapi.yml
  - type: Documentation
    url: https://botsociety.github.io
  - type: APIReference
    url: https://botsociety.docs.apiary.io/
- aid: botsociety:botsociety-variables-api
  name: BotSociety Variables API
  description: Manage variables within a conversation (legacy apisociety 2.0 API)
  humanURL: https://botsociety.github.io
  baseURL: https://app.botsociety.io
  tags:
  - Variables
  properties:
  - type: OpenAPI
    url: openapi/botsociety-variables-api-openapi.yml
  - type: Documentation
    url: https://botsociety.github.io
  - type: APIReference
    url: https://botsociety.docs.apiary.io/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://botsociety.io
- type: Documentation
  url: https://botsociety.github.io
- type: APIReference
  url: https://botsociety.docs.apiary.io/
- type: GitHubOrganization
  url: https://github.com/botsociety
- type: Authentication
  url: authentication/botsociety-authentication.yml
- type: DomainSecurity
  url: security/botsociety-domain-security.yml
- type: Packages
  url: packages/botsociety-packages.yml
- type: SDKs
  url: packages/botsociety-packages.yml
- type: Conventions
  url: conventions/botsociety-conventions.yml
- type: ErrorCatalog
  url: errors/botsociety-problem-types.yml
- type: DataModel
  url: data-model/botsociety-data-model.yml
- type: MCPServer
  url: mcp/botsociety-mcp.yml
- type: Conformance
  url: conformance/botsociety-conformance.yml
- type: Lifecycle
  url: lifecycle/botsociety-lifecycle.yml
- type: ChangeLog
  url: changelog/botsociety-changelog.yml
- type: LLMsTxt
  url: llms/botsociety-llms.txt
- type: Overlay
  url: overlays/botsociety-openapi-overlay.yaml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence

BotSociety

Kin Score

APIs 4

BotSociety Conversations API

BotSociety Designs API

BotSociety Messages API

BotSociety Variables API

MCP Servers 1

botsociety-mcp.yml

Security Posture 2

Botsociety Authentication

Botsociety Domain Security

Resources