{
  "opencollection": "1.0.0",
  "info": {
    "name": "Passage by 1Password Management Devices Users API",
    "version": "1.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Users",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List users",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.passage.id/v1/apps/:app_id/users",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Page to fetch (min 1)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Number of users to fetch per page (max 500)."
              },
              {
                "name": "created_before",
                "value": "",
                "type": "query",
                "description": "Unix timestamp anchor; returns users created before the timestamp."
              },
              {
                "name": "order_by",
                "value": "",
                "type": "query",
                "description": "Comma separated list of <field>:<ASC/DESC> (e.g. id:DESC,created_at:ASC). Cannot order_by identifier."
              },
              {
                "name": "identifier",
                "value": "",
                "type": "query",
                "description": "Search users by email OR phone, with prepended operators (eq/ne/gt/lt/like/not_like)."
              },
              {
                "name": "id",
                "value": "",
                "type": "query",
                "description": "Search users by id, with prepended operators."
              },
              {
                "name": "login_count",
                "value": "",
                "type": "query",
                "description": "Search users by login_count, with prepended operators."
              },
              {
                "name": "status",
                "value": "",
                "type": "query",
                "description": "Search users by status. Valid values: active, inactive, pending."
              }
            ]
          },
          "docs": "Returns a paginated, filterable list of users for the app. Supports page/limit, created_before cursor, order_by, and identifier/id/login_count/ status/created_at filters with prepended operators (e.g. identifier=<like:val>)."
        },
        {
          "info": {
            "name": "Create a user",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.passage.id/v1/apps/:app_id/users",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new user from an email and/or phone identifier with optional user_metadata. Either email or phone is required; both may be provided."
        },
        {
          "info": {
            "name": "Get a user",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.passage.id/v1/apps/:app_id/users/:user_id",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              },
              {
                "name": "user_id",
                "value": "",
                "type": "path",
                "description": "The Passage user ID."
              }
            ]
          },
          "docs": "Returns a single user's full record, including WebAuthn devices and recent events."
        },
        {
          "info": {
            "name": "Update a user",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.passage.id/v1/apps/:app_id/users/:user_id",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              },
              {
                "name": "user_id",
                "value": "",
                "type": "path",
                "description": "The Passage user ID."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates a user's email, phone, and/or user_metadata."
        },
        {
          "info": {
            "name": "Delete a user",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.passage.id/v1/apps/:app_id/users/:user_id",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              },
              {
                "name": "user_id",
                "value": "",
                "type": "path",
                "description": "The Passage user ID."
              }
            ]
          },
          "docs": "Permanently deletes a user and their credentials."
        },
        {
          "info": {
            "name": "Activate a user",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.passage.id/v1/apps/:app_id/users/:user_id/activate",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              },
              {
                "name": "user_id",
                "value": "",
                "type": "path",
                "description": "The Passage user ID."
              }
            ]
          },
          "docs": "Activates a user, allowing them to authenticate."
        },
        {
          "info": {
            "name": "Deactivate a user",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.passage.id/v1/apps/:app_id/users/:user_id/deactivate",
            "params": [
              {
                "name": "app_id",
                "value": "",
                "type": "path",
                "description": "The Passage application ID."
              },
              {
                "name": "user_id",
                "value": "",
                "type": "path",
                "description": "The Passage user ID."
              }
            ]
          },
          "docs": "Deactivates a user, preventing them from authenticating."
        }
      ]
    }
  ],
  "bundled": true
}