Beta.Skills

August 4, 2026 · View on GitHub

Overview

Available Operations

list - ListSkills
create - CreateSkill
get - GetSkill
delete - DeleteSkill
update_metadata - UpdateSkill
list_versions - ListSkillVersions
create_version - CreateSkillVersion
get_version - GetSkillVersion
update_version_metadata - UpdateSkillVersionMetadata

list

ListSkills

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.list()

    while res is not None:
        # Handle items

        res = res.next()

Parameters

Parameter	Type	Required	Description
`page_size`	Optional[int]	:heavy_minus_sign:	N/A
`page_token`	Optional[str]	:heavy_minus_sign:	N/A
`alias`	Optional[str]	:heavy_minus_sign:	N/A
`fields`	List[str]	:heavy_minus_sign:	N/A
`sort_field`	Optional[models.ListSortField]	:heavy_minus_sign:	Defaults to created_at when omitted.
`sort_direction_query_parameter`	Optional[models.ListSortDirection]	:heavy_minus_sign:	Defaults to descending for timestamp fields and ascending for text fields.
`sort_by`	Optional[str]	:heavy_minus_sign:	REST-friendly alias for sort.field. Supported values: created_at, last_modified_at, name, title.
`sort_direction_query_parameter1`	Optional[str]	:heavy_minus_sign:	REST-friendly alias for sort.direction. Supported values: asc, desc.
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.SkillsListResponse

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

create

CreateSkill

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.create(name="<value>", definition={})

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`name`	str	:heavy_check_mark:	Stable object name.
`definition`	models.SkillDefinition	:heavy_check_mark:	Versioned skill content.
`notes`	OptionalNullable[str]	:heavy_minus_sign:	Notes for this version.
`sharing_scope`	Optional[models.RegistrySharingScope]	:heavy_minus_sign:	N/A
`aliases`	List[str]	:heavy_minus_sign:	Aliases pointing to this version.
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.Skill

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

get

GetSkill

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.get(skill_id="<id>", version=1)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description	Example
`skill_id`	str	:heavy_check_mark:	N/A
`version`	Optional[int]	:heavy_minus_sign:	N/A	1
`alias`	Optional[str]	:heavy_minus_sign:	N/A
`fields`	List[str]	:heavy_minus_sign:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.Skill

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

delete

DeleteSkill

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.delete(skill_id="<id>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`skill_id`	str	:heavy_check_mark:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.DeleteSkillResponse

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

update_metadata

UpdateSkill

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.update_metadata(skill_id="<id>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`skill_id`	str	:heavy_check_mark:	N/A
`sharing_scope`	Optional[models.RegistrySharingScope]	:heavy_minus_sign:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.Skill

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

list_versions

ListSkillVersions

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.list_versions(skill_id="<id>")

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`skill_id`	str	:heavy_check_mark:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.ListSkillVersionsResponse

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

create_version

CreateSkillVersion

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.create_version(skill_id="<id>", definition={})

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description
`skill_id`	str	:heavy_check_mark:	N/A
`definition`	models.SkillDefinition	:heavy_check_mark:	Versioned skill content.
`notes`	OptionalNullable[str]	:heavy_minus_sign:	Notes for this version.
`aliases`	List[str]	:heavy_minus_sign:	Aliases pointing to this version.
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.CreateSkillVersionResponse

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

get_version

GetSkillVersion

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.get_version(skill_id="<id>", version=1)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description	Example
`skill_id`	str	:heavy_check_mark:	N/A
`version`	int	:heavy_check_mark:	N/A	1
`fields`	List[str]	:heavy_minus_sign:	N/A
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.Skill

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/

update_version_metadata

UpdateSkillVersionMetadata

Example Usage

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.skills.update_version_metadata(skill_id="<id>", version=1)

    # Handle response
    print(res)

Parameters

Parameter	Type	Required	Description	Example
`skill_id`	str	:heavy_check_mark:	N/A
`version`	int	:heavy_check_mark:	N/A	1
`notes`	OptionalNullable[str]	:heavy_minus_sign:	Notes for this version.
`aliases`	Optional[models.AliasList]	:heavy_minus_sign:	Presence wrapper for a set of alias labels on update RPCs. As a message field it carries presence, so callers can distinguish "leave aliases unchanged" (field omitted) from "clear all aliases" (field set, empty `values`).
`retries`	Optional[utils.RetryConfig]	:heavy_minus_sign:	Configuration to override the default retry behavior of the client.

Response

models.Skill

Errors

Error Type	Status Code	Content Type
errors.SDKError	4XX, 5XX	/