ContextDB · Schema
FormationResponse
Artificial IntelligenceMemoryCustomer DataAgent PlatformContext
Properties
| Name | Type | Description |
|---|---|---|
| run_id | string | |
| status | string | |
| mode | string | |
| attempts | integer | |
| candidates | array | |
| memories | array | |
| memory_ids | array | |
| operation_results | array | |
| operation_counts | object | |
| memory_version | integernull | |
| primary_wal_lsn | stringnull | |
| error_code | stringnull | |
| request_id | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/contextdb-ai/json-schema/contextdb-ai-formation-response-schema.json",
"title": "FormationResponse",
"x-generated": "2026-11-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/contextdb-ai-openapi.yaml#/components/schemas/FormationResponse",
"type": "object",
"required": [
"run_id",
"status",
"mode",
"attempts",
"candidates",
"memories",
"memory_ids",
"operation_results",
"operation_counts",
"memory_version",
"primary_wal_lsn",
"error_code",
"request_id"
],
"properties": {
"run_id": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"completed",
"no_memories",
"provider_unavailable",
"provider_error",
"invalid_output",
"timed_out",
"budget_exhausted",
"storage_error",
"internal_error",
"interrupted"
]
},
"mode": {
"type": "string",
"enum": [
"propose",
"commit"
]
},
"attempts": {
"type": "integer",
"minimum": 0,
"maximum": 3
},
"candidates": {
"type": "array",
"items": {
"$ref": "#/$defs/FormationCandidate"
}
},
"memories": {
"type": "array",
"items": {
"$ref": "#/$defs/Memory"
}
},
"memory_ids": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
},
"operation_results": {
"type": "array",
"maxItems": 20,
"items": {
"$ref": "#/$defs/FormationOperationResult"
}
},
"operation_counts": {
"$ref": "#/$defs/FormationOperationCounts"
},
"memory_version": {
"type": [
"integer",
"null"
],
"minimum": 0
},
"primary_wal_lsn": {
"type": [
"string",
"null"
],
"pattern": "^[0-9A-Fa-f]+/[0-9A-Fa-f]+$"
},
"error_code": {
"type": [
"string",
"null"
]
},
"request_id": {
"type": "string"
}
},
"additionalProperties": false,
"$defs": {
"EpistemicSource": {
"type": "string",
"enum": [
"user_stated",
"agent_inferred",
"third_party"
],
"description": "Who vouches for the claim. Required on writes."
},
"EvolutionOperation": {
"type": "string",
"enum": [
"add",
"update",
"delete",
"noop"
]
},
"EvolutionOutcome": {
"type": "string",
"enum": [
"added",
"updated",
"deleted",
"noop",
"contested"
]
},
"FormationCandidate": {
"type": "object",
"required": [
"content",
"quote",
"turn_indexes",
"source",
"confidence",
"action_relevant",
"entity",
"attribute",
"operation",
"target_memory_id",
"noop_reason",
"candidate_key"
],
"properties": {
"content": {
"type": [
"string",
"null"
]
},
"quote": {
"type": [
"string",
"null"
],
"description": "Exact PII-processed quote supporting the candidate"
},
"turn_indexes": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0
}
},
"source": {
"$ref": "#/$defs/EpistemicSource"
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"action_relevant": {
"type": "boolean"
},
"entity": {
"type": [
"string",
"null"
]
},
"attribute": {
"type": [
"string",
"null"
]
},
"operation": {
"$ref": "#/$defs/EvolutionOperation"
},
"target_memory_id": {
"type": [
"string",
"null"
],
"maxLength": 256
},
"noop_reason": {
"type": [
"string",
"null"
],
"maxLength": 64
},
"candidate_key": {
"type": "string",
"pattern": "^fmc_[a-f0-9]{40}$"
}
},
"additionalProperties": false
},
"FormationOperationCounts": {
"type": "object",
"required": [
"added",
"updated",
"deleted",
"noop"
],
"properties": {
"added": {
"type": "integer",
"minimum": 0,
"maximum": 20
},
"updated": {
"type": "integer",
"minimum": 0,
"maximum": 20
},
"deleted": {
"type": "integer",
"minimum": 0,
"maximum": 20
},
"noop": {
"type": "integer",
"minimum": 0,
"maximum": 20
}
},
"additionalProperties": false
},
"FormationOperationResult": {
"type": "object",
"required": [
"candidate_key",
"requested_operation",
"applied_operation",
"outcome",
"memory_id",
"previous_memory_ids",
"deleted_memory_ids",
"target_memory_id",
"noop_reason"
],
"properties": {
"candidate_key": {
"type": "string",
"pattern": "^(?:fmc_[a-f0-9]{40}|legacy_v1_[0-9]+)$"
},
"requested_operation": {
"$ref": "#/$defs/EvolutionOperation"
},
"applied_operation": {
"$ref": "#/$defs/EvolutionOperation"
},
"outcome": {
"$ref": "#/$defs/EvolutionOutcome"
},
"memory_id": {
"type": [
"string",
"null"
]
},
"previous_memory_ids": {
"type": "array",
"maxItems": 100,
"items": {
"type": "string"
}
},
"deleted_memory_ids": {
"type": "array",
"maxItems": 100,
"items": {
"type": "string"
}
},
"target_memory_id": {
"type": [
"string",
"null"
]
},
"noop_reason": {
"type": [
"string",
"null"
],
"maxLength": 256
}
},
"additionalProperties": false
},
"Memory": {
"type": "object",
"required": [
"id",
"content",
"user_id",
"epistemic_source",
"confidence",
"corroboration_count",
"action_relevant",
"requires_confirmation",
"confirmed",
"independent_corroboration",
"injection_suspect",
"entity_key",
"attribute_key",
"valid_until",
"superseded_by"
],
"properties": {
"id": {
"type": "string"
},
"content": {
"type": "string",
"description": "Stored content with PII redacted as `[TYPE]` placeholders"
},
"user_id": {
"type": [
"string",
"null"
]
},
"epistemic_source": {
"$ref": "#/$defs/EpistemicSource"
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"corroboration_count": {
"type": "integer",
"minimum": 0
},
"action_relevant": {
"type": "boolean"
},
"requires_confirmation": {
"type": "boolean"
},
"confirmed": {
"type": "boolean"
},
"independent_corroboration": {
"type": "integer",
"minimum": 0
},
"injection_suspect": {
"type": "boolean"
},
"entity_key": {
"type": [
"string",
"null"
]
},
"attribute_key": {
"type": [
"string",
"null"
]
},
"valid_until": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"superseded_by": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/contextdb-ai-formation-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.