naftiko: 1.0.0-alpha2 info: label: Weaviate REST API — schema description: 'Weaviate REST API — schema. 22 operations. Lead operation: Weaviate List Aliases. Self-contained Naftiko capability covering one Weaviate business surface.' tags: - Weaviate - schema created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: WEAVIATE_API_KEY: WEAVIATE_API_KEY capability: consumes: - type: http namespace: weaviate-schema baseUri: http://localhost:8080 description: Weaviate REST API — schema business capability. Self-contained, no shared references. resources: - name: aliases path: /aliases operations: - name: aliasesget method: GET description: Weaviate List Aliases outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: class in: query type: string description: Optional filter to retrieve aliases for a specific collection (class) only. If not provided, returns all aliases. - name: aliasescreate method: POST description: Weaviate Create A New Alias outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: aliases-aliasName path: /aliases/{aliasName} operations: - name: aliasesgetalias method: GET description: Weaviate Get An Alias outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: aliasName in: path type: string required: true - name: aliasesupdate method: PUT description: Weaviate Update An Alias outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: aliasName in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: aliasesdelete method: DELETE description: Weaviate Delete An Alias outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: aliasName in: path type: string required: true - name: schema path: /schema operations: - name: schemadump method: GET description: Weaviate Get All Collection Definitions outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: consistency in: header type: boolean description: If true, the request is proxied to the cluster leader to ensure strong schema consistency. Default is true. - name: schemaobjectscreate method: POST description: Weaviate Create A New Collection outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: schema-className path: /schema/{className} operations: - name: schemaobjectsget method: GET description: Weaviate Get A Single Collection outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) to retrieve. required: true - name: consistency in: header type: boolean description: If true, the request is proxied to the cluster leader to ensure strong schema consistency. Default is true. - name: schemaobjectsdelete method: DELETE description: Weaviate Delete A Collection (And All Associated Data) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) to delete. required: true - name: schemaobjectsupdate method: PUT description: Weaviate Update Collection Definition outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) to update. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: schema-className-properties path: /schema/{className}/properties operations: - name: schemaobjectspropertiesadd method: POST description: Weaviate Add A Property To A Collection outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) to add the property to. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: schema-className-properties-propertyName-index-indexName path: /schema/{className}/properties/{propertyName}/index/{indexName} operations: - name: schemaobjectspropertiesdelete method: DELETE description: Weaviate Delete A Property'S Inverted Index outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) containing the property. required: true - name: propertyName in: path type: string description: The name of the property whose inverted index should be deleted. required: true - name: indexName in: path type: string description: The name of the inverted index to delete from the property. required: true - name: schema-className-properties-propertyName-tokenize path: /schema/{className}/properties/{propertyName}/tokenize operations: - name: schemaobjectspropertiestokenize method: POST description: Weaviate Tokenize Text Using A Property'S Configuration outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) containing the property. required: true - name: propertyName in: path type: string description: The name of the property whose tokenization configuration should be used. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: schema-className-shards path: /schema/{className}/shards operations: - name: schemaobjectsshardsget method: GET description: Weaviate Get The Shards Status Of A Collection outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) whose shards to query. required: true - name: tenant in: query type: string description: The name of the tenant for which to retrieve shard statuses (only applicable for multi-tenant collections). - name: schema-className-shards-shardName path: /schema/{className}/shards/{shardName} operations: - name: schemaobjectsshardsupdate method: PUT description: Weaviate Update A Shard Status outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) containing the shard. required: true - name: shardName in: path type: string description: The name of the shard to update. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: schema-className-tenants path: /schema/{className}/tenants operations: - name: tenantscreate method: POST description: Weaviate Create A New Tenant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the multi-tenant enabled collection (class). required: true - name: body in: body type: object description: Request body (JSON). required: false - name: tenantsupdate method: PUT description: Weaviate Update A Tenant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) containing the tenants. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: tenantsdelete method: DELETE description: Weaviate Delete Tenants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) from which to delete tenants. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: tenantsget method: GET description: Weaviate Get The List Of Tenants outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) whose tenants to list. required: true - name: consistency in: header type: boolean description: If true, the request is proxied to the cluster leader to ensure strong schema consistency. Default is true. - name: schema-className-tenants-tenantName path: /schema/{className}/tenants/{tenantName} operations: - name: tenantexists method: HEAD description: Weaviate Check If A Tenant Exists outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) to check within. required: true - name: tenantName in: path type: string description: The name of the tenant to check for. required: true - name: consistency in: header type: boolean description: If true, the request is proxied to the cluster leader to ensure strong schema consistency. Default is true. - name: tenantsgetone method: GET description: Weaviate Get A Specific Tenant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) containing the tenant. required: true - name: tenantName in: path type: string description: The name of the tenant to retrieve. required: true - name: consistency in: header type: boolean description: If true, the request is proxied to the cluster leader to ensure strong schema consistency. Default is true. - name: schema-className-vectors-vectorIndexName-index path: /schema/{className}/vectors/{vectorIndexName}/index operations: - name: schemaobjectsvectorsdelete method: DELETE description: Weaviate Delete A Collection'S Vector Index. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: className in: path type: string description: The name of the collection (class) containing the property. required: true - name: vectorIndexName in: path type: string description: The name of the vector index. required: true authentication: type: bearer token: '{{env.WEAVIATE_API_KEY}}' exposes: - type: rest namespace: weaviate-schema-rest port: 8080 description: REST adapter for Weaviate REST API — schema. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/aliases name: aliases description: REST surface for aliases. operations: - method: GET name: aliasesget description: Weaviate List Aliases call: weaviate-schema.aliasesget with: class: rest.class outputParameters: - type: object mapping: $. - method: POST name: aliasescreate description: Weaviate Create A New Alias call: weaviate-schema.aliasescreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/aliases/{aliasname} name: aliases-aliasname description: REST surface for aliases-aliasName. operations: - method: GET name: aliasesgetalias description: Weaviate Get An Alias call: weaviate-schema.aliasesgetalias with: aliasName: rest.aliasName outputParameters: - type: object mapping: $. - method: PUT name: aliasesupdate description: Weaviate Update An Alias call: weaviate-schema.aliasesupdate with: aliasName: rest.aliasName body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: aliasesdelete description: Weaviate Delete An Alias call: weaviate-schema.aliasesdelete with: aliasName: rest.aliasName outputParameters: - type: object mapping: $. - path: /v1/schema name: schema description: REST surface for schema. operations: - method: GET name: schemadump description: Weaviate Get All Collection Definitions call: weaviate-schema.schemadump with: consistency: rest.consistency outputParameters: - type: object mapping: $. - method: POST name: schemaobjectscreate description: Weaviate Create A New Collection call: weaviate-schema.schemaobjectscreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/schema/{classname} name: schema-classname description: REST surface for schema-className. operations: - method: GET name: schemaobjectsget description: Weaviate Get A Single Collection call: weaviate-schema.schemaobjectsget with: className: rest.className consistency: rest.consistency outputParameters: - type: object mapping: $. - method: DELETE name: schemaobjectsdelete description: Weaviate Delete A Collection (And All Associated Data) call: weaviate-schema.schemaobjectsdelete with: className: rest.className outputParameters: - type: object mapping: $. - method: PUT name: schemaobjectsupdate description: Weaviate Update Collection Definition call: weaviate-schema.schemaobjectsupdate with: className: rest.className body: rest.body outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/properties name: schema-classname-properties description: REST surface for schema-className-properties. operations: - method: POST name: schemaobjectspropertiesadd description: Weaviate Add A Property To A Collection call: weaviate-schema.schemaobjectspropertiesadd with: className: rest.className body: rest.body outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/properties/{propertyname}/index/{indexname} name: schema-classname-properties-propertyname-index-indexname description: REST surface for schema-className-properties-propertyName-index-indexName. operations: - method: DELETE name: schemaobjectspropertiesdelete description: Weaviate Delete A Property'S Inverted Index call: weaviate-schema.schemaobjectspropertiesdelete with: className: rest.className propertyName: rest.propertyName indexName: rest.indexName outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/properties/{propertyname}/tokenize name: schema-classname-properties-propertyname-tokenize description: REST surface for schema-className-properties-propertyName-tokenize. operations: - method: POST name: schemaobjectspropertiestokenize description: Weaviate Tokenize Text Using A Property'S Configuration call: weaviate-schema.schemaobjectspropertiestokenize with: className: rest.className propertyName: rest.propertyName body: rest.body outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/shards name: schema-classname-shards description: REST surface for schema-className-shards. operations: - method: GET name: schemaobjectsshardsget description: Weaviate Get The Shards Status Of A Collection call: weaviate-schema.schemaobjectsshardsget with: className: rest.className tenant: rest.tenant outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/shards/{shardname} name: schema-classname-shards-shardname description: REST surface for schema-className-shards-shardName. operations: - method: PUT name: schemaobjectsshardsupdate description: Weaviate Update A Shard Status call: weaviate-schema.schemaobjectsshardsupdate with: className: rest.className shardName: rest.shardName body: rest.body outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/tenants name: schema-classname-tenants description: REST surface for schema-className-tenants. operations: - method: POST name: tenantscreate description: Weaviate Create A New Tenant call: weaviate-schema.tenantscreate with: className: rest.className body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: tenantsupdate description: Weaviate Update A Tenant call: weaviate-schema.tenantsupdate with: className: rest.className body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: tenantsdelete description: Weaviate Delete Tenants call: weaviate-schema.tenantsdelete with: className: rest.className body: rest.body outputParameters: - type: object mapping: $. - method: GET name: tenantsget description: Weaviate Get The List Of Tenants call: weaviate-schema.tenantsget with: className: rest.className consistency: rest.consistency outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/tenants/{tenantname} name: schema-classname-tenants-tenantname description: REST surface for schema-className-tenants-tenantName. operations: - method: HEAD name: tenantexists description: Weaviate Check If A Tenant Exists call: weaviate-schema.tenantexists with: className: rest.className tenantName: rest.tenantName consistency: rest.consistency outputParameters: - type: object mapping: $. - method: GET name: tenantsgetone description: Weaviate Get A Specific Tenant call: weaviate-schema.tenantsgetone with: className: rest.className tenantName: rest.tenantName consistency: rest.consistency outputParameters: - type: object mapping: $. - path: /v1/schema/{classname}/vectors/{vectorindexname}/index name: schema-classname-vectors-vectorindexname-index description: REST surface for schema-className-vectors-vectorIndexName-index. operations: - method: DELETE name: schemaobjectsvectorsdelete description: Weaviate Delete A Collection'S Vector Index. call: weaviate-schema.schemaobjectsvectorsdelete with: className: rest.className vectorIndexName: rest.vectorIndexName outputParameters: - type: object mapping: $. - type: mcp namespace: weaviate-schema-mcp port: 9090 transport: http description: MCP adapter for Weaviate REST API — schema. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: weaviate-list-aliases description: Weaviate List Aliases hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.aliasesget with: class: tools.class outputParameters: - type: object mapping: $. - name: weaviate-create-new-alias description: Weaviate Create A New Alias hints: readOnly: false destructive: false idempotent: false call: weaviate-schema.aliasescreate with: body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-get-alias description: Weaviate Get An Alias hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.aliasesgetalias with: aliasName: tools.aliasName outputParameters: - type: object mapping: $. - name: weaviate-update-alias description: Weaviate Update An Alias hints: readOnly: false destructive: false idempotent: true call: weaviate-schema.aliasesupdate with: aliasName: tools.aliasName body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-delete-alias description: Weaviate Delete An Alias hints: readOnly: false destructive: true idempotent: true call: weaviate-schema.aliasesdelete with: aliasName: tools.aliasName outputParameters: - type: object mapping: $. - name: weaviate-get-all-collection-definitions description: Weaviate Get All Collection Definitions hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.schemadump with: consistency: tools.consistency outputParameters: - type: object mapping: $. - name: weaviate-create-new-collection description: Weaviate Create A New Collection hints: readOnly: false destructive: false idempotent: false call: weaviate-schema.schemaobjectscreate with: body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-get-single-collection description: Weaviate Get A Single Collection hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.schemaobjectsget with: className: tools.className consistency: tools.consistency outputParameters: - type: object mapping: $. - name: weaviate-delete-collection-and-all description: Weaviate Delete A Collection (And All Associated Data) hints: readOnly: false destructive: true idempotent: true call: weaviate-schema.schemaobjectsdelete with: className: tools.className outputParameters: - type: object mapping: $. - name: weaviate-update-collection-definition description: Weaviate Update Collection Definition hints: readOnly: false destructive: false idempotent: true call: weaviate-schema.schemaobjectsupdate with: className: tools.className body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-add-property-collection description: Weaviate Add A Property To A Collection hints: readOnly: false destructive: false idempotent: false call: weaviate-schema.schemaobjectspropertiesadd with: className: tools.className body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-delete-property-s-inverted-index description: Weaviate Delete A Property'S Inverted Index hints: readOnly: false destructive: true idempotent: true call: weaviate-schema.schemaobjectspropertiesdelete with: className: tools.className propertyName: tools.propertyName indexName: tools.indexName outputParameters: - type: object mapping: $. - name: weaviate-tokenize-text-using-property-s description: Weaviate Tokenize Text Using A Property'S Configuration hints: readOnly: false destructive: false idempotent: false call: weaviate-schema.schemaobjectspropertiestokenize with: className: tools.className propertyName: tools.propertyName body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-get-shards-status-collection description: Weaviate Get The Shards Status Of A Collection hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.schemaobjectsshardsget with: className: tools.className tenant: tools.tenant outputParameters: - type: object mapping: $. - name: weaviate-update-shard-status description: Weaviate Update A Shard Status hints: readOnly: false destructive: false idempotent: true call: weaviate-schema.schemaobjectsshardsupdate with: className: tools.className shardName: tools.shardName body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-create-new-tenant description: Weaviate Create A New Tenant hints: readOnly: false destructive: false idempotent: false call: weaviate-schema.tenantscreate with: className: tools.className body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-update-tenant description: Weaviate Update A Tenant hints: readOnly: false destructive: false idempotent: true call: weaviate-schema.tenantsupdate with: className: tools.className body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-delete-tenants description: Weaviate Delete Tenants hints: readOnly: false destructive: true idempotent: true call: weaviate-schema.tenantsdelete with: className: tools.className body: tools.body outputParameters: - type: object mapping: $. - name: weaviate-get-list-tenants description: Weaviate Get The List Of Tenants hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.tenantsget with: className: tools.className consistency: tools.consistency outputParameters: - type: object mapping: $. - name: weaviate-check-if-tenant-exists description: Weaviate Check If A Tenant Exists hints: readOnly: false destructive: false idempotent: false call: weaviate-schema.tenantexists with: className: tools.className tenantName: tools.tenantName consistency: tools.consistency outputParameters: - type: object mapping: $. - name: weaviate-get-specific-tenant description: Weaviate Get A Specific Tenant hints: readOnly: true destructive: false idempotent: true call: weaviate-schema.tenantsgetone with: className: tools.className tenantName: tools.tenantName consistency: tools.consistency outputParameters: - type: object mapping: $. - name: weaviate-delete-collection-s-vector-index description: Weaviate Delete A Collection'S Vector Index. hints: readOnly: false destructive: true idempotent: true call: weaviate-schema.schemaobjectsvectorsdelete with: className: tools.className vectorIndexName: tools.vectorIndexName outputParameters: - type: object mapping: $.