Skip to content
This repository was archived by the owner on Nov 6, 2026. It is now read-only.

Latest commit

 

History

History
138 lines (93 loc) · 4.26 KB

terms_of_services.md

File metadata and controls

138 lines (93 loc) · 4.26 KB

TermsOfServicesManager

Caution

box-python-sdk-gen is deprecated and no longer maintained. As of September 17, 2025, it receives no new features, bug fixes, or security patches. Do not use it for new projects.

Use box-python-sdk v10+ instead: pip install "boxsdk>=10". The equivalent of this page is box-python-sdk/docs/terms_of_services.md. To migrate existing code, see the migration guide.

List terms of services

Returns the current terms of service text and settings for the enterprise.

This operation is performed by calling function get_terms_of_service.

See the endpoint docs at API Reference.

client.terms_of_services.get_terms_of_service()

Arguments

  • tos_type Optional[GetTermsOfServiceTosType]
    • Limits the results to the terms of service of the given type.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type TermsOfServices.

Returns a collection of terms of service text and settings for the enterprise.

Create terms of service

Creates a terms of service for a given enterprise and type of user.

This operation is performed by calling function create_terms_of_service.

See the endpoint docs at API Reference.

client.terms_of_services.create_terms_of_service(
    CreateTermsOfServiceStatus.DISABLED,
    "Test TOS",
    tos_type=CreateTermsOfServiceTosType.MANAGED,
)

Arguments

  • status CreateTermsOfServiceStatus
    • Whether this terms of service is active.
  • tos_type Optional[CreateTermsOfServiceTosType]
    • The type of user to set the terms of service for.
  • text str
    • The terms of service text to display to users. The text can be set to empty if the status is set to disabled.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type TermsOfService.

Returns a new task object.

Get terms of service

Fetches a specific terms of service.

This operation is performed by calling function get_terms_of_service_by_id.

See the endpoint docs at API Reference.

Currently we don't have an example for calling get_terms_of_service_by_id in integration tests

Arguments

  • terms_of_service_id str
    • The ID of the terms of service. Example: "324234"
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type TermsOfService.

Returns a terms of service object.

Update terms of service

Updates a specific terms of service.

This operation is performed by calling function update_terms_of_service_by_id.

See the endpoint docs at API Reference.

client.terms_of_services.update_terms_of_service_by_id(
    tos.id, UpdateTermsOfServiceByIdStatus.DISABLED, "TOS"
)

Arguments

  • terms_of_service_id str
    • The ID of the terms of service. Example: "324234"
  • status UpdateTermsOfServiceByIdStatus
    • Whether this terms of service is active.
  • text str
    • The terms of service text to display to users. The text can be set to empty if the status is set to disabled.
  • extra_headers Optional[Dict[str, Optional[str]]]
    • Extra headers that will be included in the HTTP request.

Returns

This function returns a value of type TermsOfService.

Returns an updated terms of service object.