Download OpenAPI specification:
Foundation4.ai RAG framework.
TODO: longer description of the Foundation4.ai schema
...
List all the available embedding providers.
{- "data": [
- {
- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "provider": "string"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
List all the available text splitters.
{- "data": [
- {
- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "provider": "string"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
List all the available embedding models.
Provider$Contains (string) or Provider$Contains (null) (Provider$Contains) | |
Provider$Startswith (string) or Provider$Startswith (null) (Provider$Startswith) |
{- "data": [
- {
- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "parameters": { },
- "provider": "string",
- "size": 0
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create an embedding_model.
Description (string) or Description (null) (Description) | |
name required | string (Name) |
Parameters (object) or Parameters (null) (Parameters) | |
provider required | string (Provider) |
size required | integer (Size) > 0 |
{- "description": "string",
- "name": "string",
- "parameters": { },
- "provider": "string",
- "size": 0
}
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "parameters": { },
- "provider": "string",
- "size": 0
}
Get one embedding model.
id required | string <uuid> (Id) |
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "parameters": { },
- "provider": "string",
- "size": 0
}
{- "data": [
- {
- "default_text_splitter_id": "a8f2730d-1ed0-4538-96b3-6ac72fdab704",
- "description": "string",
- "embedding_model_id": "2959178f-981f-441b-a0b6-cedb1eb6201d",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "schema": { }
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create a pipeline.
required | (Array of Classifications (Array of items or strings)) or Classifications (string) (Classifications) |
default_text_splitter_id required | string <uuid> (Default Text Splitter Id) |
Description (string) or Description (null) (Description) | |
embedding_model_id required | string <uuid> (Embedding Model Id) |
name required | string (Name) |
Schema (object) or Schema (null) (Schema) |
{- "classifications": [
- [
- "string",
- "string"
]
], - "default_text_splitter_id": "a8f2730d-1ed0-4538-96b3-6ac72fdab704",
- "description": "string",
- "embedding_model_id": "2959178f-981f-441b-a0b6-cedb1eb6201d",
- "name": "string",
- "schema": { }
}
{- "default_text_splitter_id": "a8f2730d-1ed0-4538-96b3-6ac72fdab704",
- "description": "string",
- "embedding_model_id": "2959178f-981f-441b-a0b6-cedb1eb6201d",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "schema": { }
}
Gets one pipeline object.
id required | string <uuid> (Id) |
{- "default_text_splitter_id": "a8f2730d-1ed0-4538-96b3-6ac72fdab704",
- "description": "string",
- "embedding_model_id": "2959178f-981f-441b-a0b6-cedb1eb6201d",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "schema": { }
}
Create an LLM endpoint.
id required | string <uuid> (Id) |
default_text_splitter_id | string <uuid> (Default Text Splitter Id) Default: "00000000-0000-0000-0000-000000000000" |
Description (string) or Description (null) (Description) | |
name | string (Name) Default: "" |
Schema (object) or Schema (null) (Schema) |
{- "default_text_splitter_id": "00000000-0000-0000-0000-000000000000",
- "description": "string",
- "name": "",
- "schema": { }
}
{- "default_text_splitter_id": "a8f2730d-1ed0-4538-96b3-6ac72fdab704",
- "description": "string",
- "embedding_model_id": "2959178f-981f-441b-a0b6-cedb1eb6201d",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string",
- "schema": { }
}
Sync classification and hierarchies for a pipeline.
id required | string <uuid> (Id) |
required | (Array of Classifications (Array of items or strings)) or Classifications (string) (Classifications) |
required | (Array of Missing (Array of items or strings)) or Missing (string) (Missing) |
{- "classifications": [
- [
- "string",
- "string"
]
], - "missing": [
- [
- "string",
- "string"
]
]
}
null
Get one document.
id required | string <uuid> (Id) |
doc required | string <uuid> (Doc) |
{- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
Get the information for a document previously submitted.
id required | string <uuid> (Id) |
{- "data": [
- {
- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
id required | string <uuid> (Id) |
classification required | string (Classification) |
contents required | string (Contents) |
External Identifier (string) or External Identifier (null) (External Identifier) | |
Metadata (object) or Metadata (null) (Metadata) | |
Text Splitter Id (string) or Text Splitter Id (null) (Text Splitter Id) |
{- "classification": "string",
- "contents": "string",
- "external_identifier": "string",
- "metadata": { },
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
{- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
Find document fragments.
id required | string <uuid> (Id) |
ids required | Array of strings <uuid> (Ids) [ items <uuid > ] |
{- "ids": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
null
List all the available text splitters.
Provider$Contains (string) or Provider$Contains (null) (Provider$Contains) | |
Provider$Startswith (string) or Provider$Startswith (null) (Provider$Startswith) |
{- "data": [
- {
- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "parameters": { },
- "provider": "string"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create an text_splitter.
Description (string) or Description (null) (Description) | |
Parameters (object) or Parameters (null) (Parameters) | |
provider required | string (Provider) |
{- "description": "string",
- "parameters": { },
- "provider": "string"
}
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "parameters": { },
- "provider": "string"
}
{- "data": [
- {
- "description": "string",
- "endpoint": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "model": "string",
- "name": "string"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create an LLM endpoint.
Api Key (string) or Api Key (null) (Api Key) | |
Description (string) or Description (null) (Description) | |
endpoint required | string (Endpoint) |
Model (string) or Model (null) (Model) | |
name required | string (Name) |
{- "api_key": "string",
- "description": "string",
- "endpoint": "string",
- "model": "string",
- "name": "string"
}
{- "description": "string",
- "endpoint": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "model": "string",
- "name": "string"
}
Gets one LLM object.
id required | string <uuid> (Id) |
{- "description": "string",
- "endpoint": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "model": "string",
- "name": "string"
}
Create an LLM endpoint.
id required | string <uuid> (Id) |
Api Key (string) or Api Key (null) (Api Key) | |
Description (string) or Description (null) (Description) | |
endpoint | string (Endpoint) Default: "" |
Model (string) or Model (null) (Model) | |
name | string (Name) Default: "" |
{- "api_key": "string",
- "description": "string",
- "endpoint": "",
- "model": "string",
- "name": ""
}
{- "description": "string",
- "endpoint": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "model": "string",
- "name": "string"
}
Gets one LLM object.
id required | string <uuid> (Id) |
query required | string (Query) |
stream | boolean (Stream) Default: false |
{- "query": "string",
- "stream": false
}
null
{- "data": [
- {
- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "metadata": { },
- "name": "string",
- "placeholders": [
- {
- "name": "string",
- "params": { },
- "target": "string",
- "type": "query"
}
], - "prompt": [
- {
- "include": true,
- "role": "user",
- "template": "string"
}
]
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create an agent.
Description (string) or Description (null) (Description) | |
Metadata (object) or Metadata (null) (Metadata) | |
name required | string (Name) |
required | Array of objects (Placeholders) |
required | Array of objects (Prompt) |
{- "description": "string",
- "metadata": { },
- "name": "string",
- "placeholders": [
- {
- "name": "string",
- "params": { },
- "target": "string",
- "type": "query"
}
], - "prompt": [
- {
- "include": true,
- "role": "user",
- "template": "string"
}
]
}
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "metadata": { },
- "name": "string",
- "placeholders": [
- {
- "name": "string",
- "params": { },
- "target": "string",
- "type": "query"
}
], - "prompt": [
- {
- "include": true,
- "role": "user",
- "template": "string"
}
]
}
Gets one pipeline object.
id required | string <uuid> (Id) |
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "metadata": { },
- "name": "string",
- "placeholders": [
- {
- "name": "string",
- "params": { },
- "target": "string",
- "type": "query"
}
], - "prompt": [
- {
- "include": true,
- "role": "user",
- "template": "string"
}
]
}
Run an agent.
id required | string <uuid> (Id) |
X-LLM-ID required | string <uuid> (X-Llm-Id) |
X-Pipeline-ID required | string <uuid> (X-Pipeline-Id) |
required | ClassificationSearchParameters (object) or Array of Classification (strings) or Classification (string) (Classification) |
Filters (object) or Filters (null) (Filters) | |
AgentExecuteOptions (object) or null | |
output | string (Output) Default: "text" Enum: "text" "json" |
required | object (Prompt) |
stream | boolean (Stream) Default: false |
{- "classification": {
- "classifications": [
- "string"
], - "search_type": 1
}, - "filters": { },
- "options": {
- "tracing": false
}, - "output": "text",
- "prompt": {
- "property1": "string",
- "property2": "string"
}, - "stream": false
}
null
Gets one pipeline object.
id required | string <uuid> (Id) |
{- "input_variables": [
- "string"
], - "placeholders": [
- {
- "name": "string",
- "params": { },
- "target": "string",
- "type": "query"
}
], - "prompt": [
- {
- "include": true,
- "role": "user",
- "template": "string"
}
]
}
Gets one pipeline object.
id required | string <uuid> (Id) |
{- "inputs": { },
- "prompt": [
- {
- "content": "string",
- "type": "string"
}
], - "traces": {
- "property1": [
- {
- "classification": "string",
- "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
], - "property2": [
- {
- "classification": "string",
- "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}
]
}
}
Add a new document to the pipeline knowledge base.
classification required | string (Classification) |
contents required | string (Contents) |
Metadata (object) or Metadata (null) (Metadata) | |
Name (string) or Name (null) (Name) | |
pipeline_id required | string <uuid> (Pipeline Id) |
Text Splitter Id (string) or Text Splitter Id (null) (Text Splitter Id) |
{- "classification": "string",
- "contents": "string",
- "metadata": { },
- "name": "string",
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
{- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
Get the status of a document previously submitted.
id required | string <uuid> (Id) |
{- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
Get one document.
id required | string <uuid> (Id) |
doc required | string <uuid> (Doc) |
{- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
Get the information for a document previously submitted.
id required | string <uuid> (Id) |
{- "data": [
- {
- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
id required | string <uuid> (Id) |
classification required | string (Classification) |
contents required | string (Contents) |
External Identifier (string) or External Identifier (null) (External Identifier) | |
Metadata (object) or Metadata (null) (Metadata) | |
Text Splitter Id (string) or Text Splitter Id (null) (Text Splitter Id) |
{- "classification": "string",
- "contents": "string",
- "external_identifier": "string",
- "metadata": { },
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
{- "classification": "string",
- "external_identifier": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "message": "string",
- "metadata": { },
- "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0",
- "status": "string",
- "text_splitter_id": "b51a7295-6cc4-4f67-8a6b-e88b60177cc8"
}
Find document fragments.
id required | string <uuid> (Id) |
ids required | Array of strings <uuid> (Ids) [ items <uuid > ] |
{- "ids": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
null
{- "data": [
- {
- "active": true,
- "description": "string",
- "expiration": "2019-08-24T14:15:22Z",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Get one API Key.
id required | string <uuid> (Id) |
{- "active": true,
- "description": "string",
- "expiration": "2019-08-24T14:15:22Z",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
Login route used to get the permissions for a particular object.
ids required | Array of strings <uuid> (Ids) [ items <uuid > ] |
type required | string (Type) |
{- "ids": [
- "497f6eca-6276-4993-bfeb-53cbbbba6f08"
], - "type": "string"
}
{- "property1": 1,
- "property2": 1
}
X-LLM-ID required | string <uuid> (X-Llm-Id) |
X-Pipeline-ID required | string <uuid> (X-Pipeline-Id) |
X-Agent-ID required | string <uuid> (X-Agent-Id) |
ClassificationSearchParameters (object) or Array of X-Document-Classification (strings) or X-Document-Classification (string) or X-Document-Classification (null) (X-Document-Classification) |
required | Array of ChatCompletionDeveloperMessageParam (object) or ChatCompletionSystemMessageParam (object) or ChatCompletionUserMessageParam (object) or ChatCompletionAssistantMessageParam (object) or ChatCompletionToolMessageParam (object) or ChatCompletionFunctionMessageParam (object) (Messages) |
required | Model (string) or Model (string) (Model) non-empty |
stream | boolean (Stream) Default: false |
Temperature (number) or Temperature (null) (Temperature) |
{- "messages": [
- {
- "content": "string",
- "name": "string",
- "role": "developer"
}
], - "model": "string",
- "stream": false,
- "temperature": 0
}
{- "choices": [
- {
- "finish_reason": "stop",
- "index": 0,
- "message": {
- "content": "The 2020 World Series was played in Texas at Globe Life Field in Arlington.",
- "role": "assistant"
}
}
], - "created": 1677664795,
- "id": "chatcmpl-7QyqpwdfhqwajicIEznoc6Q47XAyW",
- "model": "gpt-4o-mini",
- "object": "chat.completion",
- "usage": {
- "completion_tokens": 17,
- "prompt_tokens": 57,
- "total_tokens": 74
}
}
{- "data": [
- {
- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create an Taxonomy endpoint.
Description (string) or Description (null) (Description) | |
name required | string (Name) |
{- "description": "string",
- "name": "string"
}
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
Create an Taxonomy endpoint.
id required | string <uuid> (Id) |
Description (string) or Description (null) (Description) | |
name | string (Name) Default: "" |
{- "description": "string",
- "name": ""
}
{- "description": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "name": "string"
}
List all the available Taxonomies.
id required | string <uuid> (Id) |
count | boolean (Count) Default: false |
Limit (integer) or Limit (null) (Limit) | |
Offset (integer) or Offset (null) (Offset) | |
First (integer) or First (null) (First) | |
After (string) or After (null) (After) | |
Last (integer) or Last (null) (Last) | |
Before (string) or Before (null) (Before) | |
order | Array of strings (Order) Default: "" |
{- "data": [
- {
- "child": "string",
- "child_value": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "parent": "string",
- "parent_value": "string",
- "taxonomy_id": "315f9956-e4f8-40bc-b292-4f9898d47cf8"
}
], - "page_info": {
- "after": "string",
- "before": "string",
- "count": 0,
- "has_next": true,
- "has_prev": true
}, - "query_info": [
- {
- "property1": "string",
- "property2": "string"
}
]
}
Create Taxonomies entries.
id required | string <uuid> (Id) |
child required | string (Child) |
child_value required | string (Child Value) |
parent required | string (Parent) |
parent_value required | string (Parent Value) |
[- {
- "child": "string",
- "child_value": "string",
- "parent": "string",
- "parent_value": "string"
}
]
[- {
- "child": "string",
- "child_value": "string",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "parent": "string",
- "parent_value": "string",
- "taxonomy_id": "315f9956-e4f8-40bc-b292-4f9898d47cf8"
}
]