okta-management-openapi-agent/skills/devices/SKILL.md

name, description

name	description
devices-routes	Handle 8 OpenAPI operation(s) under /api/v1/devices for the devices route group.

devices API Routes

Handle 8 OpenAPI operation(s) under /api/v1/devices for the devices route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

list_devices

• Operation ID: list_devices
• Route: GET /api/v1/devices
• Mode: READ
• Summary: List all devices
• Parameters:
  • after in query
  • limit in query
  • search in query
  • expand in query

get_device

• Operation ID: get_device
• Route: GET /api/v1/devices/{deviceId}
• Mode: READ
• Summary: Retrieve a device
• Parameters:
  • deviceId in path required

delete_device

• Operation ID: delete_device
• Route: DELETE /api/v1/devices/{deviceId}
• Mode: WRITE
• Summary: Delete a device
• Parameters:
  • deviceId in path required

activate_device

• Operation ID: activate_device
• Route: POST /api/v1/devices/{deviceId}/lifecycle/activate
• Mode: WRITE
• Summary: Activate a device
• Parameters:
  • deviceId in path required

deactivate_device

• Operation ID: deactivate_device
• Route: POST /api/v1/devices/{deviceId}/lifecycle/deactivate
• Mode: WRITE
• Summary: Deactivate a device
• Parameters:
  • deviceId in path required

suspend_device

• Operation ID: suspend_device
• Route: POST /api/v1/devices/{deviceId}/lifecycle/suspend
• Mode: WRITE
• Summary: Suspend a Device
• Parameters:
  • deviceId in path required

unsuspend_device

• Operation ID: unsuspend_device
• Route: POST /api/v1/devices/{deviceId}/lifecycle/unsuspend
• Mode: WRITE
• Summary: Unsuspend a Device
• Parameters:
  • deviceId in path required

list_device_users

• Operation ID: list_device_users
• Route: GET /api/v1/devices/{deviceId}/users
• Mode: READ
• Summary: List all users for a device
• Parameters:
  • deviceId in path required