skills.rest
ramshan00
ramshan00COMMUNITY
Explore all skills by this author →
GitHub

openai-chatkit

Implements OpenAI ChatKit session and thread management via REST API endpoints.

Updated Feb 8, 2026
Search Tags:#threads#api integration#openai#curl#conversation management#chatkit#chat sessions
One-click install
npx skills add https://github.com/ramshan00/hackaton --skill openai-chatkit-ramshan00
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openai-chatkit
Source: https://github.com/ramshan00/hackaton/tree/main/Hackathon2-phase3/.claude/skills/openai-chatkit
Command: npx skills add https://github.com/ramshan00/hackaton --skill openai-chatkit-ramshan00

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve? Building chat applications with persistent conversation history requires managing sessions and threads through OpenAI's ChatKit beta APIs, which involves repetitive API calls, authentication handling, and error management that this Skill streamlines. ## Core Features & Use Cases - Session Management: Create and retrieve chat sessions with custom metadata for user identification and tracking. - Thread Organization: Create and list conversation threads within sessions to separate topics while maintaining context. - CLI Helper Script: Execute common ChatKit operations directly from the command line using the included bash helper. - Use Case: A developer building a customer support chat app can create one session per user, spin up separate threads for billing and technical inquiries, and retrieve conversation context on demand. ## Quick Start Ask the assistant to create a new ChatKit session with user metadata and then create a support thread inside it using the OpenAI API.

Frequently Asked Questions about openai-chatkit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a chat session with the OpenAI ChatKit API?▼

Send a POST request to /beta/chatkit/sessions with an optional metadata object such as a user_id. The API returns a session ID and creation timestamp that you use for subsequent thread creation.

How do I organize conversations into threads in OpenAI ChatKit?▼

Create threads by posting to /beta/chatkit/threads with a session_id and optional metadata like a topic. Use separate threads for distinct conversation topics within the same user session to maintain context.

What do I need to run the ChatKit helper script?▼

The helper script requires the OPENAI_API_KEY environment variable, cURL for API requests, and jq for JSON parsing. It supports create-session, create-thread, list-threads, and get-session commands.

What are the rate limits for OpenAI ChatKit endpoints?▼

The sessions endpoint allows 100 requests per minute per API key, while the threads endpoint allows 1000 requests per minute. Implement exponential backoff when you receive 429 rate limit responses.

Why does my ChatKit API request return a 401 error?▼

A 401 error means the API key is missing or invalid in the Authorization Bearer header. Verify the OPENAI_API_KEY environment variable is set correctly and never expose keys in client-side code.

Related Skills

Explore More Software Engineering Skills→
sarimofficialsarimofficial

configure-chatkit

Integrate OpenAI ChatKit into a Next.js frontend with Better Auth.

Community
Advanced
shuremali02shuremali02

chatkit-python

Build a FastAPI chat backend with SSE streaming and SQLModel persistence.

Community
Advanced
jymchngjymchng

axum-middleware

Add authentication, logging, and rate limiting to Axum routes.

Community
Intermediate
SSujitXSSujitX
11

Managed Databases

Provision and manage containerized database instances in Docker environments.

Community
Advanced