DevelopersDevOpsSaaS teamsschedule6 min
Integrate Konso into your systems
Use the Konso Public API to automate content, observability, and platform workflows.
What is Konso Public API
The Konso Public API provides programmatic access to core platform capabilities including observability, headless CMS, AI-powered content generation, agents, and integrations. All endpoints are secured and exposed via versioned REST and gRPC interfaces.
- check_circleAutomate content generation and delivery
- check_circleIntegrate observability data into internal tools
- check_circleEmbed Konso into CI/CD pipelines
- check_circleBuild custom workflows and SaaS integrations
What you can do
- Manage projects and environments
- Create and update structured content
- Fetch logs, metrics, and business events
- Trigger automated agents
- Integrate with external systems
Who is it for
- Backend and platform engineers
- DevOps and automation workflows
- SaaS integrations and internal tooling
- AI-driven content pipelines
Authentication
Konso uses API key–based authentication. Every request must include the x-api-key header with your personal API key.
REST Authenticationhttp
x-api-key: <YOUR_API_KEY>REST Examplehttp
GET /v1/cms/pages/{projectId}
Host: apis-spb.konso.io
x-api-key: <YOUR_API_KEY>gRPC Metadatabash
x-api-key: <YOUR_API_KEY>warning
Keep your API key secret. Do not expose it in client-side code or public repositories.
Request / Response Format
All Konso API endpoints use JSON over HTTPS and follow a consistent response structure.
Common Headershttp
Accept: application/json
Content-Type: application/jsonPOST Endpoints
POST endpoints are used to create new entities. Each request uses a dedicated request model with validation.
Response Modeljson
{
"result": true,
"validationErrors": [],
"errors": []
}Status Codes
- 201 Created — success
- 400 Bad Request — validation errors returned in validationErrors
- 500 Internal Server Error — runtime errors returned in errors
Рекомендации
- verifiedStore API keys in secure vaults or environment variables
- verifiedAvoid exposing API calls from frontend applications
- verifiedUse pagination for large datasets
- verifiedImplement retry logic for transient failures