API

JuhJuh exposes a REST API at /api/v1/ for managing your organization, projects, tickets, agents, pages, infrastructure, and more. Every action available in the dashboard is also available through the API.

Authentication¶

Two methods are supported: API keys and session cookies.

API keys¶

API keys are the primary method for programmatic access. Every key is scoped to a single organization and prefixed with jjk_.

1. Go to Settings, then API Keys in your organization dashboard
2. Click Create API Key
3. Name the key and set an optional expiration date
4. Copy the key immediately. It is shown once and cannot be retrieved later.

Include the key in the Authorization header:

Authorization: Bearer jjk_your_key

API keys inherit the permissions of the user who created them. If the user loses access to the organization, the key stops working.

Session authentication¶

If you are already logged in to the JuhJuh dashboard, API requests from the same browser session are authenticated automatically. This is useful for building internal tools or browser extensions.

Organization scoping¶

Most endpoints require an organization context. The API resolves your organization in this order:

1. The X-Juhjuh-Org header, if present (pass your org slug)
2. The organization tied to your API key
3. Your first active organization membership

For multi-org users, always pass the X-Juhjuh-Org header to avoid ambiguity.

X-Juhjuh-Org: acme-engineering

Rate limits¶

Every API key has a per-minute request limit. The limit depends on your subscription plan. When you exceed it, the API returns 429 Too Many Requests with a Retry-After header indicating how many seconds to wait.

Default limit: 60 requests per minute.

Response format¶

All responses are JSON. Successful requests return 200, 201, or 204. Errors return the appropriate HTTP status code with a JSON body:

json { "error": "Permission denied." }

List endpoints return paginated results with count, next, previous, and results fields:

json { "count": 42, "next": "https://your-org.juhjuh.com/api/v1/projects/ACME/tickets/?page=2", "previous": null, "results": [...] }

Follow the next URL to fetch subsequent pages.

Quick start¶

List tickets in a project¶

bash curl -H "Authorization: Bearer jjk_your_key" \ https://your-org.juhjuh.com/api/v1/projects/ACME/tickets/

Create a ticket¶

bash curl -X POST \ -H "Authorization: Bearer jjk_your_key" \ -H "Content-Type: application/json" \ -d '{"title": "Fix login timeout", "description": "Session expires after 5 minutes"}' \ https://your-org.juhjuh.com/api/v1/projects/ACME/tickets/

Get vault secrets¶

bash curl -H "Authorization: Bearer jjk_your_key" \ https://your-org.juhjuh.com/api/v1/vaults/production/entries/

Chat with an agent¶

bash curl -X POST \ -H "Authorization: Bearer jjk_your_key" \ -H "Content-Type: application/json" \ -d '{"message": "What are the open tickets this sprint?"}' \ https://your-org.juhjuh.com/api/v1/orgs/acme-engineering/agents/1/chat/

Send a natural language request¶

bash curl -X POST \ -H "Authorization: Bearer jjk_your_key" \ -H "Content-Type: application/json" \ -d '{"query": "Create a bug ticket for the payments service"}' \ https://your-org.juhjuh.com/api/v1/gateway/

Endpoints¶

Projects¶

Tickets¶

Tickets can also be retrieved or resolved globally:

Boards¶

Sprints¶

Agents¶

Agent skills¶

Pipelines¶

Batch executions¶

Org-scoped shortcuts¶

These convenience endpoints mirror their project-scoped equivalents but are scoped to the organization. Useful when you need cross-project access.

Pages (knowledge base)¶

Page comments¶

Folders¶

Search¶

Schedules¶

Templates¶

Ticket templates¶

Organization members¶

Project members¶

Teams¶

Ideas¶

Knowledge entries¶

Connections (project resources)¶

Dependencies¶

Design systems¶

Notifications¶

Notification preferences¶

Brand voice¶

Skills (org-level)¶

Intake¶

Improvements¶

Marketplace¶

Slack channels¶

Audit logs¶

Billing¶

Virtual machines¶

For config-as-code VM management, see the CLI and JuhJuh File docs.

Vault¶

Deployments¶

API keys¶

Gateway (natural language)¶

The gateway accepts a plain text instruction and routes it to the appropriate action. It is the same interface that powers Ask JuhJuh.

CLI authentication¶

These endpoints are used by the CLI during login. You do not need to call them directly.

Error codes¶

Related¶

• Permissions for role-based access control and feature gating
• Agents for creating and managing AI agents
• Tickets for the ticket lifecycle and execution pipeline
• CLI for managing JuhJuh from your terminal
• Pages for the knowledge base API
• Billing for subscription plans and usage limits