Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cominty.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Cominty API is a standard HTTPS/JSON API. This guide takes you from zero to your first authenticated request.

​
Prerequisites

Before you begin, you need:
  • A Cominty account
  • A Cominty API token (see the next step)
The base URL for the API is https://ds.cominty.com.

​
Get started

1

Get your API token

Create an API token from the Cominty dashboard. You’ll pass it on every authenticated request in the x-cominty-token header.Keep it secret — treat it like a password.
export COMINTY_TOKEN="your-api-token"
2

Check connectivity

Confirm you can reach the API with the public health endpoint (no auth required).
curl https://ds.cominty.com/status
3

Make your first authenticated call

List the agents in your workspace by sending your token in the x-cominty-token header.
curl https://ds.cominty.com/agents \
  -H "x-cominty-token: $COMINTY_TOKEN"
A 200 response with a JSON body means your token works. You’re ready to go.
Explore every endpoint — agents, chat, skills, documents, and more — in the API Reference. Each page includes a live playground where you can try requests with your own token.
Need help? Reach out at hi@cominty.com.