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

name, description

name	description
directories-routes	Handle 3 OpenAPI operation(s) under /api/v1/directories/{appInstanceId}/groups for the directories route group.

directories API Routes

Handle 3 OpenAPI operation(s) under /api/v1/directories/{appInstanceId}/groups for the directories 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

update_group_membership

• Operation ID: update_group_membership
• Route: POST /api/v1/directories/{appInstanceId}/groups/modify
• Mode: WRITE
• Summary: Update an external directory group membership
• Parameters:
  • appInstanceId in path required
• Body: JSON request body accepted.

submit_group_attribute_query

• Operation ID: submit_group_attribute_query
• Route: POST /api/v1/directories/{appInstanceId}/groups/{groupId}/query
• Mode: WRITE
• Summary: Submit a query for AD Group
• Parameters:
  • appInstanceId in path required
  • groupId in path required
• Body: JSON request body accepted.

get_group_attribute_query_result

• Operation ID: get_group_attribute_query_result
• Route: GET /api/v1/directories/{appInstanceId}/groups/{groupId}/query/{resultId}
• Mode: READ
• Summary: Retrieve the results of an AD group query
• Parameters:
  • appInstanceId in path required
  • groupId in path required
  • resultId in path required