Users

Manage user accounts in your organization. These endpoints are intended for SOAR (Security Orchestration, Automation and Response) integration and administrative automation.

All user endpoints require admin scopes — the API key owner must be an organization admin.

List users​

GET /users

Returns a paginated list of users in the organization, newest first. Users who have been invited but have never signed in are not included.

Scope: admin:users:read · Rate limit: Standard (300 req / min)

Query parameters​

Response​

{
  "data": [
    {
      "id": "019abc12-3456-7890-abcd-ef1234567890",
      "email": "alice@example.com",
      "name": "Alice Johnson",
      "disabled": false,
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-03-20T14:00:00.000Z"
    }
  ],
  "nextCursor": "019abc12-3456-7890-abcd-ef1234567899",
  "totalCount": 42
}

Example​

curl "https://<your-domain>.nomic.ai/api/v0/users?limit=25&email=alice" \
  -H "Authorization: Bearer $NOMIC_API_KEY"

Get user details​

GET /users/{id}

Returns detailed information about a single user, including counts of their active API keys and Nomic agent sessions.

Scope: admin:users:read · Rate limit: Standard (300 req / min)

Path parameters​

Response​

{
  "id": "019abc12-3456-7890-abcd-ef1234567890",
  "email": "alice@example.com",
  "name": "Alice Johnson",
  "disabled": false,
  "disabledAt": null,
  "createdAt": "2026-01-15T09:30:00.000Z",
  "updatedAt": "2026-03-20T14:00:00.000Z",
  "apiKeyCount": 3,
  "sessionCount": 1
}

Example​

curl "https://<your-domain>.nomic.ai/api/v0/users/019abc12-3456-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer $NOMIC_API_KEY"

Disable a user​

POST /users/{id}/disable

Disables a user account and revokes all their API keys. Disabled users cannot log in or make API requests. The response includes the count of revoked keys.

Scope: admin:users:write · Rate limit: Write (60 req / min)

Path parameters​

Request body (optional)​

Response​

{
  "success": true,
  "user": {
    "id": "019abc12-3456-7890-abcd-ef1234567890",
    "email": "alice@example.com",
    "disabled": true,
    "disabledAt": "2026-04-05T12:00:00.000Z"
  },
  "revokedApiKeys": 3
}

Errors​

Example​

curl -X POST "https://<your-domain>.nomic.ai/api/v0/users/019abc12-3456-7890-abcd-ef1234567890/disable" \
  -H "Authorization: Bearer $NOMIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Compromised credentials" }'

Enable a user​

POST /users/{id}/enable

Re-enables a previously disabled user account. The operation checks seat limits before enabling — if the organization has reached its user cap, the request will fail.

Scope: admin:users:write · Rate limit: Write (60 req / min)

Path parameters​

Request body (optional)​

Response​

{
  "success": true,
  "user": {
    "id": "019abc12-3456-7890-abcd-ef1234567890",
    "email": "alice@example.com",
    "disabled": false
  }
}

Errors​

Example​

curl -X POST "https://<your-domain>.nomic.ai/api/v0/users/019abc12-3456-7890-abcd-ef1234567890/enable" \
  -H "Authorization: Bearer $NOMIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Credentials rotated" }'