User Administration APIs

Overview

The User Administration APIs provide comprehensive user management capabilities including user creation, role assignment, permissions management, and administrative operations across universities, trainers, interns, and students.

Base URL

https://talentg.vercel.app/api

Authentication

All endpoints require authentication with admin-level permissions. Users must have admin or talentgro_team roles.

Authorization: Bearer <supabase_jwt_token>
Content-Type: application/json

User Management

List Users

Create User

Update User

Update User Roles

Delete Users

University Management

List Universities

Create University

Update University

Delete University

Trainer Management

List Trainers

Create Trainer

Intern Management

Create Intern

Error Handling

Common Error Codes

Code	HTTP Status	Description
`UNAUTHORIZED`	401	Invalid or missing authentication token
`FORBIDDEN`	403	Insufficient permissions for the operation
`NOT_FOUND`	404	User, university, or resource not found
`VALIDATION_ERROR`	400	Invalid input data provided
`CONFLICT`	409	Resource already exists (duplicate email/slug)
`RATE_LIMITED`	429	Too many requests

Error Response Format

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input data",
    "details": {
      "field": "email",
      "message": "Email format is invalid"
    }
  }
}

Rate Limiting

Read operations: 1000 requests per hour
Write operations: 500 requests per hour
Bulk operations: 50 requests per hour

SDK Examples

const createUser = async (userData) => {
  const token = await getSupabaseToken();

  const response = await fetch('/api/admin/create-user', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(userData)
  });

  return response.json();
};

// Usage
const newUser = await createUser({
  email: 'trainer@example.com',
  full_name: 'Jane Trainer',
  password: 'secure123',
  roles: ['trainer']
});

Getting Started

Core APIs

Additional APIs

Overview

Base URL

Authentication

User Management

List Users

Create User

Update User

Update User Roles

Delete Users

University Management

List Universities

Create University

Update University

Delete University

Trainer Management

List Trainers

Create Trainer

Intern Management

Create Intern

Error Handling

Common Error Codes

Error Response Format

Rate Limiting

SDK Examples

Getting Started

Core APIs

Additional APIs

​Overview

​Base URL

​Authentication

​User Management

​List Users

​Create User

​Update User

​Update User Roles

​Delete Users

​University Management

​List Universities

​Create University

​Update University

​Delete University

​Trainer Management

​List Trainers

​Create Trainer

​Intern Management

​Create Intern

​Error Handling

​Common Error Codes

​Error Response Format

​Rate Limiting

​SDK Examples

Overview

Base URL

Authentication

User Management

List Users

Create User

Update User

Update User Roles

Delete Users

University Management

List Universities

Create University

Update University

Delete University

Trainer Management

List Trainers

Create Trainer

Intern Management

Create Intern

Error Handling

Common Error Codes

Error Response Format

Rate Limiting

SDK Examples