Update a Directory

put

https://api.vcita.biz/v3/business_administration/directories/{uid}

Updates an existing directory. Only provided fields will be modified; omitted fields remain unchanged.

Available for Internal tokens

Path Params

uid

string

required

The unique identifier of the directory

Body Params

name

string

Name of the directory. Used only internally.

partner_name

string

Partner-facing display name for the directory.

parent_directory_id

integer | null

ID of the parent directory, if this directory is a child of another directory.

admin_email

string

Administrative contact email for the directory.

billing_type

string

enum

Billing type for the directory.

Allowed:

manual_type

string | null

enum

Manual type of the directory.

Allowed:

configuration_key

string

Configuration key for the directory.

branding_theme_id

string | null

ID of the branding theme applied to the directory.

management_theme_id

string | null

ID of the management theme applied to the directory.

management_theme_attributes

object

Attributes for the management theme associated with the directory.

is_managed

boolean

Indicates if the directory is managed by a partner.

is_deprecated

boolean

Indicates if the directory is deprecated.

is_slim_register_enabled

boolean

Indicates if slim registration mode is enabled during onboarding.

locale

string

Default locale for the directory.

time_zone

string

Default time zone for the directory.

paypal_email

string

PayPal email for the directory.

rev_share

number

Revenue share percentage.

rev_share_tier2

number | null

Revenue share percentage for tier 2.

only_owner_login_redirect

boolean

When true, only the business owner is redirected to the logout URL on logout.

custom_sms_sending_phone_number

string

Custom SMS sending phone number.

settings

object

Directory settings and configuration options. Only provided sub-fields will be updated.

welcome_engagement_params

object | null

Welcome engagement parameters.

is_unsubscribe_sms

boolean

Indicates if unsubscribe text is added to SMS messages.

is_disable_analytics

boolean

Indicates if analytics are disabled.

is_content_manager_enabled

boolean

Indicates if the directory is added to Verticalization (content manager).

is_user_identity_manager_enabled

boolean

Indicates if the directory manages user identities.

default_package_id

integer

Default package ID assigned to new businesses in this directory.

is_default_self_paid

boolean

Indicates if default self paid is enabled.

mobile_app_name

string

Mobile app name.

mobile_app_ios

string

iOS mobile app URL.

mobile_app_android

string

Android mobile app URL.

email_template_owner_uid

string

Email template owner UID.

urls

object

Collection of setup URLs. Only provided sub-fields will be updated.

domain_hosting

object

Domain and hosting configuration. Only provided sub-fields will be updated.

configs

array of strings

Directory-level configuration flags.

Responses

401

Unauthorized

403

Forbidden

404

Directory not found

500

Internal server error

200Directory updated successfully.

400Bad Request - Malformed request or invalid syntax.

422Unprocessable Entity - Validation error.