versions

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

Overview

Name	versions
Type	Resource
Id	openai.skills.versions

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Unique identifier for the skill version.
name	string	Name of the skill version.
skill_id	string	Identifier of the skill for this version.
created_at	integer (unixtime)	Unix timestamp (seconds) for when the version was created.
description	string	Description of the skill version.
object	string	The object type, which is skill.version. (skill.version) (default: skill.version)
version	string	Version number for this skill.

list

Name	Datatype	Description
id	string	Unique identifier for the skill version.
name	string	Name of the skill version.
skill_id	string	Identifier of the skill for this version.
created_at	integer (unixtime)	Unix timestamp (seconds) for when the version was created.
description	string	Description of the skill version.
object	string	The object type, which is skill.version. (skill.version) (default: skill.version)
version	string	Version number for this skill.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	skill_id, version	openai-organization, openai-project
list	select	skill_id	limit, order, after, openai-organization, openai-project
delete	delete	skill_id, version	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.
version	string	The skill version number.
after	string	The skill version ID to start after.
limit	integer	Number of versions 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 version number.

SELECT examples

get

Success

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

list

Success

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

DELETE examples

delete

No description available.

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