From b887675b4b3b3fcc19429cab8f73ff2bc6c69c37 Mon Sep 17 00:00:00 2001 From: Cyber MacGeddon Date: Tue, 21 Apr 2026 15:56:19 +0100 Subject: [PATCH] Update API specs --- specs/api/components/parameters/User.yaml | 8 ------- .../schemas/agent/AgentRequest.yaml | 9 -------- .../schemas/collection/CollectionRequest.yaml | 7 +------ .../collection/CollectionResponse.yaml | 5 ----- .../DocumentEmbeddingsQueryRequest.yaml | 5 ----- .../GraphEmbeddingsQueryRequest.yaml | 5 ----- .../RowEmbeddingsQueryRequest.yaml | 5 ----- .../schemas/knowledge/KnowledgeRequest.yaml | 17 +-------------- .../schemas/knowledge/KnowledgeResponse.yaml | 10 --------- .../schemas/librarian/LibrarianRequest.yaml | 5 ----- .../schemas/loading/DocumentLoadRequest.yaml | 5 ----- .../schemas/loading/TextLoadRequest.yaml | 5 ----- .../schemas/query/RowsQueryRequest.yaml | 5 ----- .../schemas/query/StructuredQueryRequest.yaml | 5 ----- .../schemas/query/TriplesQueryRequest.yaml | 5 ----- .../schemas/rag/DocumentRagRequest.yaml | 5 ----- .../schemas/rag/GraphRagRequest.yaml | 5 ----- specs/api/paths/collection-management.yaml | 21 +++++++------------ specs/api/paths/document-stream.yaml | 8 ------- specs/api/paths/export-core.yaml | 10 --------- specs/api/paths/flow/agent.yaml | 4 ---- specs/api/paths/flow/document-embeddings.yaml | 1 - specs/api/paths/flow/document-load.yaml | 2 -- specs/api/paths/flow/document-rag.yaml | 3 --- specs/api/paths/flow/graph-embeddings.yaml | 1 - specs/api/paths/flow/graph-rag.yaml | 2 -- specs/api/paths/flow/row-embeddings.yaml | 1 - specs/api/paths/flow/rows.yaml | 1 - specs/api/paths/flow/sparql-query.yaml | 5 ----- specs/api/paths/flow/structured-query.yaml | 2 -- specs/api/paths/flow/text-load.yaml | 2 -- specs/api/paths/flow/triples.yaml | 2 -- specs/api/paths/import-core.yaml | 10 --------- specs/api/paths/knowledge.yaml | 12 ++--------- .../requests/RowEmbeddingsRequest.yaml | 1 - .../messages/requests/SparqlQueryRequest.yaml | 5 ----- 36 files changed, 11 insertions(+), 193 deletions(-) delete mode 100644 specs/api/components/parameters/User.yaml diff --git a/specs/api/components/parameters/User.yaml b/specs/api/components/parameters/User.yaml deleted file mode 100644 index ad0657ca..00000000 --- a/specs/api/components/parameters/User.yaml +++ /dev/null @@ -1,8 +0,0 @@ -name: user -in: query -required: false -schema: - type: string - default: trustgraph -description: User identifier -example: alice diff --git a/specs/api/components/schemas/agent/AgentRequest.yaml b/specs/api/components/schemas/agent/AgentRequest.yaml index ddf2019a..26703402 100644 --- a/specs/api/components/schemas/agent/AgentRequest.yaml +++ b/specs/api/components/schemas/agent/AgentRequest.yaml @@ -43,15 +43,6 @@ properties: type: string description: Result of the action example: "Paris is the capital of France" - user: - type: string - description: User context for this step - example: alice - user: - type: string - description: User identifier for multi-tenancy - default: trustgraph - example: alice streaming: type: boolean description: Enable streaming response delivery diff --git a/specs/api/components/schemas/collection/CollectionRequest.yaml b/specs/api/components/schemas/collection/CollectionRequest.yaml index bf3ab7d4..e1dc8338 100644 --- a/specs/api/components/schemas/collection/CollectionRequest.yaml +++ b/specs/api/components/schemas/collection/CollectionRequest.yaml @@ -14,14 +14,9 @@ properties: - delete-collection description: | Collection operation: - - `list-collections`: List collections for user + - `list-collections`: List collections in workspace - `update-collection`: Create or update collection metadata - `delete-collection`: Delete collection - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection identifier (for update, delete) diff --git a/specs/api/components/schemas/collection/CollectionResponse.yaml b/specs/api/components/schemas/collection/CollectionResponse.yaml index f924cbf5..d65a7274 100644 --- a/specs/api/components/schemas/collection/CollectionResponse.yaml +++ b/specs/api/components/schemas/collection/CollectionResponse.yaml @@ -12,13 +12,8 @@ properties: items: type: object required: - - user - collection properties: - user: - type: string - description: User identifier - example: alice collection: type: string description: Collection identifier diff --git a/specs/api/components/schemas/embeddings-query/DocumentEmbeddingsQueryRequest.yaml b/specs/api/components/schemas/embeddings-query/DocumentEmbeddingsQueryRequest.yaml index f2d0aec2..b6e9dcb3 100644 --- a/specs/api/components/schemas/embeddings-query/DocumentEmbeddingsQueryRequest.yaml +++ b/specs/api/components/schemas/embeddings-query/DocumentEmbeddingsQueryRequest.yaml @@ -17,11 +17,6 @@ properties: minimum: 1 maximum: 1000 example: 20 - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection to search diff --git a/specs/api/components/schemas/embeddings-query/GraphEmbeddingsQueryRequest.yaml b/specs/api/components/schemas/embeddings-query/GraphEmbeddingsQueryRequest.yaml index 6cf60bbd..212eb3e2 100644 --- a/specs/api/components/schemas/embeddings-query/GraphEmbeddingsQueryRequest.yaml +++ b/specs/api/components/schemas/embeddings-query/GraphEmbeddingsQueryRequest.yaml @@ -17,11 +17,6 @@ properties: minimum: 1 maximum: 1000 example: 20 - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection to search diff --git a/specs/api/components/schemas/embeddings-query/RowEmbeddingsQueryRequest.yaml b/specs/api/components/schemas/embeddings-query/RowEmbeddingsQueryRequest.yaml index 916b4beb..51111a94 100644 --- a/specs/api/components/schemas/embeddings-query/RowEmbeddingsQueryRequest.yaml +++ b/specs/api/components/schemas/embeddings-query/RowEmbeddingsQueryRequest.yaml @@ -27,11 +27,6 @@ properties: minimum: 1 maximum: 1000 example: 20 - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection to search diff --git a/specs/api/components/schemas/knowledge/KnowledgeRequest.yaml b/specs/api/components/schemas/knowledge/KnowledgeRequest.yaml index 5c40e118..8be57dd6 100644 --- a/specs/api/components/schemas/knowledge/KnowledgeRequest.yaml +++ b/specs/api/components/schemas/knowledge/KnowledgeRequest.yaml @@ -18,17 +18,12 @@ properties: - unload-kg-core description: | Knowledge core operation: - - `list-kg-cores`: List knowledge cores for user + - `list-kg-cores`: List knowledge cores in workspace - `get-kg-core`: Get knowledge core by ID - `put-kg-core`: Store triples and/or embeddings - `delete-kg-core`: Delete knowledge core by ID - `load-kg-core`: Load knowledge core into flow - `unload-kg-core`: Unload knowledge core from flow - user: - type: string - description: User identifier (for list-kg-cores, put-kg-core, delete-kg-core) - default: trustgraph - example: alice id: type: string description: Knowledge core ID (for get, put, delete, load, unload) @@ -53,17 +48,12 @@ properties: type: object required: - id - - user - collection properties: id: type: string description: Knowledge core ID example: core-123 - user: - type: string - description: User identifier - example: alice collection: type: string description: Collection identifier @@ -89,17 +79,12 @@ properties: type: object required: - id - - user - collection properties: id: type: string description: Knowledge core ID example: core-123 - user: - type: string - description: User identifier - example: alice collection: type: string description: Collection identifier diff --git a/specs/api/components/schemas/knowledge/KnowledgeResponse.yaml b/specs/api/components/schemas/knowledge/KnowledgeResponse.yaml index 229233ca..b0e4d6bb 100644 --- a/specs/api/components/schemas/knowledge/KnowledgeResponse.yaml +++ b/specs/api/components/schemas/knowledge/KnowledgeResponse.yaml @@ -15,17 +15,12 @@ properties: type: object required: - id - - user - collection properties: id: type: string description: Knowledge core ID example: core-123 - user: - type: string - description: User identifier - example: alice collection: type: string description: Collection identifier @@ -48,17 +43,12 @@ properties: type: object required: - id - - user - collection properties: id: type: string description: Knowledge core ID example: core-123 - user: - type: string - description: User identifier - example: alice collection: type: string description: Collection identifier diff --git a/specs/api/components/schemas/librarian/LibrarianRequest.yaml b/specs/api/components/schemas/librarian/LibrarianRequest.yaml index eed999f0..25dca7e2 100644 --- a/specs/api/components/schemas/librarian/LibrarianRequest.yaml +++ b/specs/api/components/schemas/librarian/LibrarianRequest.yaml @@ -62,11 +62,6 @@ properties: description: Collection identifier default: default example: default - user: - type: string - description: User identifier - default: trustgraph - example: alice document-id: type: string description: Document identifier diff --git a/specs/api/components/schemas/loading/DocumentLoadRequest.yaml b/specs/api/components/schemas/loading/DocumentLoadRequest.yaml index 45bbe428..8d9a996f 100644 --- a/specs/api/components/schemas/loading/DocumentLoadRequest.yaml +++ b/specs/api/components/schemas/loading/DocumentLoadRequest.yaml @@ -15,11 +15,6 @@ properties: type: string description: Document identifier example: doc-456 - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection for document diff --git a/specs/api/components/schemas/loading/TextLoadRequest.yaml b/specs/api/components/schemas/loading/TextLoadRequest.yaml index 447308d4..57f7ecc3 100644 --- a/specs/api/components/schemas/loading/TextLoadRequest.yaml +++ b/specs/api/components/schemas/loading/TextLoadRequest.yaml @@ -14,11 +14,6 @@ properties: type: string description: Document identifier example: doc-123 - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection for document diff --git a/specs/api/components/schemas/query/RowsQueryRequest.yaml b/specs/api/components/schemas/query/RowsQueryRequest.yaml index 08f03ad3..611864e8 100644 --- a/specs/api/components/schemas/query/RowsQueryRequest.yaml +++ b/specs/api/components/schemas/query/RowsQueryRequest.yaml @@ -28,11 +28,6 @@ properties: type: string description: Operation name (for multi-operation documents) example: GetPerson - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection to query diff --git a/specs/api/components/schemas/query/StructuredQueryRequest.yaml b/specs/api/components/schemas/query/StructuredQueryRequest.yaml index ae564c0a..00bc75cb 100644 --- a/specs/api/components/schemas/query/StructuredQueryRequest.yaml +++ b/specs/api/components/schemas/query/StructuredQueryRequest.yaml @@ -10,11 +10,6 @@ properties: type: string description: Natural language question example: Who does Alice know that works in engineering? - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection to query diff --git a/specs/api/components/schemas/query/TriplesQueryRequest.yaml b/specs/api/components/schemas/query/TriplesQueryRequest.yaml index d49e0300..0efb1452 100644 --- a/specs/api/components/schemas/query/TriplesQueryRequest.yaml +++ b/specs/api/components/schemas/query/TriplesQueryRequest.yaml @@ -18,11 +18,6 @@ properties: minimum: 1 maximum: 100000 example: 100 - user: - type: string - description: User identifier - default: trustgraph - example: alice collection: type: string description: Collection to query diff --git a/specs/api/components/schemas/rag/DocumentRagRequest.yaml b/specs/api/components/schemas/rag/DocumentRagRequest.yaml index 97a9d2ff..92bc383b 100644 --- a/specs/api/components/schemas/rag/DocumentRagRequest.yaml +++ b/specs/api/components/schemas/rag/DocumentRagRequest.yaml @@ -9,11 +9,6 @@ properties: type: string description: User query or question example: What are the key findings in the research papers? - user: - type: string - description: User identifier for multi-tenancy - default: trustgraph - example: alice collection: type: string description: Collection to search within diff --git a/specs/api/components/schemas/rag/GraphRagRequest.yaml b/specs/api/components/schemas/rag/GraphRagRequest.yaml index 733dd7c1..754dcc92 100644 --- a/specs/api/components/schemas/rag/GraphRagRequest.yaml +++ b/specs/api/components/schemas/rag/GraphRagRequest.yaml @@ -9,11 +9,6 @@ properties: type: string description: User query or question example: What connections exist between quantum physics and computer science? - user: - type: string - description: User identifier for multi-tenancy - default: trustgraph - example: alice collection: type: string description: Collection to search within diff --git a/specs/api/paths/collection-management.yaml b/specs/api/paths/collection-management.yaml index 7dffd4e0..acd7ff9f 100644 --- a/specs/api/paths/collection-management.yaml +++ b/specs/api/paths/collection-management.yaml @@ -10,11 +10,10 @@ post: Collections are organizational units for grouping: - Documents in the librarian - Knowledge cores - - User data + - Workspace data Each collection has: - - **user**: Owner identifier - - **collection**: Unique collection ID + - **collection**: Unique collection ID (within the workspace) - **name**: Human-readable display name - **description**: Purpose and contents - **tags**: Labels for filtering and organization @@ -22,7 +21,7 @@ post: ## Operations ### list-collections - List all collections for a user. Optionally filter by tags and limit results. + List all collections in the workspace. Optionally filter by tags and limit results. Returns array of collection metadata. ### update-collection @@ -30,7 +29,7 @@ post: If it exists, metadata is updated. Allows setting name, description, and tags. ### delete-collection - Delete a collection by user and collection ID. This removes the metadata but + Delete a collection by collection ID. This removes the metadata but typically does not delete the associated data (documents, knowledge cores). operationId: collectionManagementService @@ -44,22 +43,19 @@ post: $ref: '../components/schemas/collection/CollectionRequest.yaml' examples: listCollections: - summary: List all collections for user + summary: List all collections in workspace value: operation: list-collections - user: alice listCollectionsFiltered: summary: List collections filtered by tags value: operation: list-collections - user: alice tag-filter: ["research", "AI"] limit: 50 updateCollection: summary: Create/update collection value: operation: update-collection - user: alice collection: research name: Research Papers description: Academic research papers on AI and ML @@ -69,7 +65,6 @@ post: summary: Delete collection value: operation: delete-collection - user: alice collection: research responses: '200': @@ -84,13 +79,11 @@ post: value: timestamp: "2024-01-15T10:30:00Z" collections: - - user: alice - collection: research + - collection: research name: Research Papers description: Academic research papers on AI and ML tags: ["research", "AI", "academic"] - - user: alice - collection: personal + - collection: personal name: Personal Documents description: Personal notes and documents tags: ["personal"] diff --git a/specs/api/paths/document-stream.yaml b/specs/api/paths/document-stream.yaml index 5f6a11a7..67aea0e1 100644 --- a/specs/api/paths/document-stream.yaml +++ b/specs/api/paths/document-stream.yaml @@ -8,7 +8,6 @@ get: ## Parameters - - `user`: User identifier (required) - `document-id`: Document IRI to retrieve (required) - `chunk-size`: Size of each response chunk in bytes (optional, default: 1MB) @@ -16,13 +15,6 @@ get: security: - bearerAuth: [] parameters: - - name: user - in: query - required: true - schema: - type: string - description: User identifier - example: trustgraph - name: document-id in: query required: true diff --git a/specs/api/paths/export-core.yaml b/specs/api/paths/export-core.yaml index e7dc06b0..7fddd024 100644 --- a/specs/api/paths/export-core.yaml +++ b/specs/api/paths/export-core.yaml @@ -23,7 +23,6 @@ get: "m": { // Metadata "i": "core-id", // Knowledge core ID "m": [...], // Metadata triples array - "u": "user", // User "c": "collection" // Collection }, "t": [...] // Triples array @@ -36,7 +35,6 @@ get: "m": { // Metadata "i": "core-id", "m": [...], - "u": "user", "c": "collection" }, "e": [ // Entities array @@ -56,7 +54,6 @@ get: ## Query Parameters - **id**: Knowledge core ID to export - - **user**: User identifier ## Streaming @@ -86,13 +83,6 @@ get: type: string description: Knowledge core ID to export example: core-123 - - name: user - in: query - required: true - schema: - type: string - description: User identifier - example: alice responses: '200': description: Export stream diff --git a/specs/api/paths/flow/agent.yaml b/specs/api/paths/flow/agent.yaml index 2cecf89c..a38b6a82 100644 --- a/specs/api/paths/flow/agent.yaml +++ b/specs/api/paths/flow/agent.yaml @@ -69,25 +69,21 @@ post: summary: Simple question value: question: What is the capital of France? - user: alice streamingQuestion: summary: Question with streaming enabled value: question: Explain quantum computing - user: alice streaming: true conversationWithHistory: summary: Multi-turn conversation value: question: And what about its population? - user: alice history: - thought: User is asking about the capital of France action: search arguments: query: "capital of France" observation: "Paris is the capital of France" - user: alice responses: '200': description: Successful response diff --git a/specs/api/paths/flow/document-embeddings.yaml b/specs/api/paths/flow/document-embeddings.yaml index dbab2f92..ba7344fe 100644 --- a/specs/api/paths/flow/document-embeddings.yaml +++ b/specs/api/paths/flow/document-embeddings.yaml @@ -75,7 +75,6 @@ post: value: vectors: [0.023, -0.142, 0.089, 0.234, -0.067, 0.156, 0.201, -0.178] limit: 10 - user: alice collection: research largeQuery: summary: Larger result set diff --git a/specs/api/paths/flow/document-load.yaml b/specs/api/paths/flow/document-load.yaml index 09ddc09f..97ca3f3f 100644 --- a/specs/api/paths/flow/document-load.yaml +++ b/specs/api/paths/flow/document-load.yaml @@ -88,14 +88,12 @@ post: value: data: JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PmVuZG9iagoyIDAgb2JqCjw8L1R5cGUvUGFnZXMvS2lkc1szIDAgUl0vQ291bnQgMT4+ZW5kb2JqCg== id: doc-789 - user: alice collection: research withMetadata: summary: Load with metadata value: data: JVBERi0xLjQKJeLjz9MK... id: doc-101112 - user: bob collection: papers metadata: - s: {v: "doc-101112", e: false} diff --git a/specs/api/paths/flow/document-rag.yaml b/specs/api/paths/flow/document-rag.yaml index f91bfc27..891868a5 100644 --- a/specs/api/paths/flow/document-rag.yaml +++ b/specs/api/paths/flow/document-rag.yaml @@ -40,7 +40,6 @@ post: - Higher = more context but slower - Lower = faster but may miss relevant info - **collection**: Target specific document collection - - **user**: Multi-tenant isolation operationId: documentRagService security: @@ -64,13 +63,11 @@ post: summary: Basic document query value: query: What are the key findings in the research papers? - user: alice collection: research streamingQuery: summary: Streaming query value: query: Summarize the main conclusions - user: alice collection: research doc-limit: 15 streaming: true diff --git a/specs/api/paths/flow/graph-embeddings.yaml b/specs/api/paths/flow/graph-embeddings.yaml index 277659de..16c1f4b3 100644 --- a/specs/api/paths/flow/graph-embeddings.yaml +++ b/specs/api/paths/flow/graph-embeddings.yaml @@ -66,7 +66,6 @@ post: value: vectors: [0.023, -0.142, 0.089, 0.234, -0.067, 0.156, 0.201, -0.178] limit: 10 - user: alice collection: research largeQuery: summary: Larger result set diff --git a/specs/api/paths/flow/graph-rag.yaml b/specs/api/paths/flow/graph-rag.yaml index b3f087c6..e9ffadea 100644 --- a/specs/api/paths/flow/graph-rag.yaml +++ b/specs/api/paths/flow/graph-rag.yaml @@ -77,13 +77,11 @@ post: summary: Basic graph query value: query: What connections exist between quantum physics and computer science? - user: alice collection: research streamingQuery: summary: Streaming query with custom limits value: query: Trace the historical development of AI from Turing to modern LLMs - user: alice collection: research entity-limit: 40 triple-limit: 25 diff --git a/specs/api/paths/flow/row-embeddings.yaml b/specs/api/paths/flow/row-embeddings.yaml index 05837c06..9f9f5c4f 100644 --- a/specs/api/paths/flow/row-embeddings.yaml +++ b/specs/api/paths/flow/row-embeddings.yaml @@ -62,7 +62,6 @@ post: vectors: [0.023, -0.142, 0.089, 0.234, -0.067, 0.156, 0.201, -0.178] schema_name: customers limit: 10 - user: alice collection: sales filteredQuery: summary: Search specific index diff --git a/specs/api/paths/flow/rows.yaml b/specs/api/paths/flow/rows.yaml index d648c9db..e8b1573a 100644 --- a/specs/api/paths/flow/rows.yaml +++ b/specs/api/paths/flow/rows.yaml @@ -89,7 +89,6 @@ post: email } } - user: alice collection: research queryWithVariables: summary: Query with variables diff --git a/specs/api/paths/flow/sparql-query.yaml b/specs/api/paths/flow/sparql-query.yaml index 2f343488..b7970bd0 100644 --- a/specs/api/paths/flow/sparql-query.yaml +++ b/specs/api/paths/flow/sparql-query.yaml @@ -61,10 +61,6 @@ post: query: type: string description: SPARQL 1.1 query string - user: - type: string - default: trustgraph - description: User/keyspace identifier collection: type: string default: default @@ -78,7 +74,6 @@ post: summary: SELECT query value: query: "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10" - user: trustgraph collection: default askQuery: summary: ASK query diff --git a/specs/api/paths/flow/structured-query.yaml b/specs/api/paths/flow/structured-query.yaml index 6d4dfe87..7e963b5b 100644 --- a/specs/api/paths/flow/structured-query.yaml +++ b/specs/api/paths/flow/structured-query.yaml @@ -79,13 +79,11 @@ post: summary: Simple relationship question value: question: Who does Alice know? - user: alice collection: research complexQuestion: summary: Complex multi-hop question value: question: What companies employ engineers that Bob collaborates with? - user: bob collection: work filterQuestion: summary: Question with implicit filters diff --git a/specs/api/paths/flow/text-load.yaml b/specs/api/paths/flow/text-load.yaml index 08bfe47b..b97d249f 100644 --- a/specs/api/paths/flow/text-load.yaml +++ b/specs/api/paths/flow/text-load.yaml @@ -87,14 +87,12 @@ post: value: text: This is the document text... id: doc-123 - user: alice collection: research withMetadata: summary: Load with RDF metadata using base64 text value: text: UXVhbnR1bSBjb21wdXRpbmcgdXNlcyBxdWFudHVtIG1lY2hhbmljcyBwcmluY2lwbGVzLi4u id: doc-456 - user: alice collection: research metadata: - s: {v: "doc-456", e: false} diff --git a/specs/api/paths/flow/triples.yaml b/specs/api/paths/flow/triples.yaml index 5557ea5a..9683d9f7 100644 --- a/specs/api/paths/flow/triples.yaml +++ b/specs/api/paths/flow/triples.yaml @@ -81,7 +81,6 @@ post: s: v: https://example.com/person/alice e: true - user: alice collection: research limit: 100 allInstancesOfType: @@ -100,7 +99,6 @@ post: p: v: https://example.com/knows e: true - user: alice limit: 200 responses: '200': diff --git a/specs/api/paths/import-core.yaml b/specs/api/paths/import-core.yaml index 38c99bf0..633f5477 100644 --- a/specs/api/paths/import-core.yaml +++ b/specs/api/paths/import-core.yaml @@ -23,7 +23,6 @@ post: "m": { // Metadata "i": "core-id", // Knowledge core ID "m": [...], // Metadata triples array - "u": "user", // User "c": "collection" // Collection }, "t": [...] // Triples array @@ -36,7 +35,6 @@ post: "m": { // Metadata "i": "core-id", "m": [...], - "u": "user", "c": "collection" }, "e": [ // Entities array @@ -51,7 +49,6 @@ post: ## Query Parameters - **id**: Knowledge core ID - - **user**: User identifier ## Streaming @@ -77,13 +74,6 @@ post: type: string description: Knowledge core ID to import example: core-123 - - name: user - in: query - required: true - schema: - type: string - description: User identifier - example: alice requestBody: required: true content: diff --git a/specs/api/paths/knowledge.yaml b/specs/api/paths/knowledge.yaml index 71bba496..0fe1976f 100644 --- a/specs/api/paths/knowledge.yaml +++ b/specs/api/paths/knowledge.yaml @@ -12,12 +12,12 @@ post: - **Graph Embeddings**: Vector embeddings for entities - **Metadata**: Descriptive information about the knowledge - Each core has an ID, user, and collection for organization. + Each core has an ID and collection for organization (within the workspace). ## Operations ### list-kg-cores - List all knowledge cores for a user. Returns array of core IDs. + List all knowledge cores in the workspace. Returns array of core IDs. ### get-kg-core Retrieve a knowledge core by ID. Returns triples and/or graph embeddings. @@ -58,7 +58,6 @@ post: summary: List knowledge cores value: operation: list-kg-cores - user: alice getKnowledgeCore: summary: Get knowledge core value: @@ -71,7 +70,6 @@ post: triples: metadata: id: core-123 - user: alice collection: default metadata: - s: {v: "https://example.com/core-123", e: true} @@ -91,7 +89,6 @@ post: graph-embeddings: metadata: id: core-123 - user: alice collection: default metadata: [] entities: @@ -106,7 +103,6 @@ post: triples: metadata: id: core-456 - user: bob collection: research metadata: [] triples: @@ -116,7 +112,6 @@ post: graph-embeddings: metadata: id: core-456 - user: bob collection: research metadata: [] entities: @@ -127,7 +122,6 @@ post: value: operation: delete-kg-core id: core-123 - user: alice loadKnowledgeCore: summary: Load core into flow value: @@ -161,7 +155,6 @@ post: triples: metadata: id: core-123 - user: alice collection: default metadata: - s: {v: "https://example.com/core-123", e: true} @@ -177,7 +170,6 @@ post: graph-embeddings: metadata: id: core-123 - user: alice collection: default metadata: [] entities: diff --git a/specs/websocket/components/messages/requests/RowEmbeddingsRequest.yaml b/specs/websocket/components/messages/requests/RowEmbeddingsRequest.yaml index 8010417d..efe6412b 100644 --- a/specs/websocket/components/messages/requests/RowEmbeddingsRequest.yaml +++ b/specs/websocket/components/messages/requests/RowEmbeddingsRequest.yaml @@ -26,5 +26,4 @@ examples: vectors: [0.023, -0.142, 0.089, 0.234] schema_name: customers limit: 10 - user: trustgraph collection: default diff --git a/specs/websocket/components/messages/requests/SparqlQueryRequest.yaml b/specs/websocket/components/messages/requests/SparqlQueryRequest.yaml index 6954b539..bc32f33a 100644 --- a/specs/websocket/components/messages/requests/SparqlQueryRequest.yaml +++ b/specs/websocket/components/messages/requests/SparqlQueryRequest.yaml @@ -24,10 +24,6 @@ properties: query: type: string description: SPARQL 1.1 query string - user: - type: string - default: trustgraph - description: User/keyspace identifier collection: type: string default: default @@ -42,5 +38,4 @@ examples: flow: my-flow request: query: "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10" - user: trustgraph collection: default