Skip to content

Tag

thingiverse.api.tag

Contains endpoint functions for accessing the API

get_tags

asyncio(*, client) async

Get the list of tags.

returns a list of all tags in alphabetical order.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema] | None

GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]

Source code in thingiverse/api/tag/get_tags.py
async def asyncio(
    *,
    client: AuthenticatedClient,
) -> GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema] | None:
    """Get the list of tags.

     returns a list of all tags in alphabetical order.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]
    """

    return (
        await asyncio_detailed(
            client=client,
        )
    ).parsed

asyncio_detailed(*, client) async

Get the list of tags.

returns a list of all tags in alphabetical order.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]

Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]

Source code in thingiverse/api/tag/get_tags.py
async def asyncio_detailed(
    *,
    client: AuthenticatedClient,
) -> Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]:
    """Get the list of tags.

     returns a list of all tags in alphabetical order.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]
    """

    kwargs = _get_kwargs()

    response = await client.get_async_httpx_client().request(**kwargs)

    return _build_response(client=client, response=response)

sync(*, client)

Get the list of tags.

returns a list of all tags in alphabetical order.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema] | None

GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]

Source code in thingiverse/api/tag/get_tags.py
def sync(
    *,
    client: AuthenticatedClient,
) -> GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema] | None:
    """Get the list of tags.

     returns a list of all tags in alphabetical order.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]
    """

    return sync_detailed(
        client=client,
    ).parsed

sync_detailed(*, client)

Get the list of tags.

returns a list of all tags in alphabetical order.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]

Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]

Source code in thingiverse/api/tag/get_tags.py
def sync_detailed(
    *,
    client: AuthenticatedClient,
) -> Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]:
    """Get the list of tags.

     returns a list of all tags in alphabetical order.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsResponse401 | GetTagsResponse403 | GetTagsResponse404 | list[TagSchema]]
    """

    kwargs = _get_kwargs()

    response = client.get_httpx_client().request(
        **kwargs,
    )

    return _build_response(client=client, response=response)

asyncio(*, client) async

Get the list of random popular tags.

returns a list of popular tags which reset every day.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema] | None

GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]

Source code in thingiverse/api/tag/get_tags_0_popular.py
async def asyncio(
    *,
    client: AuthenticatedClient,
) -> (
    GetTags0PopularResponse401
    | GetTags0PopularResponse403
    | GetTags0PopularResponse404
    | list[TagSchema]
    | None
):
    """Get the list of random popular tags.

     returns a list of popular tags which reset every day.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]
    """

    return (
        await asyncio_detailed(
            client=client,
        )
    ).parsed

asyncio_detailed(*, client) async

Get the list of random popular tags.

returns a list of popular tags which reset every day.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]]

Response[GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]]

Source code in thingiverse/api/tag/get_tags_0_popular.py
async def asyncio_detailed(
    *,
    client: AuthenticatedClient,
) -> Response[
    GetTags0PopularResponse401
    | GetTags0PopularResponse403
    | GetTags0PopularResponse404
    | list[TagSchema]
]:
    """Get the list of random popular tags.

     returns a list of popular tags which reset every day.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]]
    """

    kwargs = _get_kwargs()

    response = await client.get_async_httpx_client().request(**kwargs)

    return _build_response(client=client, response=response)

sync(*, client)

Get the list of random popular tags.

returns a list of popular tags which reset every day.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema] | None

GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]

Source code in thingiverse/api/tag/get_tags_0_popular.py
def sync(
    *,
    client: AuthenticatedClient,
) -> (
    GetTags0PopularResponse401
    | GetTags0PopularResponse403
    | GetTags0PopularResponse404
    | list[TagSchema]
    | None
):
    """Get the list of random popular tags.

     returns a list of popular tags which reset every day.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]
    """

    return sync_detailed(
        client=client,
    ).parsed

sync_detailed(*, client)

Get the list of random popular tags.

returns a list of popular tags which reset every day.

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]]

Response[GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]]

Source code in thingiverse/api/tag/get_tags_0_popular.py
def sync_detailed(
    *,
    client: AuthenticatedClient,
) -> Response[
    GetTags0PopularResponse401
    | GetTags0PopularResponse403
    | GetTags0PopularResponse404
    | list[TagSchema]
]:
    """Get the list of random popular tags.

     returns a list of popular tags which reset every day.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTags0PopularResponse401 | GetTags0PopularResponse403 | GetTags0PopularResponse404 | list[TagSchema]]
    """

    kwargs = _get_kwargs()

    response = client.get_httpx_client().request(
        **kwargs,
    )

    return _build_response(client=client, response=response)

get_tags_tag

asyncio(tag, *, client) async

Return a representation of the given tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema | None

GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema

Source code in thingiverse/api/tag/get_tags_tag.py
async def asyncio(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema | None:
    """Return a representation of the given tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema
    """

    return (
        await asyncio_detailed(
            tag=tag,
            client=client,
        )
    ).parsed

asyncio_detailed(tag, *, client) async

Return a representation of the given tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]

Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]

Source code in thingiverse/api/tag/get_tags_tag.py
async def asyncio_detailed(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]:
    """Return a representation of the given tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]
    """

    kwargs = _get_kwargs(
        tag=tag,
    )

    response = await client.get_async_httpx_client().request(**kwargs)

    return _build_response(client=client, response=response)

sync(tag, *, client)

Return a representation of the given tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema | None

GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema

Source code in thingiverse/api/tag/get_tags_tag.py
def sync(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema | None:
    """Return a representation of the given tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema
    """

    return sync_detailed(
        tag=tag,
        client=client,
    ).parsed

sync_detailed(tag, *, client)

Return a representation of the given tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]

Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]

Source code in thingiverse/api/tag/get_tags_tag.py
def sync_detailed(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]:
    """Return a representation of the given tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsTagResponse401 | GetTagsTagResponse403 | GetTagsTagResponse404 | TagSchema]
    """

    kwargs = _get_kwargs(
        tag=tag,
    )

    response = client.get_httpx_client().request(
        **kwargs,
    )

    return _build_response(client=client, response=response)

get_tags_tag_search_tags

asyncio(tag, *, client) async

Search tags by tag name.

Returns a list of all tags where the search word is included in the name.

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item] | None

GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]

Source code in thingiverse/api/tag/get_tags_tag_search_tags.py
async def asyncio(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> (
    GetTagsTagSearchTagsResponse401
    | GetTagsTagSearchTagsResponse403
    | GetTagsTagSearchTagsResponse404
    | list[GetTagsTagSearchTagsResponse200Item]
    | None
):
    """Search tags by tag name.

     Returns a list of all tags where the search word is included in the name.

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]
    """

    return (
        await asyncio_detailed(
            tag=tag,
            client=client,
        )
    ).parsed

asyncio_detailed(tag, *, client) async

Search tags by tag name.

Returns a list of all tags where the search word is included in the name.

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]]

Response[GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]]

Source code in thingiverse/api/tag/get_tags_tag_search_tags.py
async def asyncio_detailed(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> Response[
    GetTagsTagSearchTagsResponse401
    | GetTagsTagSearchTagsResponse403
    | GetTagsTagSearchTagsResponse404
    | list[GetTagsTagSearchTagsResponse200Item]
]:
    """Search tags by tag name.

     Returns a list of all tags where the search word is included in the name.

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]]
    """

    kwargs = _get_kwargs(
        tag=tag,
    )

    response = await client.get_async_httpx_client().request(**kwargs)

    return _build_response(client=client, response=response)

sync(tag, *, client)

Search tags by tag name.

Returns a list of all tags where the search word is included in the name.

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item] | None

GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]

Source code in thingiverse/api/tag/get_tags_tag_search_tags.py
def sync(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> (
    GetTagsTagSearchTagsResponse401
    | GetTagsTagSearchTagsResponse403
    | GetTagsTagSearchTagsResponse404
    | list[GetTagsTagSearchTagsResponse200Item]
    | None
):
    """Search tags by tag name.

     Returns a list of all tags where the search word is included in the name.

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]
    """

    return sync_detailed(
        tag=tag,
        client=client,
    ).parsed

sync_detailed(tag, *, client)

Search tags by tag name.

Returns a list of all tags where the search word is included in the name.

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]]

Response[GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]]

Source code in thingiverse/api/tag/get_tags_tag_search_tags.py
def sync_detailed(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> Response[
    GetTagsTagSearchTagsResponse401
    | GetTagsTagSearchTagsResponse403
    | GetTagsTagSearchTagsResponse404
    | list[GetTagsTagSearchTagsResponse200Item]
]:
    """Search tags by tag name.

     Returns a list of all tags where the search word is included in the name.

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsTagSearchTagsResponse401 | GetTagsTagSearchTagsResponse403 | GetTagsTagSearchTagsResponse404 | list[GetTagsTagSearchTagsResponse200Item]]
    """

    kwargs = _get_kwargs(
        tag=tag,
    )

    response = client.get_httpx_client().request(
        **kwargs,
    )

    return _build_response(client=client, response=response)

get_tags_tag_things

asyncio(tag, *, client) async

Get the latest things with the specified tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema] | None

GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]

Source code in thingiverse/api/tag/get_tags_tag_things.py
async def asyncio(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> (
    GetTagsTagThingsResponse401
    | GetTagsTagThingsResponse403
    | GetTagsTagThingsResponse404
    | list[ThingSchema]
    | None
):
    """Get the latest things with the specified tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]
    """

    return (
        await asyncio_detailed(
            tag=tag,
            client=client,
        )
    ).parsed

asyncio_detailed(tag, *, client) async

Get the latest things with the specified tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]]

Response[GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]]

Source code in thingiverse/api/tag/get_tags_tag_things.py
async def asyncio_detailed(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> Response[
    GetTagsTagThingsResponse401
    | GetTagsTagThingsResponse403
    | GetTagsTagThingsResponse404
    | list[ThingSchema]
]:
    """Get the latest things with the specified tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]]
    """

    kwargs = _get_kwargs(
        tag=tag,
    )

    response = await client.get_async_httpx_client().request(**kwargs)

    return _build_response(client=client, response=response)

sync(tag, *, client)

Get the latest things with the specified tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema] | None

GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]

Source code in thingiverse/api/tag/get_tags_tag_things.py
def sync(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> (
    GetTagsTagThingsResponse401
    | GetTagsTagThingsResponse403
    | GetTagsTagThingsResponse404
    | list[ThingSchema]
    | None
):
    """Get the latest things with the specified tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]
    """

    return sync_detailed(
        tag=tag,
        client=client,
    ).parsed

sync_detailed(tag, *, client)

Get the latest things with the specified tag

Tags are normalized before searching by converting whitespace to underscores and stripping out all characters except alphanumerics, underscores, and dashes ('-').

Parameters:

Name Type Description Default
tag str

Example: 3d.

required

Raises:

Type Description
UnexpectedStatus

If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

TimeoutException

If the request takes longer than Client.timeout.

Returns:

Type Description
Response[GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]]

Response[GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]]

Source code in thingiverse/api/tag/get_tags_tag_things.py
def sync_detailed(
    tag: str,
    *,
    client: AuthenticatedClient,
) -> Response[
    GetTagsTagThingsResponse401
    | GetTagsTagThingsResponse403
    | GetTagsTagThingsResponse404
    | list[ThingSchema]
]:
    """Get the latest things with the specified tag

     Tags are normalized before searching by converting whitespace to underscores and stripping out all
    characters except alphanumerics, underscores, and dashes ('-').

    Args:
        tag (str):  Example: 3d.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.

    Returns:
        Response[GetTagsTagThingsResponse401 | GetTagsTagThingsResponse403 | GetTagsTagThingsResponse404 | list[ThingSchema]]
    """

    kwargs = _get_kwargs(
        tag=tag,
    )

    response = client.get_httpx_client().request(
        **kwargs,
    )

    return _build_response(client=client, response=response)