API Reference | Devgraph Documentation

Introduction

The Devgraph AI ontology engine and entity management API

Bulk Invite Environment Users

Bulk invite multiple users to an environment

Check Entitlement

Check a specific entitlement for the authenticated user

Clean up orphaned entities

Delete all entities marked as orphans. Requires 'delete:entities' permission.

Post Chat Completions

Create a chat completion with optional streaming response

Create Chat Suggestion

Create a new chat suggestion for the environment

Post Chat Title

Generate a title for a chat based on the first message

Create Configured Provider

Create a new configured discovery provider.

Create multiple entities in bulk

Creates multiple entities in a single request with concurrent processing. Provides detailed success/failure information for each entity. Requires 'create:entities' permission.

Create Entity Definition

Create a new entity definition with schema and storage configuration

Create Entity Relation

Create a relation between two entities in the knowledge graph

Create multiple entity relations in bulk

Creates multiple entity relations in a single request. Provides detailed success/failure information for each relation. Requires 'create:entityrelations' permission.

Create a resource based on an entity definition

Creates a new entity based on the specified group, version, namespace, and kind. Requires 'create:entities' permission.

Create Environment User

Create a new environment user by adding them to the Clerk organization

Create Environment

Create a new environment with associated Clerk organization

Create Mcp Tool Association

Create an association between an MCP tool and an entity definition

Create Model

Create a new AI model configuration with provider details in the environment

Create Modelprovider

Create a new model provider configuration

Create Oauth Service

Create a new OAuth service configuration

Create Prompt

Create a new prompt template in the environment

Create Token

Create a new API token for the authenticated user

Delete Chat Suggestion

Delete a chat suggestion owned by the user

Delete an entity definition

Delete an entity definition, all its versions, and optionally mark associated entities as orphans

Delete a relation between entities

Deletes a specific relation between two entities. Requires 'delete:entityrelations' permission.

Delete a specific entity

Deletes a specific entity from the ontology. Requires 'delete:entities' permission.

Delete Environment Invitation

Revoke a pending invitation to an environment

Delete Environment

Delete an environment with grace period for recovery

Delete Mcpendpoint

Delete a specific MCP endpoint configuration by ID

Delete Model

Delete an AI model configuration by name

Delete Modelprovider

Delete a specific model provider configuration by ID

Exchange Code For Token

Exchange an authorization code for an access token

Get All Provider Versions

Get version support info for all available provider types.

Get Chat Messages

Retrieve all messages from a specific chat session

Get Chats

List all chat sessions for the authenticated user

Get Configured Provider

Get a specific configured discovery provider.

Get Deprecated Provider Configs

Get all provider instances using deprecated config versions.

Get Discovery Provider Config Schema

Get the configuration schema for a specific discovery provider type

Query entities with optional field selectors

Retrieves entities from the ontology, optionally filtered by field selectors. Field selectors use dot notation for nested properties (e.g., 'spec.metadata.owner=team-a'). Requires 'read:entities' permission.

Get Entitlements

Get all entitlements and current usage for the authenticated user

Retrieve a specific entity by UID with its relations

Fetches a specific entity by its unique identifier (UID), including related entities and relations. Requires 'read:entities' permission.

Retrieve all entity definitions with their versions

Fetches a list of all entity definitions with versions, ordered by group and kind

Get Entity Tools

Get all MCP tools associated with an entity definition

Retrieve a specific entity by name with its relations

Fetches a specific entity based on group, version, namespace, plural, and name, including related entities and relations. Requires 'read:entities' permission.