Purdue University

Purdue University Users API

The Users API from Purdue University — 15 operation(s) for users.

GitHub OpenAPI

Operations 33

GET /users/facets Get users facets #
POST /users/facets Create users facets #
GET /users/facets/{id} Get users facets by id #
PUT /users/facets/{id} Replace users facets by id #
DELETE /users/facets/{id} Delete users facets by id #
GET /users/levels Get users levels #
POST /users/levels Create users levels #
GET /users/levels/{id} Get users levels by id #
PUT /users/levels/{id} Replace users levels by id #
DELETE /users/levels/{id} Delete users levels by id #
GET /users/notes Get users notes #
POST /users/notes Create users notes #
GET /users/notes/{id} Get users notes by id #
PUT /users/notes/{id} Replace users notes by id #
DELETE /users/notes/{id} Delete users notes by id #
GET /users/notifications Get users notifications #
GET /users/notifications/{id} Get users notifications by id #
PUT /users/notifications/{id} Replace users notifications by id #
DELETE /users/notifications/{id} Delete users notifications by id #
PUT /users/notifications/mark-all-as-unread Replace users notifications mark all as unread #
GET /users/permissions Get users permissions #
POST /users/permissions/{id} Create users permissions by id #
DELETE /users/permissions/{id} Delete users permissions by id #
GET /users/roles Get users roles #
POST /users/roles Create users roles #
GET /users/roles/{id} Get users roles by id #
PUT /users/roles/{id} Replace users roles by id #
DELETE /users/roles/{id} Delete users roles by id #
GET /users Get users #
POST /users Create users #
GET /users/{id} Get users by id #
PUT /users/{id} Replace users by id #
DELETE /users/{id} Delete users by id #

Documentation

📖
APIReference
https://www.rcac.purdue.edu/api
📖
Documentation
https://www.rcac.purdue.edu/knowledge
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/authentication/purdue-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/openapi/purdue-users-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/json-schema/purdue-hfs-location-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/json-schema/purdue-hfs-location-menu-schema.json

Other Resources

🔗
OpenAPIOriginal
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/openapi/_original/purdue-rcac-api.json
🔗
Support
https://www.rcac.purdue.edu/help
🔗
Errors
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/errors/purdue-errors.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/lifecycle/purdue-lifecycle.yml
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/rules/purdue-openapi-spectral-rules.yml
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/vocabulary/purdue-vocabulary.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/examples/purdue-hfs-locations-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/purdue/refs/heads/main/examples/purdue-hfs-location-menu-example.json
🔗
Website
https://www.housing.purdue.edu/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/purdue-users-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

purdue-users-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: RCAC Users API
  version: 0.0.1
servers:
- url: https://www.rcac.purdue.edu/api
  description: Production server
tags:
- name: Users
paths:
  /users/facets:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: user_id
        description: User to retrieve facets for.
        required: true
        schema:
          type: integer
      - in: query
        name: search
        description: A word or phrase to search for.
        required: false
        schema:
          type: string
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        required: false
        schema:
          type: integer
          default: 1
      - in: query
        name: order
        description: Field to sort results by.
        required: false
        schema:
          type: string
          default: datetimecreated
          enum:
          - id
          - datetimecreated
          - datetimeremoved
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: desc
          enum:
          - asc
          - desc
      tags:
      - Users
      summary: Get users facets
      x-summary-source: derived
      operationId: getUsersFacets
      x-operation-id-source: derived
    post:
      description: Create a new entry
      parameters: []
      responses:
        '201':
          description: Successful entry creation
        '409':
          description: Invalid data
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                key:
                  description: Facet name
                  type: string
                  default: null
                value:
                  description: Facet value
                  type: string
                  default: null
                user_id:
                  description: User ID
                  type: integer
                  default: 0
                access:
                  description: View level ID
                  type: integer
                  default: 0
                locked:
                  description: Is the value editable?
                  type: boolean
                  default: 0
              required:
              - key
              - value
              - user_id
      tags:
      - Users
      summary: Create users facets
      x-summary-source: derived
      operationId: postUsersFacets
      x-operation-id-source: derived
  /users/facets/{id}:
    get:
      description: Retrieve an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Successful entry read
        '404':
          description: Record not found
      tags:
      - Users
      summary: Get users facets by id
      x-summary-source: derived
      operationId: getUsersFacetsById
      x-operation-id-source: derived
    put:
      description: Update an entry
      parameters: []
      responses:
        '204':
          description: Successful entry modification
        '404':
          description: Record not found
        '409':
          description: Invalid data
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                value:
                  description: Facet value
                  type: string
                  default: null
                access:
                  description: View level ID
                  type: integer
                  default: null
              required:
              - value
      tags:
      - Users
      summary: Replace users facets by id
      x-summary-source: derived
      operationId: putUsersFacetsById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Successful deletion
        '404':
          description: Record not found
      tags:
      - Users
      summary: Delete users facets by id
      x-summary-source: derived
      operationId: deleteUsersFacetsById
      x-operation-id-source: derived
  /users/levels:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: search
        description: A word or phrase to search for.
        required: false
        schema:
          type: string
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        required: false
        schema:
          type: integer
          default: 1
      - in: query
        name: order
        description: Field to sort results by.
        required: false
        schema:
          type: string
          default: datetimecreated
          enum:
          - id
          - datetimecreated
          - datetimeremoved
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: desc
          enum:
          - asc
          - desc
      responses:
        '200':
          description: Successful creation
          content:
            application/json:
              example:
                data:
                - id: 1
                  title: Public
                  ordering: 0
                  rules:
                  - 1
                  api: https://yourhost/api/users/levels/1
                - id: 2
                  title: Registered
                  ordering: 1
                  rules:
                  - 2
                  - 8
                  api: https://yourhost/api/users/levels/2
      tags:
      - Users
      summary: Get users levels
      x-summary-source: derived
      operationId: getUsersLevels
      x-operation-id-source: derived
    post:
      description: Create a new entry
      parameters: []
      responses:
        '200':
          description: Successful creation
          content:
            application/json:
              example:
                id: 7
                title: Example
                ordering: 7
                rules:
                - 2
                - 3
                - 4
                api: https://yourhost/api/users/levels/7
        '404':
          description: Record not found
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                title:
                  description: Access level title
                  type: string
                  default: null
                rules:
                  description: A list of role IDs
                  type: array
                  default: null
              required:
              - title
              - rules
      tags:
      - Users
      summary: Create users levels
      x-summary-source: derived
      operationId: postUsersLevels
      x-operation-id-source: derived
  /users/levels/{id}:
    get:
      description: Retrieve an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Successful update
          content:
            application/json:
              example:
                id: 7
                title: Example
                ordering: 7
                rules:
                - 2
                - 3
                - 4
                api: https://yourhost/api/users/levels/7
        '404':
          description: Record not found
      tags:
      - Users
      summary: Get users levels by id
      x-summary-source: derived
      operationId: getUsersLevelsById
      x-operation-id-source: derived
    put:
      description: Update an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Successful update
          content:
            application/json:
              example:
                id: 7
                title: Example
                ordering: 7
                rules:
                - 2
                - 3
                - 4
                - 5
                api: https://yourhost/api/users/levels/7
        '404':
          description: Record not found
        '415':
          description: Invalid data
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                title:
                  description: Access level title
                  type: string
                  default: null
                rules:
                  description: A list of role IDs
                  type: array
                  default: null
              required: []
      tags:
      - Users
      summary: Replace users levels by id
      x-summary-source: derived
      operationId: putUsersLevelsById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Successful deletion
        '404':
          description: Record not found
      tags:
      - Users
      summary: Delete users levels by id
      x-summary-source: derived
      operationId: deleteUsersLevelsById
      x-operation-id-source: derived
  /users/notes:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: search
        description: A word or phrase to search for.
        required: false
        schema:
          type: string
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        required: false
        schema:
          type: integer
          default: 1
      - in: query
        name: order
        description: Field to sort results by.
        required: false
        schema:
          type: string
          default: datetimecreated
          enum:
          - id
          - datetimecreated
          - datetimeremoved
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: desc
          enum:
          - asc
          - desc
      tags:
      - Users
      summary: Get users notes
      x-summary-source: derived
      operationId: getUsersNotes
      x-operation-id-source: derived
    post:
      description: Create a new entry
      parameters: []
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                subject:
                  description: Subject of the note
                  type: string
                  default: null
                body:
                  description: Body of the note
                  type: string
                  default: null
                user_id:
                  description: User ID
                  type: integer
                  default: null
              required:
              - subject
              - user_id
      tags:
      - Users
      summary: Create users notes
      x-summary-source: derived
      operationId: postUsersNotes
      x-operation-id-source: derived
  /users/notes/{id}:
    get:
      description: Retrieve an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      tags:
      - Users
      summary: Get users notes by id
      x-summary-source: derived
      operationId: getUsersNotesById
      x-operation-id-source: derived
    put:
      description: Update an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                subject:
                  description: Subject of the note
                  type: string
                  default: null
                body:
                  description: Note content
                  type: string
                  default: null
              required: []
      tags:
      - Users
      summary: Replace users notes by id
      x-summary-source: derived
      operationId: putUsersNotesById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Successful deletion
        '404':
          description: Record not found
      tags:
      - Users
      summary: Delete users notes by id
      x-summary-source: derived
      operationId: deleteUsersNotesById
      x-operation-id-source: derived
  /users/notifications:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: user_id
        description: User the notifications are for.
        required: false
        schema:
          type: integer
      - in: query
        name: read
        description: Find notifications amrked as read
        required: false
        schema:
          type: integer
      - in: query
        name: unread
        description: Find notifications amrked as unread
        required: false
        schema:
          type: integer
      - in: query
        name: read
        description: Find notifications amrked as read
        required: false
        schema:
          type: integer
      - in: query
        name: search
        description: A word or phrase to search for.
        required: false
        schema:
          type: string
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        required: false
        schema:
          type: integer
          default: 1
      - in: query
        name: order
        description: Field to sort results by.
        required: false
        schema:
          type: string
          default: datetimecreated
          enum:
          - id
          - datetimecreated
          - datetimeremoved
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: desc
          enum:
          - asc
          - desc
      tags:
      - Users
      summary: Get users notifications
      x-summary-source: derived
      operationId: getUsersNotifications
      x-operation-id-source: derived
  /users/notifications/{id}:
    get:
      description: Retrieve an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      tags:
      - Users
      summary: Get users notifications by id
      x-summary-source: derived
      operationId: getUsersNotificationsById
      x-operation-id-source: derived
    put:
      description: Update an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                subject:
                  description: Subject of the note
                  type: string
                  default: null
                body:
                  description: Note content
                  type: string
                  default: null
              required: []
      tags:
      - Users
      summary: Replace users notifications by id
      x-summary-source: derived
      operationId: putUsersNotificationsById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Successful deletion
        '404':
          description: Record not found
      tags:
      - Users
      summary: Delete users notifications by id
      x-summary-source: derived
      operationId: deleteUsersNotificationsById
      x-operation-id-source: derived
  /users/notifications/mark-all-as-unread:
    put:
      description: Update all entries as unread
      parameters: []
      responses:
        '201':
          description: Successful deletion
      tags:
      - Users
      summary: Replace users notifications mark all as unread
      x-summary-source: derived
      operationId: putUsersNotificationsMarkAllAsUnread
      x-operation-id-source: derived
  /users/permissions:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: search
        description: A word or phrase to search for.
        required: false
        schema:
          type: string
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        required: false
        schema:
          type: integer
          default: 1
      - in: query
        name: order
        description: Field to sort results by.
        required: false
        schema:
          type: string
          default: id
          enum:
          - id
          - name
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: desc
          enum:
          - asc
          - desc
      tags:
      - Users
      summary: Get users permissions
      x-summary-source: derived
      operationId: getUsersPermissions
      x-operation-id-source: derived
  /users/permissions/{id}:
    post:
      description: Create a new entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                params:
                  description: A list of permissions.
                  type: array
                  default: null
              required:
              - params
      tags:
      - Users
      summary: Create users permissions by id
      x-summary-source: derived
      operationId: postUsersPermissionsById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Successful deletion
        '404':
          description: Record not found
        '500':
          description: Error deleting record
      tags:
      - Users
      summary: Delete users permissions by id
      x-summary-source: derived
      operationId: deleteUsersPermissionsById
      x-operation-id-source: derived
  /users/roles:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: search
        description: A word or phrase to search for.
        required: false
        schema:
          type: string
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        required: false
        schema:
          type: integer
          default: 1
      - in: query
        name: order
        description: Field to sort results by.
        required: false
        schema:
          type: string
          default: name
          enum:
          - id
          - name
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: asc
          enum:
          - asc
          - desc
      tags:
      - Users
      summary: Get users roles
      x-summary-source: derived
      operationId: getUsersRoles
      x-operation-id-source: derived
    post:
      description: Create a new entry
      parameters: []
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                title:
                  description: Role title
                  type: string
                  default: null
                parent_id:
                  description: Parent role ID
                  type: integer
                  default: 0
              required:
              - title
      tags:
      - Users
      summary: Create users roles
      x-summary-source: derived
      operationId: postUsersRoles
      x-operation-id-source: derived
  /users/roles/{id}:
    get:
      description: Retrieve an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      tags:
      - Users
      summary: Get users roles by id
      x-summary-source: derived
      operationId: getUsersRolesById
      x-operation-id-source: derived
    put:
      description: Update an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                title:
                  description: Role title
                  type: string
                  default: null
                parent_id:
                  description: Parent role ID
                  type: integer
                  default: 0
              required: []
      tags:
      - Users
      summary: Replace users roles by id
      x-summary-source: derived
      operationId: putUsersRolesById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      tags:
      - Users
      summary: Delete users roles by id
      x-summary-source: derived
      operationId: deleteUsersRolesById
      x-operation-id-source: derived
  /users:
    get:
      description: Display a listing of entries
      parameters:
      - in: query
        name: search
        description: A word or phrase to search for.
        type: string
        required: false
        default: ''
        schema:
          type: string
      - in: query
        name: role_id
        description: Filter by a role ID.
        required: false
        schema:
          type: integer
      - in: query
        name: limit
        description: Number of result per page.
        required: false
        schema:
          type: integer
          default: 20
      - in: query
        name: page
        description: Number of where to start returning results.
        type: integer
        required: false
        default: 1
        schema:
          type: string
      - in: query
        name: order
        description: Field to sort results by.
        type: string
        required: false
        default: datetimecreated
        allowedValues: id, motd, datetimecreated, datetimeremoved
        schema:
          type: string
      - in: query
        name: order_dir
        description: Direction to sort results by.
        required: false
        schema:
          type: string
          default: asc
          enum:
          - asc
          - desc
      tags:
      - Users
      summary: Get users
      x-summary-source: derived
      operationId: getUsers
      x-operation-id-source: derived
    post:
      description: Create a new entry
      parameters: []
      responses:
        '201':
          description: Successful entry creation
        '401':
          description: Unauthorized
        '409':
          description: Invalid data
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                name:
                  description: User name
                  type: string
                  default: null
                email:
                  description: Email address
                  type: string
                  default: null
              required: []
      tags:
      - Users
      summary: Create users
      x-summary-source: derived
      operationId: postUsers
      x-operation-id-source: derived
  /users/{id}:
    get:
      description: Retrieve an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      - in: query
        name: module_permissions
        description: A comma-separated list of modules to grab permissions from
        required: false
        schema:
          type: string
          example: news,users,resources
      responses:
        '200':
          description: Successful entry read
        '404':
          description: Record not found
      tags:
      - Users
      summary: Get users by id
      x-summary-source: derived
      operationId: getUsersById
      x-operation-id-source: derived
    put:
      description: Update an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '202':
          description: Successful entry modification
        '404':
          description: Record not found
        '409':
          description: Invalid data
      requestBody:
        content:
          '*/*':
            schema:
              type: object
              properties:
                name:
                  description: User name
                  type: string
                  default: null
                api_token:
                  description: API token
                  type: string
                  default: null
                puid:
                  description: Organization ID
                  type: integer
                  default: null
                username:
                  description: Username
                  type: string
                  default: null
                unixid:
                  description: Unix user ID
                  type: integer
                  default: null
                datelastseen:
                  description: Last time the user logged in
                  type: string
                  default: null
                roles:
                  description: A list of Role IDs to apply to the user
                  type: array
                  default: null
              required: []
      tags:
      - Users
      summary: Replace users by id
      x-summary-source: derived
      operationId: putUsersById
      x-operation-id-source: derived
    delete:
      description: Delete an entry
      parameters:
      - in: path
        name: id
        description: Entry identifier
        required: true
        schema:
          type: integer
      responses:
        '204':
          description: Successful entry deletion
        '404':
          description: Record not found
      tags:
      - Users
      summary: Delete users by id
      x-summary-source: derived
      operationId: deleteUsersById
      x-operation-id-source: derived
components:
  securitySchemes:
    api_token:
      type: apiKey
      name: api_token
      in: header