Skip to content

feat(OpenAI): add Skills API - #808

Merged
iBotPeaches merged 1 commit into
openai-php:mainfrom
zain534102:feat/skills-resource
Sep 26, 2026
Merged

iBotPeaches merged 1 commit into
openai-php:mainfrom
zain534102:feat/skills-resource

Conversation

@zain534102

@zain534102 zain534102 commented Sep 24, 2026 •

Copy link
Copy Markdown
Contributor

What:

  • Bug Fix
  • New Feature

Description:

Adds the Skills API along with its Versions sub-resource.

  • $client->skills(): create, list, retrieve, update, content, delete
  • $client->skills()->versions(): create, list, retrieve, content, delete

files takes a single stream for a zip upload, or an array of streams which is sent as files[] parts for a directory upload. All endpoints were tested against the live API.

Context: OpenAI Docs

Related:

fixes: #774

@iBotPeaches

Copy link
Copy Markdown
Collaborator

thanks! I only skimmed it and it seemed fine. However, since a brand new top level resource. Give me a day or two. I need to make a real integration test and hit the API for real to test this out on the all the endpoints.

@zain534102
zain534102 force-pushed the feat/skills-resource branch 2 times, most recently from 935565e to fd82add Compare September 24, 2026 20:31
@zain534102 zain534102 changed the title Add Skills resource feat(OpenAI): add Skills API Sep 24, 2026

@iBotPeaches iBotPeaches left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This works!

➜  openai-php-laravel-test git:(master) ✗ php artisan app:skills-test
Created skill ID: skill_6ab7a2be1cd48191b21e1ac7260bdff70227fe7bc4ac1c88
Name: basic-math-6ab7a2bdb4792, Description: Add or multiply numbers.
Default version: 1, Latest version: 1
Waiting for the skill to become readable (attempt 1 of 5)...
Waiting for the skill to become readable (attempt 2 of 5)...
Listed list of skills (has more: false)
Skill ID: skill_6ab7a2be1cd48191b21e1ac7260bdff70227fe7bc4ac1c88, Name: basic-math-6ab7a2bdb4792, Latest version: 1
Retrieved skill ID: skill_6ab7a2be1cd48191b21e1ac7260bdff70227fe7bc4ac1c88, Created at: 1790419646
Created skill version: 2 (ID: skillver_6ab7a2c1cde881918dc0a1e6a38c2d150227fe7bc4ac1c88) for skill skill_6ab7a2be1cd48191b21e1ac7260bdff70227fe7bc4ac1c88
Version description: Add, multiply or divide numbers.
Waiting for the skill to become readable (attempt 1 of 5)...
Waiting for the skill to become readable (attempt 2 of 5)...
Listed 2 version(s), first: skillver_6ab7a2c1cde881918dc0a1e6a38c2d150227fe7bc4ac1c88, last: skillver_6ab7a2be1ce88191bcf1a1728e122bfa0227fe7bc4ac1c88
Version: 2, ID: skillver_6ab7a2c1cde881918dc0a1e6a38c2d150227fe7bc4ac1c88, Name: basic-math-6ab7a2bdb4792
Version: 1, ID: skillver_6ab7a2be1ce88191bcf1a1728e122bfa0227fe7bc4ac1c88, Name: basic-math-6ab7a2bdb4792
Retrieved version: 2, Object: skill.version
Downloaded version bundle of 547 bytes.
Updated default version to: 2
Downloaded skill bundle of 547 bytes.
Deleted version: 2, Deleted: true
Deleted skill ID: skill_6ab7a2be1cd48191b21e1ac7260bdff70227fe7bc4ac1c88, Deleted: true

Tested all endpoints with real data. The file upload is real finicky, so I'll do a follow up PR to make that easier.

@iBotPeaches
iBotPeaches merged commit 790f798 into openai-php:main Sep 26, 2026
14 checks passed
@iBotPeaches iBotPeaches added this to the v0.22.0 milestone Sep 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Supporting skills

2 participants