skills

Creates, updates, deletes, gets or lists a skills resource.

Overview

Name	skills
Type	Resource
Id	openai.skills.skills

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Unique identifier for the skill.
name	string	Name of the skill.
created_at	integer (unixtime)	Unix timestamp (seconds) for when the skill was created.
default_version	string	Default version for the skill.
description	string	Description of the skill.
latest_version	string	Latest version for the skill.
object	string	The object type, which is skill. (skill) (default: skill)

list

Name	Datatype	Description
id	string	Unique identifier for the skill.
name	string	Name of the skill.
created_at	integer (unixtime)	Unix timestamp (seconds) for when the skill was created.
default_version	string	Default version for the skill.
description	string	Description of the skill.
latest_version	string	Latest version for the skill.
object	string	The object type, which is skill. (skill) (default: skill)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	skill_id	openai-organization, openai-project
list	select		limit, order, after, openai-organization, openai-project
update	update	skill_id, default_version	openai-organization, openai-project
delete	delete	skill_id	openai-organization, openai-project

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
skill_id	string	The identifier of the skill to delete.
after	string	Identifier for the last item from the previous pagination request
limit	integer	Number of items to retrieve Automatically applied from a SQL LIMIT clause - SELECT ... LIMIT 10 sends limit=10 on the wire. Setting it explicitly in a WHERE clause is not required.
openai-organization	string	Optionally scope the request to a specific organization (overrides the default associated with the API key). Addressable in SQL as openai_organization.
openai-project	string	Optionally scope the request to a specific project (overrides the default associated with the API key). Addressable in SQL as openai_project.
order	string	Sort order of results by timestamp. Use asc for ascending order or desc for descending order.

SELECT examples

get

Success

SELECT
id,
name,
created_at,
default_version,
description,
latest_version,
object
FROM openai.skills.skills
WHERE skill_id = '{{ skill_id }}' -- required
AND "openai-organization" = '{{ openai-organization }}'
AND "openai-project" = '{{ openai-project }}'
;

list

Success

SELECT
id,
name,
created_at,
default_version,
description,
latest_version,
object
FROM openai.skills.skills
WHERE "order" = '{{ order }}'
AND after = '{{ after }}'
AND "openai-organization" = '{{ openai-organization }}'
AND "openai-project" = '{{ openai-project }}'
;

UPDATE examples

update

No description available.

UPDATE openai.skills.skills
SET 
default_version = '{{ default_version }}'
WHERE 
skill_id = '{{ skill_id }}' --required
AND default_version = '{{ default_version }}' --required
AND "openai-organization" = '{{ openai-organization}}'
AND "openai-project" = '{{ openai-project}}'
RETURNING
id,
name,
created_at,
default_version,
description,
latest_version,
object;

DELETE examples

delete

No description available.

DELETE FROM openai.skills.skills
WHERE skill_id = '{{ skill_id }}' --required
AND "openai-organization" = '{{ openai-organization }}'
AND "openai-project" = '{{ openai-project }}'
;