Skip to content

Attributes

add_attribute async

add_attribute(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [ADD]))
    ],
    db: Annotated[Session, Depends(get_db)],
    event_id: Annotated[UUID | int, Path(alias=eventId)],
    body: AddAttributeBody,
) -> AddAttributeResponse

Add a new attribute with the given details.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [ADD]))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
event_id Annotated[UUID | int, Path(alias=eventId)]

the ID or UUID of the event

required
body AddAttributeBody

the body for adding an attribute

required

Returns:

Type Description
AddAttributeResponse

the response of the added attribute from the api

add_attribute_depr async

add_attribute_depr(
    auth: Annotated[Auth, Depends(authorize(HYBRID, []))],
    db: Annotated[Session, Depends(get_db)],
    event_id: Annotated[int, Path(alias=eventId)],
    body: AddAttributeBody,
) -> AddAttributeResponse

Deprecated. Add a new attribute with the given details using the old route.

args:

the user's authentification status

the current database

the id of the event

the body

returns:

the attribute

add_tag_to_attribute async

add_tag_to_attribute(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [TAGGER]))
    ],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[
        int | UUID, Path(alias=attributeId)
    ],
    tag_id: Annotated[str, Path(alias=tagId)],
    local: str,
) -> AddRemoveTagAttributeResponse

Add a tag to an attribute by there IDs.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [TAGGER]))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
attribute_id Annotated[int | UUID, Path(alias=attributeId)]

the ID or UUID of the attribute

required
tag_id Annotated[str, Path(alias=tagId)]

the ID of the tag

required
local str

"1" for local

required

Returns:

Type Description
AddRemoveTagAttributeResponse

the response from the api for adding a tag to an attribute

delete_attribute async

delete_attribute(
    auth: Annotated[Auth, Depends(authorize(HYBRID, []))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[
        int | UUID, Path(alias=attributeId)
    ],
    hard: bool = False,
) -> DeleteAttributeResponse

Delete an attribute by either by its ID or UUID.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, []))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
attribute_id Annotated[int | UUID, Path(alias=attributeId)]

the ID or UUID of the attribute

required

Returns:

Type Description
DeleteAttributeResponse

the response from the api for the delete request

delete_attribute_depr async

delete_attribute_depr(
    auth: Annotated[Auth, Depends(authorize(HYBRID, []))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[int, Path(alias=attributeId)],
    hard: bool = False,
) -> DeleteAttributeResponse

Deprecated. Delete an attribute by its ID using the old route.

args:

the user's authentification status

the current database

the id of the attribute

returns:

the response from the api for the deleting request

get_attribute_details async

get_attribute_details(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[
        int | UUID, Path(alias=attributeId)
    ],
) -> GetAttributeResponse

Retrieve details of a specific attribute by either by its ID or UUID.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
attribute_id Annotated[int | UUID, Path(alias=attributeId)]

the ID or UUID of the attribute

required

Returns:

Type Description
GetAttributeResponse

the attribute details

get_attribute_details_depr async

get_attribute_details_depr(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[int, Path(alias=attributeId)],
) -> GetAttributeResponse

Deprecated. Retrieve details of a specific attribute by its ID using the old route.

args:

the user's authentification status

the current database

the id of the attribute

returns:

the details of an attribute

get_attributes async

get_attributes(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
    db: Annotated[Session, Depends(get_db)],
) -> list[GetAllAttributesResponse]

Retrieve a list of all attributes.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID))]

the user's authentification status

required

Returns:

Type Description
list[GetAllAttributesResponse]

the list of all attributes

get_attributes_category_statistics async

get_attributes_category_statistics(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
    db: Annotated[Session, Depends(get_db)],
    percentage: bool,
) -> GetAttributeStatisticsCategoriesResponse

Get the count/percentage of attributes per category/type.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
percentage bool

percentage request or not

required

Returns:

Type Description
GetAttributeStatisticsCategoriesResponse

the attributes statistics for one category/type

get_attributes_describe_types async

get_attributes_describe_types(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
) -> GetDescribeTypesResponse

Retrieve a list of all available attribute types and categories.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID))]

the user's authentification status

required

Returns:

Type Description
GetDescribeTypesResponse

the attributes describe types

get_attributes_type_statistics async

get_attributes_type_statistics(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
    db: Annotated[Session, Depends(get_db)],
    percentage: bool,
) -> GetAttributeStatisticsTypesResponse

Get the count/percentage of attributes per category/type.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
percentage bool

percentage request or not

required

Returns:

Type Description
GetAttributeStatisticsTypesResponse

the attributes statistics for one category/type

remove_tag_from_attribute async

remove_tag_from_attribute(
    auth: Annotated[
        Auth, Depends(authorize(HYBRID, [TAGGER]))
    ],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[
        int | UUID, Path(alias=attributeId)
    ],
    tag_id: Annotated[str, Path(alias=tagId)],
) -> AddRemoveTagAttributeResponse

Remove a tag from an attribute by there IDs.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, [TAGGER]))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
attribute_id Annotated[int | UUID, Path(alias=attributeId)]

the ID or UUID of the attribute

required
tag_id Annotated[str, Path(alias=tagId)]

the ID of the tag

required

Returns:

Type Description
AddRemoveTagAttributeResponse

the response from the api for removing a tag to an attribute

rest_search_attributes async

rest_search_attributes(
    auth: Annotated[Auth, Depends(authorize(HYBRID))],
    db: Annotated[Session, Depends(get_db)],
    body: SearchAttributesBody,
) -> SearchAttributesResponse

Search for attributes based on various filters.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
body SearchAttributesBody

the search body

required

Returns:

Type Description
SearchAttributesResponse

the attributes the search finds

restore_attribute async

restore_attribute(
    auth: Annotated[Auth, Depends(authorize(HYBRID, []))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[
        int | UUID, Path(alias=attributeId)
    ],
) -> GetAttributeResponse

Restore an attribute either by its ID or UUID.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, []))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
attribute_id Annotated[int | UUID, Path(alias=attributeId)]

the ID or UUID of the attribute

required

Returns:

Type Description
GetAttributeResponse

the restored attribute

update_attribute async

update_attribute(
    auth: Annotated[Auth, Depends(authorize(HYBRID, []))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[
        int | UUID, Path(alias=attributeId)
    ],
    body: EditAttributeBody,
) -> EditAttributeResponse

Update an existing attribute by its ID.

Parameters:

Name Type Description Default
auth Annotated[Auth, Depends(authorize(HYBRID, []))]

the user's authentification status

required
db Annotated[Session, Depends(get_db)]

the current database

required
attribute_id Annotated[int | UUID, Path(alias=attributeId)]

the ID or UUID of the attribute

required
body EditAttributeBody

the body for editing the attribute

required

Returns:

Type Description
EditAttributeResponse

the response from the api for the edit/update request

update_attribute_depr async

update_attribute_depr(
    auth: Annotated[Auth, Depends(authorize(HYBRID, []))],
    db: Annotated[Session, Depends(get_db)],
    attribute_id: Annotated[int, Path(alias=attributeId)],
    body: EditAttributeBody,
) -> EditAttributeResponse

Deprecated. Update an existing attribute by its ID using the old route.

args:

the user's authentification status

the current database

the id of the attribute

the body

returns:

the updated version af an attribute