# Digicert

DigiCert is a leading provider of high-assurance TLS/SSL, PKI, IoT, and signing solutions, enabling secure digital interactions worldwide.

- **Category:** security & identity tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 101
- **Triggers:** 0
- **Slug:** `DIGICERT`
- **Version:** 20260313_00

## Tools

### Add Tags to Certificate

**Slug:** `DIGICERT_ADD_TAGS_TO_CERTIFICATE`

Tool to add custom tags to one or more certificates for categorization. Use when you need to organize or label certificates with custom tags for easier management and filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | string | Yes | Custom user tags for categorizing certificates. Use meaningful labels to organize and manage certificates. |
| `certId` | array | Yes | List of unique DigiCert-generated certificate IDs found on endpoints. Each ID is a hash string identifying a specific certificate. |
| `accountId` | string | Yes | Account identifier for the DigiCert account |
| `divisionIds` | array | No | Optional list of division identifiers to filter certificate scope |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Permission

**Slug:** `DIGICERT_CHECK_PERMISSION`

Tool to check if a specific permission is available. Use when validating that the authenticated user may perform an operation before attempting it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `permission` | string | Yes | The specific permission to verify. e.g. 'cert:create', 'cert:reissue'. See https://dev.digicert.com/en/certcentral-apis/glossary.html#permissions |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create API Key

**Slug:** `DIGICERT_CREATE_API_KEY`

Tool to create a new API key with specified permissions. Use when you have a valid DigiCert user_id and need to generate a new key. Note the API key appears only once; save it securely.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the API key. Choose a meaningful label. |
| `user_id` | integer | Yes | DigiCert user ID for whom to generate the API key. |
| `restricted_to_role_id` | integer ("0" | "100" | "101" | "102" | "103") | No | Optional API key role ID to limit permissions. Allowed values: 0, 100, 101, 102, 103. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create AuthKey

**Slug:** `DIGICERT_CREATE_AUTH_KEY`

Tool to create a new AuthKey for account authentication. Use when you need to generate a new AuthKey, either permanent or with a specific validity period (TTL).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | integer | No | Optional validity period in days for Time-to-Live (TTL) AuthKeys. If not specified, creates a permanent AuthKey (until manually deleted). Minimum value is 1 day. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Container IP Rules

**Slug:** `DIGICERT_CREATE_CONTAINER_IP_RULES`

Tool to add an IP restriction rule to a CertCentral account. Use when you need to limit API or user access to specific IP address ranges for enhanced security.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | No | ID of user to create the rule for. Mutually exclusive with api_key_id. |
| `api_key_id` | integer | No | ID of API key to create the rule for. Mutually exclusive with user_id. |
| `ip_address` | string | Yes | Starting IP address in allowed address range. IPv4 format required (e.g., 192.0.2.100). |
| `description` | string | No | Custom rule description for documentation purposes. |
| `container_id` | integer | Yes | ID of the top-level account container (division). Retrieve this value from the List containers endpoint; it's the container with parent_id of 0. |
| `ip_address_end` | string | Yes | Ending IP address in allowed address range. IPv4 format required. For single IP, use same value as ip_address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Finance Order Pricing

**Slug:** `DIGICERT_CREATE_FINANCE_ORDER_PRICING`

Tool to get price estimates for a certificate order. Use when you need to calculate the cost of a certificate before placing an order, including base price, add-ons, tax estimates, and total cost. For Code Signing/EV Code Signing with hardware tokens or KeyLocker, include the corresponding add-on IDs for accurate estimates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `addons` | array | No | List of product IDs for order add-ons (e.g., hardware tokens, KeyLocker for Code Signing products). |
| `certificate` | object | Yes | Details about the domains to secure with the certificate. |
| `order_validity` | object | No | Order validity details for products that support multi-year plans. Overrides validity_years when provided. |
| `validity_years` | integer | Yes | Validity period for the order, in years. Valid values vary by product. |
| `billing_address` | object | No | Billing address details used to calculate estimated tax. |
| `product_name_id` | string | Yes | Certificate product identifier to order (e.g., 'ssl_basic', 'ssl_plus', 'ssl_wildcard', 'ssl_ev_plus'). |
| `is_out_of_contract` | integer | No | Non-contract pricing flag. Use 1 for out-of-contract pricing, 0 for contract pricing. Defaults to 0. |
| `renewal_of_order_valid_till` | string | No | Expiration date of the order being renewed, in YYYY-MM-DD format. Use when estimating renewal order pricing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization

**Slug:** `DIGICERT_CREATE_ORGANIZATION`

Tool to create a new organization in your DigiCert CertCentral account. Use when you need to add a new organization with required details like legal name, address, contact information, and country.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | Yes | Postal code. Max 40 characters. |
| `city` | string | Yes | City location. Max 64 characters. |
| `name` | string | Yes | Legal name of the organization. Max 64 characters. |
| `state` | string | Yes | State or province. Use full name not abbreviation. |
| `address` | string | Yes | Organization street address. Max 64 characters. |
| `country` | string | Yes | Two-letter ISO 3166-1 alpha-2 country code. |
| `address2` | string | No | Second address line for additional address details. |
| `telephone` | string | Yes | Organization phone number. Max 32 characters. |
| `validations` | array | No | Array of validation submissions for prevalidation. |
| `assumed_name` | string | No | DBA (Doing Business As) name for the organization. |
| `organization_contact` | object | Yes | Contact details for the organization including first_name, last_name, email, and telephone (all required). |
| `skip_duplicate_org_check` | boolean | No | Override duplicate organization checking. Set to true to bypass duplicate detection. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization Validation

**Slug:** `DIGICERT_CREATE_ORGANIZATION_VALIDATION`

Tool to submit an organization for validation and add verified contacts for specific product types. Use when you need to validate an organization for certificate issuance. Note: EV, CS, and EV_CS validation types require verified users.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `validations` | array | Yes | List of validation types the organization will be validated for. Must contain at least one validation. |
| `organization_id` | integer | Yes | The ID of the organization to submit for validation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Scan Templates

**Slug:** `DIGICERT_CREATE_SCAN_LIST`

Tool to retrieve the list of scan templates along with their name, status, and configuration. Use when you need to view or manage DigiCert Discovery scans with support for filtering by division, state, and other criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | The account identifier for the DigiCert account. |
| `sort_order` | string ("ASC" | "DESC") | No | Sort order options for scan list. |
| `division_ids` | array | Yes | Array of division identifiers to filter scans by division. |
| `is_from_wall_alert` | boolean | No | Filter for scans originating from wall alerts. |
| `search_criteria_list` | array | No | List of filtering criteria to refine scan results. Each criterion has key, value, and operation fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Account AuthKey

**Slug:** `DIGICERT_DELETE_ACCOUNT_AUTH_KEY`

Tool to delete your account's AuthKey. Use when you need to revoke an existing AuthKey. If no auth_key_id is specified, deletes the primary AuthKey.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `auth_key_id` | string | No | Unique identifier for a specific AuthKey to delete. If not provided, deletes the account's primary AuthKey. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Certificate from Discovery

**Slug:** `DIGICERT_DELETE_CERTIFICATE`

Tool to delete certificates from DigiCert Discovery inventory. Use when you need to remove one or more certificates identified by their certificate IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cert_id` | array | Yes | List of certificate IDs to remove from inventory. |
| `account_id` | string | Yes | Your DigiCert account identifier. |
| `division_ids` | array | No | Optional list of division identifiers to scope the deletion. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Domain

**Slug:** `DIGICERT_DELETE_DOMAIN`

Tool to delete a domain with the given ID. Use when you need to remove a domain from the CertCentral account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | integer | Yes | The identifier for the domain to be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete SSH Key

**Slug:** `DIGICERT_DELETE_KEY`

Tool to delete SSH keys from DigiCert Discovery. Use when you need to remove one or more SSH keys by their names.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | Account ID for the DigiCert Discovery account. |
| `division_ids` | array | No | User's division IDs. Provide an empty list if not applicable. |
| `key_name_list` | array | Yes | List of one or more SSH key names to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Discovery Endpoints

**Slug:** `DIGICERT_DELETE_REPORTS_ENDPOINTS`

Tool to delete one or more endpoints from the Discovery API. Permanently removes the endpoints and any certificates associated with the scan results. Use when you need to clean up IP/port combinations that should no longer be monitored.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `accountId` | string | Yes | Account ID for the DigiCert account. |
| `ipPortList` | array | Yes | Collection of IP and port pairs representing endpoints to permanently remove. At least one endpoint required. |
| `divisionIds` | array | Yes | List of division IDs. Can be empty array if no specific divisions are targeted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute GraphQL Query

**Slug:** `DIGICERT_EXECUTE_GRAPHQL_QUERY`

Tool to execute GraphQL queries against DigiCert Custom Reports API. Use when you need to retrieve customizable certificate order data using GraphQL syntax. Supports queries like order_details and order_details_by_id with flexible field selection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | GraphQL query string to execute. Must include at least one field. Available queries: order_details (returns details for all certificate orders), order_details_by_id (returns details for a specific order by ID). Example: {order_details(status:"pending",limit:5){id,common_name,status}} or {order_details_by_id(order_id:123456){id,common_name,dns_names,status}} |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Filter Keys

**Slug:** `DIGICERT_FILTER_KEYS`

Tool to filter keys in DigiCert Discovery API by various criteria. Use when you need to search and filter keys based on attributes like name, IP, port, authentication methods, or other key properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Number of records per page. Allowed: 1-100. Default: 50 |
| `account_id` | string | Yes | Account ID to filter keys for |
| `sort_order` | string ("DESC" | "ASC") | No | Sort direction for results. |
| `start_index` | integer | No | Index of the first result. Default: 1 |
| `division_ids` | array | No | List of user's division IDs. Can be empty list. |
| `filter_selected` | string ("name" | "ip" | "port" | "type" | "scanName" | "authenticationMethods" | "keyAlgorithm" | "protocol" | "duplicateKeys") | Yes | The value to show in results. Specifies which attribute to filter keys by. |
| `sorted_column_id` | string | No | Sort results by specified parameter. Default: isCertPresent |
| `search_criteria_list` | array | No | Filter results by specified values. Array of objects with key, operation, and value. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Details

**Slug:** `DIGICERT_GET_ACCOUNT`

Tool to retrieve details about your CertCentral account. Use when you need account information such as billing model, account manager details, or account settings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Details

**Slug:** `DIGICERT_GET_ACCOUNT_DETAILS`

Tool to retrieve account details for the authenticated user. Use when you need to get information about the user assigned to the API key, including profile details, roles, and container assignments.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Guest Access URL

**Slug:** `DIGICERT_GET_ACCOUNT_GUEST_ACCESS`

Tool to retrieve the guest access URL for your DigiCert account. Use when you need to obtain the guest access URL to share with external users.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Metadata

**Slug:** `DIGICERT_GET_ACCOUNT_METADATA`

Tool to retrieve metadata for custom order fields in the account. Use when you need to list custom field configurations including their validation types and display settings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account SAML Entity

**Slug:** `DIGICERT_GET_ACCOUNT_SAML_ENTITY`

Tool to retrieve SAML entity details for your account. Use when you need to check SAML SSO configuration or verify identity provider settings. Returns empty object if no SAML entity is configured.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Agent IP Port Details

**Slug:** `DIGICERT_GET_AGENT_IP_PORT`

Tool to retrieve agent IP port details from DigiCert Discovery API. Use when you need to view IP addresses and ports being monitored by DigiCert agents in a specific account and division.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | integer | Yes | The DigiCert account ID (can be obtained from /services/v2/account endpoint). |
| `division_ids` | array | Yes | Array of division IDs to filter results (use root_container_id from account endpoint). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Alert Count

**Slug:** `DIGICERT_GET_ALERT_COUNT`

Tool to retrieve alert count from DigiCert Discovery API dashboard. Use when you need to query the number of alerts for a specific module (scan, cert, endpoint, etc.) within an account and division.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | Account identifier for the DigiCert account. |
| `cert_status` | string ("REVOKED") | No | Certificate status values. |
| `module_name` | string ("scan" | "cert" | "rotationElapsed" | "endpoint" | "duplicateKeys" | "sensor" | "isKeyDiscovered" | "sensorUpgrade") | Yes | Module name to query alerts for. Options: scan, cert, rotationElapsed, endpoint, duplicateKeys, sensor, isKeyDiscovered, sensorUpgrade. |
| `division_ids` | array | Yes | List of division ID numbers to filter alerts. Can be empty list. |
| `days_to_expire` | integer | No | Days until certificate expiration. Required if moduleName is 'cert' or 'endpoint' and certStatus is not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AuthKey Details

**Slug:** `DIGICERT_GET_AUTH_KEY`

Tool to retrieve AuthKey details by ID. Use when you need to fetch information about an active, inactive, or expired AuthKey.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `authkey_id` | string | Yes | The ID of the AuthKey to retrieve. This is the unique identifier for the AuthKey. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Authorized Containers

**Slug:** `DIGICERT_GET_AUTHORIZATION_CONTAINER`

Tool to list all containers authorized to perform a permission action. Use when checking which containers a user can access for specific operations like viewing, editing, or creating resources.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `permission` | string ("create_containers" | "view_container" | "edit_container" | "manage_guest_keys" | "create_users" | "edit_users" | "view_users" | "add_domains" | "view_domains" | "create_organizations") | Yes | The permission type to query for authorized containers. Determines which containers the user can access for this permission. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Certificate Authority Helper

**Slug:** `DIGICERT_GET_CERTIFICATE_AUTHORITY_HELPER`

Tool to retrieve certificate authority API helper information including version details. Use when verifying API connectivity or checking the current API version.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Certificate Security Rating

**Slug:** `DIGICERT_GET_CERTIFICATE_RATING`

Tool to retrieve SSL certificate security rating from DigiCert Discovery API. Use when you need to assess certificate security posture, view rating details, or audit certificate configurations. Requires valid accountId and certId from DigiCert.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `certId` | string | Yes | Unique DigiCert-generated certificate ID from discovered endpoints. |
| `accountId` | string | Yes | Your DigiCert account identifier. |
| `divisionIds` | array | No | Optional list of division identifiers for scoped queries. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Cloud Scan Details

**Slug:** `DIGICERT_GET_CLOUD_SCAN`

Tool to get cloud scan details from DigiCert Discovery API. Use when you need to retrieve information about an existing cloud scan template including its status and completion percentage.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | Account identifier for the cloud scan. |
| `division_id` | integer | Yes | Division identifier for the cloud scan. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container by ID

**Slug:** `DIGICERT_GET_CONTAINER_BY_CONTAINER`

Tool to get details about a specific container using its ID. Use when you need to retrieve information about a container's configuration, status, and properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | string | Yes | The ID of the container to retrieve details for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container Children

**Slug:** `DIGICERT_GET_CONTAINER_CHILDREN`

Tool to list all child containers for a parent container. Use when you need to retrieve the hierarchy of containers under a specific parent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | Yes | The ID of the parent container whose children you want to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container IP Rules

**Slug:** `DIGICERT_GET_CONTAINER_IP_RULES`

Tool to retrieve a list of existing IP restriction rules in a CertCentral account. Use when you need to audit or manage IP access controls for a specific container.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | Yes | ID of the top-level account container (division). Retrieve this value from the List containers endpoint; it's the container with parent_id of 0. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container Order Organizations

**Slug:** `DIGICERT_GET_CONTAINER_ORDER_ORGANIZATION`

Tool to list all organizations assigned to a container. Use when you need to retrieve organization details and validation information for a specific container.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | string | Yes | The unique identifier for the container. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container Product Limits

**Slug:** `DIGICERT_GET_CONTAINER_PRODUCT_LIMITS`

Tool to get information about the limits and settings for a container's enabled products. Use when you need to check product-specific restrictions for certificate ordering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | Yes | The unique identifier of the container to query for product limits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container Roles

**Slug:** `DIGICERT_GET_CONTAINER_ROLE`

Tool to retrieve all access roles available to a container. Use when you need to list permissions or roles associated with a specific container.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | Yes | The unique identifier for the container |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Container Template Details

**Slug:** `DIGICERT_GET_CONTAINER_TEMPLATE_BY_TEMPLATE`

Tool to get details about a template in a container. Use when you need to retrieve template information including access roles and creation date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | The identifier for the template. |
| `container_id` | string | Yes | The identifier for the specific container. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain DCV Information

**Slug:** `DIGICERT_GET_DOMAIN_DCV`

Tool to retrieve domain DCV (Domain Control Validation) information from DigiCert. Use when you need to check domain validation status, DCV tokens, expiration dates, or validation methods.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | integer | Yes | The unique identifier for the domain to retrieve DCV information for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain DCV Emails

**Slug:** `DIGICERT_GET_DOMAIN_DCV_EMAILS`

Tool to retrieve email addresses that receive validation emails from DigiCert for the email domain control validation (DCV) method. Use when you need to determine which email addresses can be used to validate domain ownership during certificate issuance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | string | Yes | The identifier for the domain. Can be the domain ID or the fully qualified domain name (FQDN). Example: 'example.com' or '12345'. |
| `consider_dcv_email_preferences` | boolean | No | When set to true, filters results to only addresses allowed by account settings. Defaults to false if not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain Expiration Count

**Slug:** `DIGICERT_GET_DOMAIN_EXPIRATION_COUNT`

Tool to get the number of domains in your account with expired or expiring OV or EV domain validations. Use when you need to audit domain validation status across different time ranges.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Domain Validation Type

**Slug:** `DIGICERT_GET_DOMAIN_VALIDATION_TYPE`

Tool to list available validation types for domains. Use when you need to retrieve the supported domain validation types (e.g., OV, EV) and their requirements.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Finance Balance

**Slug:** `DIGICERT_GET_FINANCE_BALANCE`

Tool to view the current balance of your DigiCert account. Use when you need to check available funds, unpaid invoices, or credit limits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | No | Filter results to the specified container when account has multiple divisions. Required for accounts with multiple divisions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Finance Balance History

**Slug:** `DIGICERT_GET_FINANCE_BALANCE_HISTORY`

Tool to list balance adjustment history for your DigiCert account. Use when you need to review financial transactions, track deposits, charges, or refunds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort results by properties. Prefix with '-' for descending order (e.g., 'transaction_date' or '-transaction_date'). |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Index of first result to include for pagination. |
| `filters` | object | No | Filter results by specified properties. Use property names as keys (e.g., {'transaction_type': 'Charge', 'transaction_date': '2024-01-01'}). |
| `container_id` | integer | No | Container ID for balance history retrieval. Required if your account has multiple divisions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Remote Service Information

**Slug:** `DIGICERT_GET_INFO`

Tool to retrieve remote service information from DigiCert Document Manager CSC API. Use when you need details about the remote service such as supported authentication methods, API methods, service description, or language preferences.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | Request a preferred language of the response to the Remote Service, specified according to RFC 3066. If present, the Remote Service shall provide language-specific responses using the specified language. If the specified language is not supported then it shall provide these responses in the language as specified in the lang output parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Key Details

**Slug:** `DIGICERT_GET_KEY_BY_KEY`

Tool to retrieve detailed information about an API key. Use when you need to check key status, owner, creation date, or ACME configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key_id` | integer | Yes | The unique identifier for the API key you want to retrieve information about. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MPKI Version

**Slug:** `DIGICERT_GET_MPKI_VERSION`

Tool to query the TLM application version from DigiCert MPKI API. Use when you need to check the current version of the DigiCert ONE MPKI system.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Order Certificate Status Changes

**Slug:** `DIGICERT_GET_ORDER_CERTIFICATE_STATUS_CHANGES`

Tool to list orders that changed status during a given time frame. Use when you need to track order status changes within a specific time period.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `minutes` | integer | No | Limit results to orders that changed status in the last n minutes (max: 10080 minutes = 7 days). |
| `seconds` | integer | No | Limit results to orders that changed status in the last n seconds (max: 604800 seconds = 7 days). |
| `filters_status_last_updated` | string | No | Date range filter for status changes. Use format 'yyyy-MM-dd...yyyy-MM-dd' or 'yyyy-MM-dd+HH:mm:ss...yyyy-MM-dd+HH:mm:ss' (e.g., '2023-01-01...2023-01-07'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Details

**Slug:** `DIGICERT_GET_ORGANIZATION_BY_ORGANIZATION`

Tool to retrieve detailed information about an organization from DigiCert. Use when you need organization details such as legal name, address, contacts, validation status, or container assignments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | The unique identifier for the organization to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Contact Info

**Slug:** `DIGICERT_GET_ORGANIZATION_CONTACT`

Tool to retrieve organization and technical contact details for a specific organization. Use when you need contact information for administrative or technical purposes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | The unique identifier for the organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Recent Organizations

**Slug:** `DIGICERT_GET_ORGANIZATION_RECENT`

Tool to retrieve the three most recently used organizations from your CertCentral account. Use when you need to quickly access organizations that were recently used for certificate orders or management.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | No | Filter results to the specified container (required only for accounts with multiple divisions). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Validation

**Slug:** `DIGICERT_GET_ORGANIZATION_VALIDATION`

Tool to get validation details for an organization. Use when you need to retrieve approved validation types, statuses, and expiration dates for a specific organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | string | Yes | The unique identifier for the organization whose validation details you want to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Validation Type

**Slug:** `DIGICERT_GET_ORGANIZATION_VALIDATION_TYPE`

Tool to list available validation types for organizations. Use when you need to retrieve the supported organization validation types and their requirements.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Product by Name

**Slug:** `DIGICERT_GET_PRODUCT_BY_NAME`

Tool to get information about a product by its name identifier. Use when you need product details such as validation type, validity periods, supported platforms, or certificate configuration options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name_id` | string | Yes | Product identifier (e.g., ssl_basic, ssl_plus, ssl_wildcard, ssl_ev_plus) |
| `container_id` | integer | No | Container/division ID for customized product settings |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Product Platform Certificate Format Mapping

**Slug:** `DIGICERT_GET_PRODUCT_PLATFORM_CERTFORMAT_MAPPING`

Tool to list the certificate format that is returned for a particular server platform. Use when you need to determine the recommended certificate format for a specific platform or to view all available platform-certificate format mappings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Product Pricing

**Slug:** `DIGICERT_GET_PRODUCT_PRICING`

Tool to retrieve a comprehensive list of product prices available under your DigiCert account. Use when you need pricing information including product names, validity periods, costs, and additional Subject Alternative Names (SANs) pricing.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Remote Service Info

**Slug:** `DIGICERT_GET_REMOTE_SERVICE_INFO`

Tool to retrieve information about DigiCert's Document Manager CSC (Cloud Signature Consortium) remote service. Use when you need service metadata such as supported authentication methods, API version, available methods, or service description.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lang` | string | No | Request a preferred language of the response to the Remote Service, specified according to RFC 3066 (e.g., 'en-US', 'es-ES'). If present, the Remote Service shall provide language-specific responses using the specified language. If the specified language is not supported, responses will be in the language specified in the lang output parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Order Report

**Slug:** `DIGICERT_GET_REPORT_ORDER`

Tool to retrieve a CSV report of all certificate orders. Use when you need to export or analyze certificate order data in bulk with support for pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Total number of results to include in the response. Max: 100,000 Default: 50,000 |
| `offset` | integer | No | Index of the first result to include in the response. Default: 0 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Report Order Expiring

**Slug:** `DIGICERT_GET_REPORT_ORDER_EXPIRING`

Tool to get the number of orders and certificates that expire within 0-30, 30-60, and 60-90 days from now. Use when you need to audit certificate and order expiration status across different time ranges.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | No | Limit results to a specific container. |
| `include_expiring_certs` | boolean | No | When true, includes certificate expiration counts alongside order counts. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Report Request Summary

**Slug:** `DIGICERT_GET_REPORT_REQUEST`

Tool to get total requests and requests by type for your account. Use when you need to retrieve aggregated pending request data categorized by type (new requests, revocations, duplicates, and reissues).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | No | Limit results to a specific container. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Scan Subdomains

**Slug:** `DIGICERT_GET_SCAN_SUBDOMAINS`

Tool to retrieve all subdomains included in a DigiCert Discovery scan. Use when you need to get a list of subdomains for one or more domains from the scan results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domains` | array | Yes | Collection of domain names to scan for subdomains. |
| `accountId` | string | Yes | Account identifier for the DigiCert account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Details

**Slug:** `DIGICERT_GET_USER`

Tool to retrieve details about a specific user in CertCentral. Use when you need user information such as access roles, container assignments, or contact details. Specify 'me' as user_id to get the authenticated user's information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The user's ID, or use 'me' to retrieve the authenticated user's information. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Username Availability

**Slug:** `DIGICERT_GET_USER_AVAILABILITY`

Tool to check if a username is available in DigiCert. Use when you need to verify whether a username can be used before creating a new user account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_name` | string | Yes | The username to check for availability. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List API Access Roles

**Slug:** `DIGICERT_LIST_API_ACCESS_ROLES`

Tool to retrieve a list of available API access roles. Use after confirming authentication with an API key.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List API Keys

**Slug:** `DIGICERT_LIST_API_KEYS`

Tool to retrieve a list of API keys and ACME URLs. Use to view all keys or filter by user_id or container_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | No | Get keys for only the specified user. |
| `container_id` | integer | No | Get keys for only the specified container. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Certificate Filter Values

**Slug:** `DIGICERT_LIST_CERTIFICATE_FILTER_VALUES`

Tool to retrieve available filter values for certificate attributes from DigiCert Discovery API. Use when you need to discover valid values for filtering certificates by common name, organization, status, serial number, security rating, or certificate authority.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Records returned per page (default: 50, maximum: 100). |
| `account_id` | string | Yes | Account identifier for the DigiCert account. |
| `sort_order` | string ("ASC" | "DESC") | No | Sort order direction. |
| `start_index` | integer | No | Beginning position for pagination (default: 1). |
| `division_ids` | array | No | Division identifiers to scope the query. Empty list queries all divisions. |
| `filter_selected` | string ("cn" | "org" | "status" | "serialNumber" | "securityRating" | "ca") | Yes | Specifies which attribute data to retrieve. Options: cn (common name), org (organization), status, serialNumber, securityRating, ca (certificate authority). |
| `sorted_column_id` | string | No | Column identifier to sort results by. |
| `search_criteria_list` | array | No | Filters to narrow results. Each criterion specifies key (matching filterSelected values), operation (e.g., STARTS_WITH), and value array. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Certificate Orders

**Slug:** `DIGICERT_LIST_CERTIFICATE_ORDERS`

Tool to list all certificate orders in your DigiCert account. Use when you need to retrieve order information with support for filtering by status, product, container, and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort field and direction. Prefix with '-' for descending order. Comma-separate for multiple sort fields. Examples: 'date_created', '-date_created', 'status,-date_created'. |
| `limit` | integer | No | Number of results per page. Maximum 1000 (default: 1000). |
| `offset` | integer | No | Starting index for pagination (default: 0). |
| `filters_search` | string | No | Search filter to match email or common_name. Use '%25' prefix for partial matches (e.g., '%25example' to find orders with 'example' in the name). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Certificates

**Slug:** `DIGICERT_LIST_CERTIFICATES`

Tool to list all certificates discovered by DigiCert Discovery scans. Use when you need to retrieve certificate inventory with support for filtering by status, organization, common name, expiration, and other attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageSize` | integer | No | Number of records per page (default: 50, max: 100). |
| `accountId` | string | Yes | Account identifier (required). |
| `sortOrder` | string | No | Sort direction: 'ASC' for ascending or 'DESC' for descending (default: 'ASC'). |
| `startIndex` | integer | No | Starting position for pagination (default: 1). |
| `divisionIds` | array | No | Division identifiers. Can be an empty array to include all divisions. |
| `sortedColumnId` | string | No | Field to sort by. Supported values: 'cn', 'org', 'status', 'serialNum', 'securityRating', 'ca', 'daysToExpire' (default: 'cn'). |
| `searchCriteriaList` | array | No | Filter criteria to narrow down certificate results. Each criterion specifies a key (field name), operation (EQUALS), and array of values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Containers

**Slug:** `DIGICERT_LIST_CONTAINERS`

Tool to retrieve a list of all containers (divisions) in your DigiCert account. Use when you need to view or manage account divisions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Container Templates

**Slug:** `DIGICERT_LIST_CONTAINER_TEMPLATES`

Tool to list all templates that can be used when creating containers. Use when you need to retrieve available container templates for a specific container.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | Yes | The unique identifier for the container |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Domain DCV Methods

**Slug:** `DIGICERT_LIST_DOMAIN_DCV_METHODS`

Tool to retrieve available domain control validation (DCV) methods for domains. Use when you need to know which DCV methods are available for domain verification.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Domains

**Slug:** `DIGICERT_LIST_DOMAINS`

Tool to list all domains in your CertCentral account. Use when you need to retrieve domain information with support for filtering by name, validation status, and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sort results by property. Prefix with '-' for descending order. Examples: 'name', '-date_created'. |
| `limit` | integer | No | Maximum number of results per page (default: 1000, max: 1000). |
| `offset` | integer | No | Starting index for pagination (default: 0). |
| `filters_search` | string | No | Filter domains by name (partial/substring match). Example: 'example' matches 'example.com' and 'test.example.com'. |
| `filters_validation` | string | No | Filter by validation status. Examples: 'completed', 'ov_expired', 'ev_expiring'. |
| `filters_search_criteria` | string | No | Control search type: 'partial' for substring match or 'exact' for exact domain name match. |
| `filters_include_dcv_expiration_time` | boolean | No | Include DCV expiration as UTC ISO-8601 string in the response. |
| `filters_include_validation_reuse_status` | boolean | No | Include detailed validation status and expiration formats in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Intermediate Certificates

**Slug:** `DIGICERT_LIST_INTERMEDIATE_CERTIFICATES`

Tool to retrieve a list of intermediate certificates. Use when you need to list all intermediate certificates for your account. No input required.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Locales

**Slug:** `DIGICERT_LIST_LOCALES`

Tool to retrieve a list of available locales. Use when you need to get supported locale codes and languages for the DigiCert Account Manager API.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organization Potential Approvers

**Slug:** `DIGICERT_LIST_ORGANIZATION_POTENTIAL_APPROVERS`

Tool to list all users and contacts that can be validated as verified contacts (also called EV approvers). Use when you need to identify potential approvers for organization validation.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Organizations

**Slug:** `DIGICERT_LIST_ORGANIZATIONS`

Tool to retrieve all organizations in your DigiCert account. Use when you need to list, search, or audit organizations with support for filtering and pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sorts by property name; prefix with - for descending order (e.g., '-name', 'id'). |
| `limit` | integer | No | Results per response; maximum 1000 (default: 1000). |
| `offset` | integer | No | Index of first result (default: 0). |
| `filters_search` | string | No | Searches by organization ID or name containing specified string. |
| `include_validation` | boolean | No | Returns validation details for organizations (default: false). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Permissions

**Slug:** `DIGICERT_LIST_PERMISSIONS`

Tool to list all permissions for the authenticated user. Use when you need to audit or verify the complete set of permissions available to the current API key.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Available Products

**Slug:** `DIGICERT_LIST_PRODUCTS`

Tool to list all products available to your CertCentral account. Use when you need to discover available certificate products, their validation periods, or supported hash algorithms.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sensors

**Slug:** `DIGICERT_LIST_SENSORS`

Tool to list all sensors used for network scanning in DigiCert Discovery. Use when you need to retrieve sensor inventory with support for filtering by status, name, IP address, and other attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `accountId` | string | Yes | Account identifier (required) |
| `sortOrder` | string ("ASC" | "DESC") | No | Sort direction for sensor list results. |
| `divisionIds` | array | No | User's division ID(s). Can be an empty array to include all divisions. |
| `sortedColumnId` | string ("serialNumber" | "ip" | "port" | "scanName" | "serverSecurity" | "isCertPresent" | "cn" | "name" | "state" | "status") | No | Allowed values for sorting sensor list. |
| `searchCriteriaList` | array | No | Filter criteria to narrow down sensor results. Each criterion specifies a key (field name), operation, and array of values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Service Users

**Slug:** `DIGICERT_LIST_SERVICE_USERS`

Tool to list all DigiCert service users (API-only users). Use when you need to retrieve or audit service user accounts with support for filtering by container, access role, status, or search terms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Sorts results by specified properties. Use '-' prefix for descending order (e.g., '-id', 'email'). |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Index of the first result to include (for pagination). |
| `container_id` | integer | No | Filters results to a specific container by ID. |
| `access_role_id` | integer | No | Limits results to users with the specified access role ID. |
| `filters_search` | string | No | Searches across username, first_name, last_name, or email fields. |
| `filters_status` | string | No | Filters users by status (e.g., 'active', 'inactive'). |
| `without_container` | boolean | No | If true, omits the container object from the response (default: false). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List CertCentral Users

**Slug:** `DIGICERT_LIST_USERS`

Tool to retrieve a list of CertCentral account users. Use when you need to audit or manage users with support for pagination and optional detail inclusion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of users to return (default: 100). |
| `offset` | integer | No | Starting point for the list of users returned. |
| `include_details` | boolean | No | Whether to include additional details for each user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resend User Create Email

**Slug:** `DIGICERT_RESEND_USER_CREATE_EMAIL`

Tool to resend the create user email to a user. Use when you need to resend the account creation email to a user who may not have received it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | The identifier of the user who needs the creation email resent. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Domain for Validation

**Slug:** `DIGICERT_SUBMIT_DOMAIN_FOR_VALIDATION`

Tool to submit a domain for validation with specified validation types. Use when you need to initiate domain validation for OV or EV certificates with various DCV methods.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | integer | Yes | The unique identifier for the domain to submit for validation. |
| `dcv_method` | string ("dns-txt-token" | "dns-cname-token" | "http-token" | "email") | No | DCV (Domain Control Validation) method options. |
| `email_array` | array | No | When using 'email' dcv_method, restricts DCV verification emails to only the addresses in this list. Only applicable when dcv_method is 'email'. |
| `validations` | array | Yes | List of validation types to submit the domain for. Each entry specifies a validation type (ov or ev). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Account Emails

**Slug:** `DIGICERT_UPDATE_ACCOUNT_EMAILS`

Tool to update account notification and emergency email addresses. Use when you need to change the email addresses that receive account notifications or urgent security communications.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `admin_email` | string | No | Comma-separated list of one or more email addresses that are copied on all emails sent out for the account, including approval notifications. Maximum 255 characters. |
| `emergency_emails` | string | No | Comma-separated email addresses receiving urgent security communications, certificate revocations, and industry guideline changes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Container

**Slug:** `DIGICERT_UPDATE_CONTAINER`

Tool to edit a container's details including name and description. Use when you need to update container information in your DigiCert account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the container. |
| `description` | string | No | Description for the container. |
| `container_id` | string | Yes | The unique identifier for the container being modified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Container Allowed Domain Names

**Slug:** `DIGICERT_UPDATE_CONTAINER_ALLOWED_DOMAIN_NAMES`

Tool to update a container's allowed domains. Use when you need to control which domains are permitted for certificate operations within a specific container. Note that this operation is destructive and will replace the entire allowed domains list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | integer | Yes | The unique identifier of the container to update. Retrieve this value from the List containers endpoint. |
| `allowed_domain_names` | array | Yes | Array of allowed domain names (strings). This operation is destructive - it will overwrite the existing array. Provide an empty array to clear all allowed domains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Container User Assignments

**Slug:** `DIGICERT_UPDATE_CONTAINER_USER_ASSIGNMENTS`

Tool to update a container's user assignments. Use when you need to assign or reassign users to a container. Note that this operation overwrites all existing assignments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `container_id` | string | Yes | The unique identifier for the container being updated. |
| `user_id_assignments` | array | Yes | List of user IDs to assign to the container. WARNING: This overwrites the entire existing user assignments array. An empty array will remove all user assignments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Activate Domain

**Slug:** `DIGICERT_UPDATE_DOMAIN_ACTIVATE`

Tool to activate a domain in DigiCert CertCentral. Use when you need to activate a domain that has been validated and is ready for certificate issuance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain_id` | integer | Yes | The unique identifier for the domain to be activated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resend Domain DCV Emails

**Slug:** `DIGICERT_UPDATE_DOMAIN_DCV_EMAILS`

Tool to resend domain control validation (DCV) emails for a domain. Use when you need to trigger a new DCV email to be sent for domain validation purposes, such as when the original email was not received or has expired.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | Locale code for the language of the validation email. Determines which language the DCV email will be sent in. Example locales: 'en' for English, 'es' for Spanish, 'fr' for French. |
| `domain_id` | integer | Yes | The unique identifier for the domain to resend DCV emails for. |
| `name_scope` | string | No | The fully qualified domain name (FQDN) associated with the domain ID. When provided, limits the DCV email resend to this specific FQDN. |
| `email_array` | array | No | List of email addresses to limit DCV email recipients to. Must be valid constructed email addresses for the domain or approved DNS-based email contacts. Account settings determine which addresses qualify for receiving verification emails. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update API Key

**Slug:** `DIGICERT_UPDATE_KEY`

Tool to edit an API key's name or access role restrictions. Use when you need to rename an API key or modify its permission scope.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Updated name for the key. |
| `key_id` | integer | Yes | The identifier for the API key being modified. |
| `restricted_to_role_id` | integer ("0" | "100" | "101" | "102" | "103") | No | To limit API key permissions, specify the API access role ID. Allowed values: 0, 100, 101, 102, 103. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update API Key Status

**Slug:** `DIGICERT_UPDATE_KEY_STATUS`

Tool to activate, deactivate, or revoke a DigiCert API key. Use when you need to change the status of an existing API key by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key_id` | integer | Yes | The unique identifier for the API key to be modified. |
| `status` | string ("active" | "disabled" | "revoked") | Yes | Updated status for the key. Use 'active' to activate, 'disabled' to deactivate, or 'revoked' to revoke the key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Notification Settings

**Slug:** `DIGICERT_UPDATE_NOTIFICATIONS`

Tool to update CertCentral account notification settings. Use when you need to configure certificate lifecycle email recipients, organization validation preferences, or account balance notifications.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_settings` | array | Yes | List of notification settings to update, each containing name and value fields |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Organization

**Slug:** `DIGICERT_UPDATE_ORGANIZATION`

Tool to update an organization's details in your DigiCert CertCentral account. Use when you need to modify organization information such as name, address, telephone, or location details. Note: All fields (name, address, city, state, country, telephone) are required. The zip field may be required depending on the country (e.g., required for US). Updating organization details will invalidate current validations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zip` | string | No | Postal code. Required for certain countries like US. |
| `city` | string | Yes | City location. Max 64 characters. Required field. |
| `name` | string | Yes | Legal name of the organization. Max 64 characters. Required field. |
| `state` | string | Yes | State or province. Use full name not abbreviation. Required field. |
| `address` | string | Yes | Organization street address. Max 64 characters. Required field. |
| `country` | string | Yes | Two-letter ISO 3166-1 alpha-2 country code. Required field. |
| `address2` | string | No | Second address line for additional address details. Max 64 characters. |
| `telephone` | string | Yes | Organization phone number. Max 32 characters. Required field. |
| `organization_id` | integer | Yes | The unique identifier for the organization to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Activate Organization

**Slug:** `DIGICERT_UPDATE_ORGANIZATION_ACTIVATE`

Tool to activate an organization in DigiCert CertCentral. Use when you need to activate an organization that has been validated and is ready for certificate operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | The unique identifier for the organization to be activated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Organization Contact

**Slug:** `DIGICERT_UPDATE_ORGANIZATION_CONTACT`

Tool to update or replace organization contact and technical contact for an organization. Use when you need to modify contact information associated with an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contacts` | array | Yes | Array of contact objects to update or replace. Maximum one contact per contact_type (organization_contact or technical_contact). |
| `organization_id` | integer | Yes | The ID of the organization to update contacts for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Deactivate Organization

**Slug:** `DIGICERT_UPDATE_ORGANIZATION_DEACTIVATE`

Tool to deactivate an organization in DigiCert CertCentral. Use when you need to deactivate an organization that is no longer active or should be disabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | The unique identifier for the organization to deactivate. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Renewal Email Preference

**Slug:** `DIGICERT_UPDATE_RENEWAL_EMAIL_PREFERENCE`

Tool to enable or disable renewal notifications for SSL/TLS certificates discovered in DigiCert Discovery. Use when you need to manage email alerts for certificate renewals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | Yes | Your DigiCert account identifier. |
| `division_ids` | array | No | Optional list of user's division identifiers to scope the operation. |
| `certificate_id` | array | Yes | List of unique DigiCert-generated certificate IDs found on the endpoint. |
| `renewal_email_preference` | boolean | Yes | Set to true to enable renewal email notifications, false to disable them. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Report

**Slug:** `DIGICERT_UPDATE_REPORT`

Tool to update an existing report’s configuration. Use when you need to modify the schedule, recipients, or format of a scheduled report.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `format` | array | Yes | Output format for generated reports. Only one format. |
| `schedule` | object | Yes | Updated schedule settings for the report. |
| `display_name` | string | Yes | New display name for the report. |
| `report_metadata` | object | Yes | Updated metadata defining report type, columns, filters, and sources. |
| `report_identifier` | string | Yes | UUID of the report to update. |
| `notification_emails` | array | No | List of users to notify when report is generated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Profile

**Slug:** `DIGICERT_UPDATE_USER`

Tool to update a user's profile information in CertCentral. Use when you need to modify user details such as name, email, job title, or SAML SSO settings. The email field is required; other fields are optional.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Valid email address (max 255 characters). This is the only required field. |
| `user_id` | string | Yes | The ID of the user to update. |
| `username` | string | No | Username for the profile. Valid characters: a-z, A-Z, 0-9, @, -, _, + (max 128 chars). |
| `job_title` | string | No | Professional role; required for EV approvers (max 64 chars). Omitting this field removes it from the profile. |
| `last_name` | string | No | User's family name (max 128 characters). |
| `telephone` | string | No | Contact number; required for EV approvers (max 64 chars). Omitting this field removes it from the profile. |
| `first_name` | string | No | User's given name (max 128 characters). |
| `is_saml_sso_only` | string | No | Set to 'true' to restrict user to SAML SSO authentication only. Accepts 'true' or 'false' as strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Container Assignments

**Slug:** `DIGICERT_UPDATE_USER_CONTAINER_ASSIGNMENTS`

Tool to update container (division) assignments for a user. Use when you need to modify which containers a user has access to. Note that this completely overwrites existing assignments, and an empty array removes all restrictions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the user whose container assignments will be updated. |
| `container_id_assignments` | array | Yes | List of container (division) IDs to assign to the user. This completely overwrites existing assignments. To get a list of containers in your account, use the List containers API. An empty array removes all container assignments, making the user unrestricted with access to all containers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update User Role

**Slug:** `DIGICERT_UPDATE_USER_ROLE`

Tool to change a user's access role in CertCentral. Use when you need to modify permissions by assigning different roles to an existing user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | The ID of the user whose role to change. |
| `access_roles` | array | Yes | List of access role assignments. Each role grants specific permissions to the user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate VMC Encoded Logo

**Slug:** `DIGICERT_VALIDATE_VMC_ENCODED_LOGO`

Tool to validate if an SVG file format is compatible with Verified Mark Certificate (VMC) or Common Mark Certificate (CMC) requirements. Use when you need to verify logo format compliance before submitting for VMC/CMC issuance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `logo` | string | Yes | Compressed logo data, formatted as a base64-encoded string. Prepare by compressing SVG content with gzip and encoding with base64: echo '<SVG content>' \| gzip \| base64 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate VMC/CMC Logo Format

**Slug:** `DIGICERT_VALIDATE_VMC_LOGO`

Tool to validate SVG logo format for Verified Mark Certificates (VMC) or Common Mark Certificates (CMC). Use when you need to check if an SVG file meets DigiCert's VMC/CMC requirements before certificate issuance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `svg_content` | string | Yes | Raw SVG file content to validate. Must be a valid SVG XML string. Can include or omit the XML declaration tag (<?xml version="1.0" encoding="UTF-8"?>). |
| `include_xml_declaration` | boolean | No | Whether the SVG content includes an XML declaration tag. If True or if SVG starts with '<?xml', Content-Type 'image/svg+xml' is used. Otherwise, 'image/svg' is used. Auto-detected if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Template

**Slug:** `DIGICERT_VERIFY_TEMPLATE`

Tool to verify a certificate template structure against DigiCert's validation rules. Use when you need to validate template JSON before creating or updating a template. Returns success (204) if valid, or raises ExecutionFailed with details if invalid.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template` | string | Yes | JSON-formatted string containing the certificate template structure. The template must include: 'name' (string), 'signature_algorithm' (with 'allowed_algorithms' array and 'default_algorithm'), 'subject' (with 'attributes' array containing type fields like 'common_name'), 'validity' (with 'min_duration', 'max_duration', 'default_duration' objects specifying 'unit' and 'value'), and 'extensions' (with 'extended_key_usage' containing 'required_usages' array with 'oid' fields). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
