Admin

Administrative endpoints for system management

Get user by ID

get

Retrieve user details by ID

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

User ID

Responses

200

User retrieved successfully

application/json

400

Invalid user ID format.

application/json

401

Missing or invalid authentication token.

application/json

403

Insufficient permissions to view user details.

application/json

404

User not found with the provided ID.

application/json

500

Internal server error occurred while retrieving user.

application/json

get

/admin/api/v1/users/{id}

HTTPcURLJavaScriptPython

GET /admin/api/v1/users/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "[email protected]",
  "first_name": "John",
  "middle_name": "Michael",
  "last_name": "Doe",
  "phone_number": "[phone]",
  "status": "active",
  "email_verified": false,
  "phone_verified": false,
  "oauth_provider": "google",
  "oauth_provider_id": "123456789",
  "email_verified_at": "2025-08-13T12:35:00Z",
  "phone_verified_at": "2025-08-13T12:36:00Z",
  "created_at": "2025-08-13T12:34:56Z",
  "updated_at": "2025-08-14T09:21:45Z",
  "roles": {
    "organizations": [
      {
        "org_id": "org-jhyR3C6vCqP",
        "role": "admin"
      }
    ],
    "projects": [
      {
        "org_id": "org-jhyR3C6vCqP",
        "project_id": "prj-QDmnerkgMg",
        "role": "admin"
      }
    ]
  }
}

Delete user by ID

delete

Delete user by ID

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

User ID

Responses

200

User deleted successfully

application/json

400

Invalid user ID format.

application/json

401

Missing or invalid authentication token.

application/json

403

Insufficient permissions to delete user.

application/json

404

User not found with the provided ID.

application/json

500

Internal server error occurred while deleting user.

application/json

delete

/admin/api/v1/users/{id}

HTTPcURLJavaScriptPython

DELETE /admin/api/v1/users/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "Operation completed successfully"
}

Grant credit to organization

post

Grant credit to an organization by admin

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

org_idstringRequired

Organization ID

Body

application/json

Request payload for granting credit to an organization by admin

amount_millicentsinteger · int64 · min: 1Required

Credit amount in millicents (1/1000 of a cent = 1/100000 of a dollar, e.g., 15075000 = $150.75)

Example: 15075000

descriptionstring · max: 255Required

Description for the credit grant

Example: Admin credit grant for promotional activity

Responses

200

Credit granted successfully

application/json

400

Invalid organization ID format or request body.

application/json

401

Missing or invalid authentication token.

application/json

403

Insufficient permissions to grant credit.

application/json

404

Organization not found.

application/json

500

Internal server error occurred while granting credit.

application/json

post

/admin/api/v1/orgs/{org_id}/wallets/grant-credit

HTTPcURLJavaScriptPython

POST /admin/api/v1/orgs/{org_id}/wallets/grant-credit HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "amount_millicents": 15075000,
  "description": "Admin credit grant for promotional activity"
}

{
  "org_id": "org-2Xk9mPqR",
  "balance_millicents": 15075000,
  "payment_balance_millicents": 15075000,
  "grants_balance_millicents": 15075000,
  "earn_balance_millicents": 15075000,
  "created_at": "2025-08-13T12:34:56Z",
  "updated_at": "2025-08-14T09:21:45Z"
}