For Agents
Create and manage CodeGPT agents, attach documents for RAG, and run chat completions against them using a JWT Bearer token.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CodeGPT API Beta, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with CodeGPT API Beta API.
Create a CodeGPT agent with a system prompt and model via POST /api/v1/agent
Attach grounding documents to an agent through PATCH /api/v1/agent/{id}/documents
Run an OpenAI-compatible chat completion against a CodeGPT agent via POST /api/v1/chat/completions
Upload, list, retrieve, and delete documents that back agent retrieval through /api/v1/document endpoints
GET STARTED
Use for: Create a new CodeGPT agent for our payments codebase, I want to upload a markdown document to a CodeGPT agent for grounding, Run a chat completion against my CodeGPT agent, List all CodeGPT agents in my workspace
Not supported: Does not handle billing, model fine-tuning, or workspace administration — use for agent, document, and chat completion operations on CodeGPT only.
Jentic publishes the only available OpenAPI document for CodeGPT API Beta, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for CodeGPT API Beta, keeping it validated and agent-ready. CodeGPT is a developer-focused AI platform for building and running coding-oriented agents, complete with a marketplace of pre-built agents, a chat completions endpoint, and document grounding for retrieval-augmented generation. The v2 beta API exposes 18 endpoints over api.codegpt.co covering user profile management, agent CRUD, agent image and document attachments, OpenAI-compatible chat completions, and document storage with metadata. Authentication is a JWT Bearer token, and the spec is explicitly marked beta and subject to change.
Update agent metadata, avatar, or backing documents without redeploying the agent
List the agents a user has marked as marketplace favourites for quick reuse
Update document metadata to drive filtered retrieval at chat time
Patterns agents use CodeGPT API Beta API for, with concrete tasks.
★ Custom Coding Assistant Per Repository
Stand up a dedicated coding assistant for each repository by creating a CodeGPT agent and attaching the repo's docs as grounding documents. The agent is then callable through POST /api/v1/chat/completions, giving developers an in-IDE assistant that knows the codebase. Replaces generic chat models that hallucinate when asked about internal APIs.
Call POST /api/v1/agent to create an agent named 'payments-helper', then PATCH /api/v1/agent/{id}/documents to attach the payments service README and architecture docs
RAG-Backed Internal Knowledge Bot
Use CodeGPT's document store as the retrieval layer for an internal knowledge bot. Engineers POST documents to /api/v1/document, attach them to a single 'knowledge' agent, and call chat completions to answer questions grounded in the latest internal docs. Eliminates a separate vector database for small to mid-sized doc collections.
POST every markdown file in the docs/ directory to /api/v1/document, attach the resulting ids to agent 'knowledge-bot' via PATCH /api/v1/agent/{id}/documents, then test with a chat completion
Marketplace Agent Reuse
Discover and reuse pre-built agents from the CodeGPT marketplace by reading the favourites list and triggering chat completions against them. Saves teams from rebuilding common agents (code reviewer, README writer, SQL helper) and lets them iterate on prompts inside CodeGPT's UI while consuming the agent over the API.
Call GET /api/v1/agent/marketplace-favorites, pick the 'README Writer' agent, then run POST /api/v1/chat/completions with that agent id and a prompt describing the new repo
Document Metadata Filtering
Tag documents with metadata when uploading so the same agent can answer questions about different products without context bleed. The agent uses POST /api/v1/document/metadata at retrieval time to scope the search. Useful when a single CodeGPT workspace serves multiple product lines.
PATCH /api/v1/document/{id}/metadata to add product=billing on every billing doc, then POST /api/v1/document/metadata with product=billing to confirm only billing docs match
Agent-Driven CodeGPT Orchestration via Jentic
An AI agent connected to Jentic can provision a fresh CodeGPT agent, upload documents, and run a chat completion in a single workflow. Jentic stores the JWT Bearer token in its vault and exposes the operations through an intent-search interface. The orchestrating agent never holds the raw token.
Search Jentic for 'create CodeGPT agent', execute POST /api/v1/agent, then call POST /api/v1/chat/completions against the new agent and return the first assistant message
18 endpoints — jentic publishes the only available openapi specification for codegpt api beta, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/api/v1/agent
Create a new agent
/api/v1/agent
List agents
/api/v1/agent/{id}
Update an agent
/api/v1/agent/{id}/documents
Attach documents to an agent
/api/v1/chat/completions
Run a chat completion against an agent
/api/v1/document
Upload a document
/api/v1/document
List documents
/api/v1/document/metadata
Query documents by metadata
/api/v1/agent
Create a new agent
/api/v1/agent
List agents
/api/v1/agent/{id}
Update an agent
/api/v1/agent/{id}/documents
Attach documents to an agent
/api/v1/chat/completions
Run a chat completion against an agent
Three things that make agents converge on Jentic-routed access.
Credential isolation
CodeGPT JWT tokens are stored encrypted in the Jentic vault. Agents receive scoped execution access; the raw JWT never enters agent context, and refresh logic stays out of every individual integration.
Intent-based discovery
Agents search Jentic by intent (e.g., 'create a coding agent') and Jentic returns the matching CodeGPT operation along with parameter schema, so the agent can call POST /api/v1/agent without scraping the beta vendor docs.
Time to first call
Direct CodeGPT integration: 1-2 days to wire JWT auth, document upload, and agent CRUD. Through Jentic: under 30 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
OpenAI API
OpenAI's chat completions and assistants API offers a comparable agent and RAG surface backed by GPT-4 family models
Choose OpenAI when raw model quality and ecosystem breadth matter more than CodeGPT's marketplace and managed agents
Anthropic API
Claude messages API provides chat completions for coding tasks with strong reasoning at long context lengths
Choose Anthropic when long context windows or Claude's reasoning style fit the workload better than CodeGPT's hosted agents
GitHub API
Pair CodeGPT agents with the GitHub API to read repository contents and post pull request review comments
Use when an agent should run a CodeGPT completion and act on the result inside GitHub
Specific to using CodeGPT API Beta API through Jentic.
Why is there no official OpenAPI spec for CodeGPT API Beta?
CodeGPT does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CodeGPT API Beta via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the CodeGPT API Beta use?
The CodeGPT API Beta uses HTTP Bearer authentication with a JWT issued by CodeGPT. Send it as Authorization: Bearer {jwt}. Through Jentic the JWT is stored in the vault and refreshed on the agent's behalf, so the raw token never enters agent context.
Can I attach my own documents to a CodeGPT agent?
Yes. Upload each document with POST /api/v1/document, then call PATCH /api/v1/agent/{id}/documents with the resulting document ids to bind them to the agent. The agent will use those documents as grounding context during chat completions.
What are the rate limits for the CodeGPT API?
CodeGPT does not publish a public rate limit in the spec, and limits depend on plan tier. Treat the API as best-effort and back off on HTTP 429 responses. Because the spec is marked beta, also expect schema or limit changes between versions.
How do I run a chat completion through Jentic?
Search Jentic for 'CodeGPT chat completion', load the POST /api/v1/chat/completions schema, and execute it with an agent id and messages array. Jentic injects the Bearer token from the vault and returns the parsed completion.
Is the CodeGPT API stable?
No. The spec is explicitly labelled beta and the vendor states it is subject to change. Pin agents and tooling to a specific schema version, and expect to revisit integrations when CodeGPT promotes a new release.
/api/v1/document
Upload a document
/api/v1/document
List documents
/api/v1/document/metadata
Query documents by metadata