Properties
| Name | Type | Description |
|---|---|---|
| tablespace_name | string | Explicit tablespace policy for the new table, overriding namespace and database defaults. |
| storage | object | |
| num_shards | integer | Number of shards to create for the table. Data is partitioned across shards based on key ranges. **Sizing Guidelines:** - Small datasets (<100K docs): 1-3 shards - Medium datasets (100K-1M docs): 3-10 |
| description | string | Optional human-readable description of the table and its purpose. Useful for documentation and team collaboration. |
| indexes | object | Map of index name to create-index configuration. The map key owns the index name; do not repeat `name` inside the configuration. Indexes enable different query capabilities: - Full-text indexes for BM |
| schema | object | Optional schema definition specifying field types, primary key, and TTL configuration. While optional, defining a schema provides type safety, optimized indexing, and better search performance. **Sche |
| replication_sources | array | PostgreSQL CDC replication sources. Streams INSERT/UPDATE/DELETE changes from PostgreSQL tables into this Antfly table via logical replication. Multiple sources can feed into a single table (e.g., `us |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/antfly/json-schema/antfly-create-table-request-schema.json",
"title": "CreateTableRequest",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/antfly-table-management-api-openapi.yml#/components/schemas/CreateTableRequest",
"type": "object",
"properties": {
"tablespace_name": {
"type": "string",
"description": "Explicit tablespace policy for the new table, overriding namespace and database defaults.",
"maxLength": 128
},
"storage": {
"$ref": "#/$defs/TableStorageSettings"
},
"num_shards": {
"type": "integer",
"format": "uint",
"description": "Number of shards to create for the table. Data is partitioned across shards based on key ranges.\n\n**Sizing Guidelines:**\n- Small datasets (<100K docs): 1-3 shards\n- Medium datasets (100K-1M docs): 3-10 shards\n- Large datasets (>1M docs): 10+ shards\n\nMore shards enable better parallelism but increase overhead. Choose based on expected data size and query patterns.\n\n**When to Add More Shards:**\n\nAntfly supports **online shard reallocation** without downtime. Add more shards when:\n- Individual shards exceed size thresholds (configurable)\n- Query latency increases due to large shard size\n- Need better parallelism for write-heavy workloads\n\nUse the internal `/reallocate` endpoint to trigger automatic shard splitting:\n```bash\nPOST /internal/v1/reallocate\n```\n\nThis enqueues a reallocation request that the leader processes asynchronously, splitting\nlarge shards and redistributing data without service interruption.\n\n**Advantages over Elasticsearch:**\n- Automatic shard splitting (no manual reindexing required)\n- Online operation (no downtime)\n- Transparent to applications (keys remain accessible during reallocation)\n"
},
"description": {
"type": "string",
"maxLength": 500,
"description": "Optional human-readable description of the table and its purpose.\nUseful for documentation and team collaboration.\n"
},
"indexes": {
"type": "object",
"description": "Map of index name to create-index configuration. The map key owns the\nindex name; do not repeat `name` inside the configuration. Indexes enable\ndifferent query capabilities:\n- Full-text indexes for BM25 search\n- Vector indexes for semantic similarity\n- Multimodal indexes for images/audio/video\n\nYou can add multiple indexes to support different query patterns.\n",
"additionalProperties": {
"$ref": "#/$defs/CreateIndexRequest"
}
},
"schema": {
"description": "Optional schema definition specifying field types, primary key, and TTL configuration.\nWhile optional, defining a schema provides type safety, optimized indexing, and better search performance.\n\n**Schema Features:**\n- **Field Types**: Define document structure using JSON Schema with `x-antfly-types` extensions\n- **Document TTL**: Configure automatic expiration with a `ttl` policy\n- **Primary Keys**: Specify unique identifier fields\n- **Validation**: Enforce schema constraints on writes\n\n**TTL Example:**\n```json\n{\n \"ttl\": {\"duration\": \"7d\", \"field\": \"_timestamp\"},\n \"document_schemas\": {...}\n}\n```\n\nSee the Table Management documentation for comprehensive TTL configuration and use cases.\n",
"$ref": "#/$defs/TableSchema"
},
"replication_sources": {
"type": "array",
"items": {
"$ref": "#/$defs/ReplicationSource"
},
"description": "PostgreSQL CDC replication sources. Streams INSERT/UPDATE/DELETE changes from\nPostgreSQL tables into this Antfly table via logical replication.\n\nMultiple sources can feed into a single table (e.g., `users` + `scores` → Antfly `users`).\nEach source uses `on_update`/`on_delete` transforms to control how PG events map to\nAntfly document operations. Requires `wal_level=logical` on the PostgreSQL source.\n"
}
},
"$defs": {
"AlgebraicAggregateConfig": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"op"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"op": {
"type": "string",
"enum": [
"count",
"sum",
"avg",
"min",
"max"
]
},
"group_by": {
"type": "array",
"maxItems": 32,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"measure": {
"type": "string",
"minLength": 1,
"description": "Required except for count. Omitted count means COUNT(*); a supplied column means COUNT(column), excluding SQL NULL values."
}
}
},
"AlgebraicIndexConfig": {
"type": "object",
"description": "Schema-derived algebraic index capabilities with optional declarative aggregate recipes. Physical materialization state remains engine-owned.",
"properties": {
"derive_from_schema": {
"x-go-type-skip-optional-pointer": true,
"type": "boolean",
"description": "When true, derive typed fields and capabilities from the table schema. Physical fields, laws, joins and state remain engine-owned."
},
"aggregates": {
"type": "array",
"maxItems": 64,
"description": "Desired exact aggregate recipes over schema column names. Eligible SQL automatically reuses complete, snapshot-bound materializations; unsupported SQL shapes retain scanning.",
"items": {
"$ref": "#/$defs/AlgebraicAggregateConfig"
}
}
}
},
"AntflyChunkerConfig": {
"description": "Configuration for the Antfly inference chunking provider.\n\nAntfly inference is Antfly's built-in ML service for local chunking.\n\n**Chunking Models:**\n- fixed: Fixed-size chunking by token count, with fixed time windows for audio\n (aliases `fixed_bert`, `fixed_bpe`, and `fixed-bert-tokenizer`). This is the\n only chunking model Antfly inference implements; other model names are\n rejected as unsupported.\n\n**Deduplication:**\n- Within a single document write, chunk results are deduplicated when multiple\n indexes share the same source text and chunker configuration, so the source\n is chunked at most once per write.\n",
"allOf": [
{
"$ref": "#/$defs/ChunkOptions"
},
{
"type": "object",
"properties": {
"api_url": {
"type": "string",
"format": "uri",
"description": "The URL of the Inference API endpoint (e.g., 'http://localhost:8080'). Can also be set via ANTFLY_INFERENCE_URL environment variable."
},
"model": {
"type": "string",
"description": "The chunking model to use. Defaults to 'fixed' for simple token-based chunking; other values select a model from models/chunkers/{name}/. Successful create responses include the effective model.",
"default": "fixed"
}
}
}
]
},
"AntflyEmbedderConfig": {
"type": "object",
"description": "Configuration for the Antfly inference embedding provider.\n\nAntfly inference is Antfly's built-in ML service for local embeddings using ONNX models.\n\n**Features:**\n- Local ONNX-based embedding generation\n- Query-time embeddings are served from an in-memory cache (64 MiB budget,\n 5-minute TTL by default) with concurrent identical requests coalesced onto\n a single computation; there is no persistent on-disk cache tier\n\n**Example Models:** bge-base-en-v1.5 (768 dims), all-MiniLM-L6-v2 (384 dims)\n\nModels are loaded from the `models/embedders/{name}/` directory.",
"properties": {
"model_identity": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Immutable EmbeddingGemma 2 asset and recipe identity returned by /embed. Pin this when indexing; a changed checkpoint, tokenizer, or processor rejects embedding before vector publication."
},
"provider": {
"type": "string",
"enum": [
"antfly"
]
},
"model": {
"type": "string",
"description": "The embedding model name (maps to models/embedders/{name}/ directory)."
},
"api_url": {
"type": "string",
"format": "uri",
"description": "The URL of the Inference API endpoint. Can also be set via ANTFLY_INFERENCE_URL environment variable."
},
"retrieval": {
"$ref": "#/$defs/EmbeddingRetrievalConfig"
}
},
"required": [
"provider",
"model"
]
},
"AntflyGeneratorConfig": {
"type": "object",
"description": "Configuration for the Antfly inference generative AI provider.\n",
"properties": {
"provider": {
"type": "string",
"enum": [
"antfly"
]
},
"model": {
"type": "string",
"description": "The name of the generator model."
},
"api_url": {
"type": "string",
"format": "uri",
"description": "The URL of the Inference API endpoint. Can also be set via ANTFLY_INFERENCE_URL environment variable."
},
"temperature": {
"type": "number",
"format": "float",
"description": "Controls randomness in generation (0.0-2.0).",
"minimum": 0.0,
"maximum": 2.0
},
"max_tokens": {
"type": "integer",
"description": "Maximum number of tokens to generate."
},
"top_p": {
"type": "number",
"format": "float",
"description": "Nucleus sampling parameter.",
"minimum": 0.0,
"maximum": 1.0
},
"top_k": {
"type": "integer",
"description": "Top-k sampling parameter."
},
"timeout": {
"type": "integer",
"description": "HTTP response timeout in seconds for Inference API calls.",
"minimum": 1
}
},
"required": [
"provider",
"model"
]
},
"AntflySTTConfig": {
"type": "object",
"required": [
"model"
],
"description": "Configuration for Antfly inference STT (Whisper, Wav2Vec2, HuBERT) provider.\n\nUses the Antfly inference service for speech-to-text inference.\n\n**Supported Models:** openai/whisper-tiny, openai/whisper-base, facebook/wav2vec2-base\n\n**Supported Formats:** WAV (recommended), MP3, FLAC, M4A/AAC\n\n**Docs:** See inference documentation",
"properties": {
"api_url": {
"type": "string",
"format": "uri",
"description": "Inference API URL. Falls back to ANTFLY_INFERENCE_URL environment variable."
},
"model": {
"type": "string",
"minLength": 1,
"description": "Explicit Antfly transcriber model name (e.g., 'openai/whisper-tiny')."
}
}
},
"AnthropicGeneratorConfig": {
"type": "object",
"description": "Configuration for the Anthropic generative AI provider.\n",
"properties": {
"provider": {
"type": "string",
"enum": [
"anthropic"
]
},
"workspace_id": {
"type": "string",
"description": "Anthropic workspace for keys not scoped to a workspace. Defaults to ANTHROPIC_WORKSPACE_ID."
},
"model": {
"type": "string",
"description": "The full model ID of the Anthropic model to use.",
"default": "claude-sonnet-4-5-20250929"
},
"api_key": {
"type": "string",
"writeOnly": true,
"description": "Anthropic API key or secret reference. Defaults to ANTHROPIC_API_KEY."
},
"url": {
"type": "string",
"format": "uri",
"description": "Messages API base URL. Defaults to https://api.anthropic.com/v1."
},
"temperature": {
"type": "number",
"format": "float",
"description": "Controls randomness in generation (0.0-1.0).",
"minimum": 0.0,
"maximum": 1.0
},
"max_tokens": {
"type": "integer",
"description": "Maximum number of tokens to generate in the response."
},
"top_p": {
"type": "number",
"format": "float",
"description": "Nucleus sampling parameter (0.0-1.0).",
"minimum": 0.0,
"maximum": 1.0
},
"top_k": {
"type": "integer",
"description": "Top-k sampling parameter."
}
},
"required": [
"provider",
"model"
]
},
"AppleGeneratorConfig": {
"type": "object",
"description": "On-device Apple Foundation Models generation. Requires a macOS Apple provider build, Apple Intelligence enabled, and its system model ready. Supports text conversations; tool calling and media attachments are not supported.",
"properties": {
"provider": {
"type": "string",
"enum": [
"apple"
]
},
"max_tokens": {
"type": "integer",
"minimum": 1,
"default": 256
},
"temperature": {
"type": "number",
"minimum": 0,
"maximum": 2
}
}
},
"AppleSTTConfig": {
"type": "object",
"description": "On-device SpeechAnalyzer file transcription. Requires a macOS Apple provider build and supported Speech assets. Diarization is unsupported.",
"properties": {
"language_code": {
"type": "string",
"default": "en-US",
"description": "Supported Speech locale; Apple transcription does not infer a language."
},
"timestamps": {
"type": "boolean",
"x-go-type-skip-optional-pointer": false,
"default": true
},
"download_assets": {
"type": "boolean",
"default": false,
"description": "Explicitly permit preparing and installing the selected Speech assets."
}
}
},
"ArtifactIndexSource": {
"type": "object",
"additionalProperties": false,
"required": [
"artifact"
],
"description": "Named generated artifact stream consumed by an index. Producer inputs belong on the matching enrichment.",
"properties": {
"artifact": {
"type": "string",
"minLength": 1,
"description": "Stable name of a generated artifact stream."
}
}
},
"AudioChunkOptions": {
"type": "object",
"description": "Options specific to audio chunking.",
"properties": {
"window_duration_ms": {
"type": "integer",
"minimum": 0,
"maximum": 86400000,
"description": "Window duration in milliseconds for fixed-window audio chunking (default: 30000)."
},
"overlap_duration_ms": {
"type": "integer",
"minimum": 0,
"maximum": 86400000,
"description": "Overlap duration in milliseconds between audio chunks (default: 0)."
}
}
},
"AutocompleteQuery": {
"type": "object",
"additionalProperties": false,
"description": "Analyzed bool-prefix search on a logical field. The planner selects\ndeclared search-as-you-type root, shingle and prefix representations.\nRequires a compatible representation; never silently becomes raw prefix search.\n",
"required": [
"autocomplete",
"field"
],
"properties": {
"autocomplete": {
"type": "string"
},
"field": {
"type": "string",
"minLength": 1
},
"boost": {
"$ref": "#/$defs/Boost"
}
}
},
"BedrockEmbedderConfig": {
"type": "object",
"description": "Configuration for the AWS Bedrock embedding provider.\n\nUses the AWS credential chain: environment variables, web identity, shared credentials, ECS task roles, and EC2 instance roles.\n\n**Example Models:** cohere.embed-v4:0, amazon.titan-embed-text-v2:0\n\n**Docs:** https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html",
"properties": {
"provider": {
"type": "string",
"enum": [
"bedrock"
]
},
"model": {
"type": "string",
"description": "The Bedrock model ID, inference profile ID, or ARN to invoke (e.g., 'cohere.embed-v4:0', 'amazon.titan-embed-text-v2:0', or an application inference profile ARN)."
},
"request_format": {
"type": "string",
"enum": [
"auto",
"titan_text",
"titan_multimodal",
"cohere_v3",
"cohere_v4"
],
"description": "Bedrock provider request schema. `auto` recognizes direct foundation-model IDs,\nfoundation-model ARNs, and system inference-profile IDs/ARNs. Set this explicitly\nfor application inference profiles, provisioned throughput, custom models, and\nother aliases whose invocation target does not identify the underlying model.",
"default": "auto"
},
"region": {
"type": "string",
"description": "The AWS region for the Bedrock service (e.g., 'us-east-1')."
},
"dimension": {
"type": "integer",
"description": "Output dimension for Bedrock embedding models that support configurable dimensions."
},
"dimensions": {
"type": "integer",
"description": "Alias for output dimension when using OpenAI-compatible configuration fields."
},
"input_type": {
"type": "string",
"description": "Cohere Bedrock input type, such as search_document, search_query, classification, or clustering."
},
"truncate": {
"type": "string",
"description": "Cohere Bedrock truncate behavior."
},
"strip_new_lines": {
"type": "boolean",
"description": "Whether to strip new lines from the input text before embedding.",
"default": false
},
"batch_size": {
"type": "integer",
"description": "The batch size for embedding requests to optimize throughput.",
"default": 1
},
"retrieval": {
"$ref": "#/$defs/EmbeddingRetrievalConfig"
}
},
"required": [
"provider",
"model"
]
},
"BedrockGeneratorConfig": {
"type": "object",
"description": "AWS Bedrock Converse generation, including image inputs and tools for\nmodels that support them. Uses the AWS default credential chain unless\nan explicit Bedrock API key is configured. Image capability is declared\nper target through inference_capabilities; model IDs are not allowlisted.\n",
"properties": {
"provider": {
"type": "string",
"enum": [
"bedrock"
]
},
"url": {
"type": "string",
"description": "Optional Bedrock Runtime endpoint override. Defaults to the regional AWS endpoint."
},
"api_key": {
"type": "string",
"description": "Optional Bedrock bearer API key or secret reference. Omit to use signed AWS requests and the default credential chain."
},
"model": {
"type": "string",
"description": "The Bedrock model ID to use."
},
"region": {
"type": "string",
"description": "AWS region. Defaults to AWS_REGION, then AWS_DEFAULT_REGION, then us-east-1."
},
"temperature": {
"type": "number",
"format": "float",
"description": "Controls randomness in generation (0.0-1.0).",
"minimum": 0.0,
"maximum": 1.0
},
"max_tokens": {
"type": "integer",
"description": "Maximum number of tokens to generate."
},
"top_p": {
"type": "number",
"format": "float",
"description": "Nucleus sampling parameter.",
"minimum": 0.0,
"maximum": 1.0
}
},
"required": [
"provider",
"model"
]
},
"BoolFieldQuery": {
"type": "object",
"properties": {
"bool": {
"type": "boolean"
},
"field": {
"type": "string"
},
"boost": {
"$ref": "#/$defs/Boost"
}
},
"required": [
"bool"
]
},
"BoolQuery": {
"type": "object",
"additionalProperties": false,
"required": [
"bool"
],
"description": "Canonical Boolean wrapper. Must clauses score; filter clauses constrain without scoring.",
"properties": {
"bool": {
"$ref": "#/$defs/BoolQueryBody"
}
}
},
"BoolQueryBody": {
"type": "object",
"additionalProperties": false,
"properties": {
"must": {
"$ref": "#/$defs/BoolQueryClause"
},
"should": {
"$ref": "#/$defs/BoolQueryClause"
},
"must_not": {
"$ref": "#/$defs/BoolQueryClause"
},
"filter": {
"$ref": "#/$defs/BoolQueryClause"
},
"minimum_should_match": {
"type": "integer",
"format": "uint32",
"minimum": 0,
"description": "Minimum optional clauses required; omission follows the runtime's required-clause defaults."
},
"boost": {
"$ref": "#/$defs/Boost"
}
}
},
"BoolQueryClause": {
"oneOf": [
{
"$ref": "#/$defs/Query"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/Query"
}
}
]
},
"BooleanQuery": {
"type": "object",
"additionalProperties": false,
"properties": {
"must": {
"$ref": "#/$defs/ConjunctionQuery"
},
"should": {
"$ref": "#/$defs/DisjunctionQuery"
},
"must_not": {
"$ref": "#/$defs/DisjunctionQuery"
},
"filter": {
"$ref": "#/$defs/Query"
},
"boost": {
"$ref": "#/$defs/Boost"
}
}
},
"Boost": {
"type": [
"number",
"null"
],
"format": "double",
"description": "A floating-point number used to decrease or increase the relevance scores of a query.",
"default": 1.0
},
"ChatGPTGeneratorConfig": {
"type": "object",
"description": "Personal ChatGPT plan for interactive generation. Credentials stay in the local runtime.",
"required": [
"provider",
"model",
"connection_id"
],
"properties": {
"provider": {
"type": "string",
"enum": [
"chatgpt"
]
},
"reasoning_effort": {
"$ref": "#/$defs/OpenAIReasoningEffort"
},
"model": {
"type": "string"
},
"connection_id": {
"type": "string",
"description": "Opaque personal registration owned by the authenticated caller."
}
}
},
"ChoiceDecisionQuestion": {
"type": "object",
"additionalProperties": false,
"required": [
"type",
"name",
"instructions",
"choices"
],
"properties": {
"type": {
"type": "string",
"enum": [
"choice"
]
},
"name": {
"type": "string",
"minLength": 1
},
"instructions": {
"type": "string",
"minLength": 1
},
"choices": {
"type": "array",
"items": {
"$ref": "#/$defs/DecisionChoice"
},
"minItems": 2,
"maxItems": 64
},
"embedding_options": {
"$ref": "#/$defs/EmbeddingDecisionAcceptance"
}
}
},
"ChunkDiarizationConfig": {
"type": "object",
"description": "Source-wide online speaker clustering on a fixed 1.5 s grid with 3 s embedding windows. Identities are stable within a source and recipe. Silence and ambiguous voices remain unassigned. Analysis advances incrementally; admitted cached timelines and durable centroid/sample-position checkpoints are shared across matching outputs and continuations. Missing checkpoints reconstruct the required prefix deterministically.",
"properties": {
"model": {
"type": "string",
"description": "Speaker ONNX registry reference; defaults to 3D-Speaker CAM++. For kind=diarize the target model selects the speaker model."
},
"model_identity": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Optional SHA-256 pin of the speaker ONNX file, including when paired with a transcription model."
},
"similarity_threshold": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 1,
"default": 0.45
},
"ambiguity_margin": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 1,
"default": 0.03
},
"min_rms": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 1,
"default": 0.01
},
"max_speakers": {
"type": "integer",
"minimum": 1,
"maximum": 64,
"default": 64
}
}
},
"ChunkEmbeddingTarget": {
"type": "object",
"required": [
"model"
],
"properties": {
"model": {
"type": "string",
"minLength": 1
},
"model_identity": {
"type": "string",
"minLength": 64,
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"description": "Optional required embedding-weight/recipe identity; a changed model is rejected before delivery."
},
"task_type": {
"type": "string",
"default": "RETRIEVAL_DOCUMENT"
},
"dimensions": {
"type": "integer",
"minimum": 1
},
"execute": {
"type": "boolean",
"x-go-type-skip-optional-pointer": false,
"default": true,
"description": "False resolves model limits and plans descriptors without running embedding inference."
},
"allow_partial": {
"type": "boolean",
"default": false,
"description": "Return explicit per-chunk failures and gaps instead of aborting on the first non-retryable embedding failure."
}
}
},
"ChunkOptions": {
"type": "object",
"description": "Per-request configuration for chunking. All fields are optional - zero/omitted values use chunker defaults.",
"properties": {
"max_chunks": {
"type": "integer",
"minimum": 0,
"maximum": 4096,
"description": "Maximum chunks in one response; zero requests the full result. Model-aware responses return continuation coverage when a page is full: follow next_continuation until source_complete. Embedded model-aware enrichment uses this as its page size and continues through the entire source. Fixed chunking without model-aware outputs retains its per-call truncation behavior."
},
"threshold": {
"type": "number",
"format": "float",
"minimum": 0,
"maximum": 1,
"description": "Confidence threshold for model-based chunking (0.0-1.0)."
},
"text": {
"$ref": "#/$defs/TextChunkOptions"
},
"audio": {
"$ref": "#/$defs/AudioChunkOptions"
},
"embedding": {
"$ref": "#/$defs/ChunkEmbeddingTarget"
},
"outputs": {
"$ref": "#/$defs/ChunkOutputs"
},
"policy": {
"$ref": "#/$defs/MediaChunkPolicy"
}
}
},
"ChunkOutputTarget": {
"type": "object",
"required": [
"name",
"kind",
"model"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"kind": {
"type": "string",
"enum": [
"embedding",
"transcribe",
"classify",
"diarize"
]
},
"model": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"execute": {
"type": "boolean",
"default": true,
"description": "False retains this model as a planning boundary while skipping its inference; used for independent output repairs."
},
"skip_windows": {
"type": "array",
"maxItems": 4096,
"description": "Execution-only repair mask for already accepted sub-windows; does not affect the model recipe or boundary plan. Skipped windows return receipts with status skipped.",
"items": {
"type": "object",
"required": [
"ordinal",
"sub_index"
],
"properties": {
"ordinal": {
"type": "integer",
"format": "uint64",
"minimum": 0
},
"sub_index": {
"type": "integer",
"format": "uint32",
"minimum": 0
}
}
}
},
"required": {
"type": "boolean",
"default": true
},
"model_identity": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"task_type": {
"type": "string",
"default": "RETRIEVAL_DOCUMENT"
},
"dimensions": {
"type": "integer",
"minimum": 1
},
"language": {
"type": "string"
},
"diarize": {
"type": "boolean",
"default": false,
"description": "Convenience option on transcription outputs; enables source-wide diarization with the default speaker model."
},
"diarization": {
"description": "Speaker settings for diarize or transcribe outputs; also accepted on the selected audio embedding boundary with audio_speaker_turns=true.",
"$ref": "#/$defs/ChunkDiarizationConfig"
},
"top_k": {
"type": "integer",
"minimum": 1,
"maximum": 128,
"default": 5
}
}
},
"ChunkOutputs": {
"type": "object",
"required": [
"boundary_model",
"targets"
],
"description": "Named independent media outputs. The named boundary model alone determines the shared plan; adding or changing another output preserves parent IDs. The compatibility embedding target is named embedding. Smaller output windows are identified by the parent ordinal and sub_index.",
"properties": {
"boundary_model": {
"type": "string",
"minLength": 1
},
"targets": {
"type": "array",
"minItems": 1,
"maxItems": 16,
"items": {
"$ref": "#/$defs/ChunkOutputTarget"
}
}
}
},
"ChunkerConfig": {
"description": "A unified configuration for a chunking provider.",
"allOf": [
{
"$ref": "#/$defs/AntflyChunkerConfig"
},
{
"type": "object",
"properties": {
"provider": {
"$ref": "#/$defs/ChunkerProvider"
},
"store_chunks": {
"x-go-type-skip-optional-pointer": true,
"type": "boolean",
"description": "Controls whether chunk data is persisted to storage. When false (defau
# --- truncated at 32 KB (288 KB total) ---
# Full source: https://artifacts.apis.io/antfly/json-schema/antfly-create-table-request-schema.json
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/antfly-create-table-request"
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.