Projects API

A project owns conversations, contacts, KB articles, widget config, integrations, forms, beacons, and webhooks. API keys are bound to a single organization but can reach any project within that org.

Endpoints

List projects

bash
curl https://api.rogeriq.com/api/v1/orgs/org_xxx/projects \  -H "X-API-Key: riq_xxx"

bash
rogeriq projects list

ts
const projects = await roger.org("org_xxx").projects.list();

Create a project

bash
curl -X POST https://api.rogeriq.com/api/v1/orgs/org_xxx/projects \  -H "X-API-Key: riq_xxx" \  -H "Content-Type: application/json" \  -d '{"name": "Acme Support", "domain": "support.acme.com"}'

bash
rogeriq projects create "Acme Support" --domain support.acme.com

ts
const project = await roger.org("org_xxx").projects.create({  name: "Acme Support",  domain: "support.acme.com",});

Body

Response

json
{  "data": {    "id": "prj_xxxxxxxxxxxx",    "org_id": "org_xxxxxxxxxxxx",    "name": "Acme Support",    "slug": "acme-support",    "domain": "support.acme.com",    "agent_mode": "copilot",    "ai_model": null,    "created_at": "2026-05-17T18:00:00Z"  }}

409 SLUG_CONFLICT if the slug already exists in the org.

Update a project

bash
curl -X PATCH https://api.rogeriq.com/api/v1/orgs/org_xxx/projects/prj_xxx \  -H "X-API-Key: riq_xxx" \  -H "Content-Type: application/json" \  -d '{"agent_mode": "autopilot", "ai_model": "anthropic/claude-sonnet-4"}'

bash
rogeriq projects update prj_xxx --agent-mode autopilot --ai-model anthropic/claude-sonnet-4

Body

Delete a project

bash
curl -X DELETE https://api.rogeriq.com/api/v1/orgs/org_xxx/projects/prj_xxx \  -H "X-API-Key: riq_xxx"

Requires projects:admin scope. Cascades — every conversation, contact, KB article, integration, webhook, form, and beacon owned by the project is deleted.

Audit

Every create / update / delete is recorded in the audit log with the acting API key id. See Settings → Audit log.