🚀 RingCX Admin API Mock Server

v1.10.0

Interactive API Tester • Click to expand

📋 GET Endpoints

▶ GET /sub-accounts List all sub accounts

▶ GET /agent-groups List agent groups

Filter by subAccountId (optional)

▶ GET /users-with-roles Users with assigned roles

Count (max 500)

▶ GET /users-without-roles New users without roles

Count (max 500)

▶ GET /roles Available roles (filter by subAccountIds)

SubAccount IDs (optional, comma-separated)

Role Type

▶ GET /user/:rcUserId/roles Roles for specific user

RC User ID

Use IDs from /users-with-roles or 165000001 (user without roles)

✏️ PATCH Endpoints

▶ PATCH /agents/roles Assign roles to agents

SubAccount ID

skipConflictingAgents (skip conflicts, assign to others)

Agent Group ID

Required when skipConflictingAgents=false

Role IDs

User IDs

💡 409 Conflict: Only if user is in DIFFERENT group in SAME subAccount. Same group = OK.

▶ PATCH /admins/roles Assign admin roles

SubAccount ID

Role IDs (Admin type)

User IDs

No 409 Conflict for admins (per spec)