Application Ontology Service REST API
Use the Application Ontology Service REST API to interface with the Application Ontology Service by making HTTP requests to the endpoints in the table below. All paths are relative to /aosvc/api/v1.
Note: Click any endpoint to go to its API reference page.
| Endpoint | Request scope |
|---|---|
| /ontologies | Create and manage the application ontology for a namespace, control its edit lock, and move it through drafts, versions, and promotion. |
| /ontologies/{ontologyId}/classes | Create, update, retrieve, and delete the classes of an ontology, and read a class's effective schema. |
| /ontologies/{ontologyId}/relationships, /rules | Declare which classes can relate to each other, and add rules to an ontology. |
| /ontologies/{ontologyId}/constraints | Add the rules that individuals of a class must meet. |
| /ontologies/{ontologyId}/actions | Create and manage actions that state machine transitions run. |
| /ontologies/{ontologyId}/state-machines | Create and manage state machines, fire events against individuals, and check the actions that transitions ran. |
| /classes/{classId}/mapping | Bind a class to the Item Service collection that stores its individuals. |
| /classes/{classId}/individuals | Create, read, search, update, and delete individuals of a class. |
| /classes/{classId}/individuals/relationships | Add, replace, read, and remove relationships between individuals. |
| /classes/{classId}/individuals/readings | Record and read time-stamped readings for individuals of a telemetry class. |
| /ontologies/{ontologyId}/import, /async-tasks | Import individuals of many classes in one request, and poll queued tasks. |
| /permissions | Read, grant, and revoke access to ontologies and to the individuals of ontology classes. |
| /ontologies/{ontologyId}/impact-analysis-reports | See what would change if a version of an ontology replaced the live version. |
| /reasoner, /source/owl | Run reasoning over data in the request, and preview OWL documents. |
| /ontologies/{ontologyId}/ai, /classes/{classId}/mcp-config | Use the AI Service to help build an ontology, and declare a class as an MCP tool. |