Users - IMP Docs

The user type covers human users signing in via the web UI, API service accounts, and self-registered external guest users. Each user carries preference data, optional role and team assignments, and knowledge-embedding timestamps. See Users & access.

type user {
  id: Float
  favourite_agents: JSON
  favourite_projects: JSON
  favourite_contexts: JSON
  favourite_items: JSON
  recently_viewed_items: JSON
  firstname: String
  name: String
  lastname: String
  email: String
  type: String
  profile_image: String
  super_admin: Boolean
  status: String
  emailVerified: String
  scope_mode: String
  agent_ids: JSON
  last_used: Date
  personal_system_prompt: String
  role: String
  team: String
  project: String
  last_processed_at: Date
  embeddings_updated_at: Date
  createdAt: Date
  updatedAt: Date
  budget: JSON
}

Field notes

Field	Notes
`type`	Account type: `"user"` for human accounts, `"api"` for service accounts, `"external"` for self-registered guest-mode users (redirected out of the internal app).
`super_admin`	When `true`, bypasses all role-based permission checks.
`scope_mode`	Restricts which agents the user can open; `"all"` or `"assigned"` (limits to `agent_ids`).
`agent_ids`	JSON array of agent IDs; only effective when `scope_mode` is `"assigned"`.
`role`	ID string of the assigned `role` record.
`team`	ID string of the assigned `team` record.
`project`	ID string of the user’s default project.
`personal_system_prompt`	User-defined extra instructions injected into their sessions.
`budget`	JSON budget envelope for per-user spending limits.
`last_used`	Timestamp of the user’s most recent authenticated request.
`last_processed_at`	Timestamp of the last knowledge-embedding pass over this record.
`embeddings_updated_at`	Timestamp when vector embeddings were last regenerated.

Access note: The secret columns password, apikey, anthropic_token, and temporary_token are write-only — they are accepted via userInput mutations but are never returned by any read query or filter.

Example query

query {
  usersPagination(
    limit: 20
    filters: [{ type: { eq: "user" }, status: { eq: "active" } }]
    sort: { field: "name", direction: ASC }
  ) {
    items {
      id
      name
      email
      type
      role
      team
      super_admin
      last_used
    }
    pageInfo {
      currentPage
      hasNextPage
    }
  }
}