Implementation:Openai Openai python Skill List Params

Knowledge Sources	Openai_Openai_python OpenAI API Reference
Domains	API_Types, Python
Last Updated	2026-02-15 00:00 GMT

Overview

Concrete tool for defining query parameters when listing skills provided by the openai-python SDK.

Description

SkillListParams is a TypedDict that defines the optional query parameters accepted by the skill listing endpoint. It supports cursor-based pagination via the after field (identifier for the last item from the previous request), result limiting via limit (number of items to retrieve), and sort ordering via order ("asc" or "desc" by timestamp). All fields are optional since the TypedDict uses total=False.

Usage

Import SkillListParams when you need to provide typed keyword arguments to client.skills.list() for paginating or ordering skill results.

Code Reference

Source Location

• Repository: openai-python
• File: src/openai/types/skill_list_params.py

Signature

class SkillListParams(TypedDict, total=False):
    after: str
    limit: int
    order: Literal["asc", "desc"]

Import

from openai.types import SkillListParams

I/O Contract

Fields

Name	Type	Required	Description
after	str	No	Identifier for the last item from the previous pagination request.
limit	int	No	Number of items to retrieve.
order	Literal["asc", "desc"]	No	Sort order of results by timestamp. "asc" for ascending, "desc" for descending.

Usage Examples

from openai import OpenAI

client = OpenAI()

# List skills with ordering
skills = client.skills.list(order="desc", limit=20)

# Paginate through results
if skills.has_more and skills.last_id:
    next_page = client.skills.list(
        after=skills.last_id,
        limit=20,
        order="desc",
    )

Related Pages

• Environment:Openai_Openai_python_Python_3_9_Plus