> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update destination

> Update a destination's details.

**Important Notes:**
- Requires scope `dwh_transfers_write`
- Your account must have `dwh.transfer.edit` permission. See [roles and permissions](https://docs.supermetrics.com/docs/about-supermetrics-teams-and-user-roles#user-roles).


## OpenAPI

````json PUT /teams/{team_id}/destinations/{destination_id}
{
  "openapi": "3.0.3",
  "info": {
    "title": "Management API Reference",
    "version": "2.0.0",
    "description": "API Documentation for the Supermetrics Management API. For more information, visit https://supermetrics.com.",
    "termsOfService": "https://supermetrics.com/terms-of-service",
    "contact": {
      "name": "Supermetrics Suppot",
      "email": "support@supermetrics.com",
      "url": "https://supermetrics.com/support"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "x-api-id": "sm-management-api",
    "x-audience": "public"
  },
  "servers": [
    {
      "url": "https://api.supermetrics.com/v2",
      "description": "Global production public Supermetrics Management API base path.",
      "x-internal": "false"
    },
    {
      "url": "https://api.supermetrics.com",
      "description": "Global production public Supermetrics API base path (for Connector Builder and Team endpoints).",
      "x-internal": "false"
    }
  ],
  "tags": [
    {
      "name": "API Keys",
      "description": "Manage API keys to access Supermetrics API"
    },
    {
      "name": "Data Source Logins",
      "description": "Access your data source authentications"
    },
    {
      "name": "Data Source Login Links",
      "description": "Create single-use data source login links"
    },
    {
      "name": "Saved Queries",
      "description": "Manage queries saved in Query Manager"
    },
    {
      "name": "Table Groups",
      "description": "Manage your team's table groups"
    },
    {
      "name": "Team Lists",
      "description": "Manage centralized team lists for your queries"
    },
    {
      "name": "Team Settings",
      "description": "Configure general settings for your team"
    },
    {
      "name": "Data Transfers",
      "description": "Create, configure, and manage Data Warehouse transfers"
    },
    {
      "name": "Transfer Runs",
      "description": "Monitor execution history of Data Warehouse transfers"
    },
    {
      "name": "Data Backfills",
      "description": "Manage historical data backfills for your Data Warehouse transfers"
    },
    {
      "name": "Data Destinations",
      "description": "Create, configure, and manage Data Warehouse destinations"
    },
    {
      "name": "Data Source Connections",
      "description": "Create and manage data source connections for Data Warehouse transfers"
    },
    {
      "name": "Data Blending",
      "description": "Create and manage Data Blending"
    },
    {
      "name": "Custom Fields",
      "description": "Create and manage Custom Fields"
    },
    {
      "name": "Connectors",
      "description": "Create and manage custom connectors"
    },
    {
      "name": "Connector Secrets",
      "description": "Manage encrypted secrets for connectors"
    },
    {
      "name": "Connector Logs",
      "description": "Access connector execution logs"
    },
    {
      "name": "Connector Logo",
      "description": "Manage connector logos"
    },
    {
      "name": "Connector Schema",
      "description": "Retrieve connector configuration schemas"
    },
    {
      "name": "Datasource",
      "description": "Retrieve datasource configuration details"
    }
  ],
  "externalDocs": {
    "description": "Find out more about Supermetrics Management API",
    "url": "https://docs.supermetrics.com/apidocs/management-api"
  },
  "paths": {
    "/teams/{team_id}/destinations/{destination_id}": {
      "servers": [
        {
          "url": "https://dts-api.supermetrics.com/v1",
          "description": "Data Destinations API"
        }
      ],
      "put": {
        "summary": "Update destination",
        "description": "Update a destination's details.\n\n**Important Notes:**\n- Requires scope `dwh_transfers_write`\n- Your account must have `dwh.transfer.edit` permission. See [roles and permissions](https://docs.supermetrics.com/docs/about-supermetrics-teams-and-user-roles#user-roles).\n",
        "operationId": "updateDestination",
        "tags": [
          "Data Destinations"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/TeamId"
          },
          {
            "$ref": "#/components/parameters/DwhDestinationIdPath"
          }
        ],
        "requestBody": {
          "required": "true",
          "description": "Destination configuration changes",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateDestinationRequest"
              },
              "example": {
                "type": "DWH_SNOWFLAKE",
                "display_name": "Updated Snowflake Destination",
                "auth_method": "AUTH_METHOD_KEY_PAIR",
                "fields": {
                  "hostname": "updated-domain.my-region.snowflakecomputing.com",
                  "warehouse": "PRODUCTION_WH",
                  "database_name": "PROD_DB",
                  "schema": "PUBLIC",
                  "role": "SYSADMIN",
                  "username": "PROD_USER"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Destination updated successfully",
            "headers": {
              "Access-Control-Allow-Origin": {
                "$ref": "#/components/headers/Access-Control-Allow-Origin"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "meta",
                    "data"
                  ],
                  "properties": {
                    "meta": {
                      "$ref": "#/components/schemas/Meta"
                    },
                    "data": {
                      "$ref": "#/components/schemas/DestinationInfo"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "description": "Invalid destination configuration",
            "headers": {
              "Access-Control-Allow-Origin": {
                "$ref": "#/components/headers/Access-Control-Allow-Origin"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "TeamId": {
        "name": "team_id",
        "in": "path",
        "description": "ID of the team",
        "required": "true",
        "schema": {
          "type": "integer",
          "format": "int64",
          "minimum": "1",
          "maximum": "9223372036854776000"
        },
        "example": "936506"
      },
      "DwhDestinationIdPath": {
        "name": "destination_id",
        "in": "path",
        "required": "true",
        "description": "Unique identifier for the destination",
        "example": "8",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "1",
          "maximum": "2147483647"
        }
      }
    },
    "schemas": {
      "UpdateDestinationRequest": {
        "type": "object",
        "required": [
          "type",
          "display_name",
          "fields"
        ],
        "properties": {
          "type": {
            "type": "string",
            "maxLength": "50",
            "description": "Destination type (e.g., DWH_SNOWFLAKE, DWH_BIGQUERY)",
            "example": "DWH_SNOWFLAKE"
          },
          "display_name": {
            "type": "string",
            "maxLength": "255",
            "description": "Human-readable name for the destination",
            "example": "My Snowflake Destination"
          },
          "auth_method": {
            "type": "string",
            "maxLength": "100",
            "description": "Authentication method for the destination",
            "example": "AUTH_METHOD_KEY_PAIR"
          },
          "fields": {
            "type": "object",
            "description": "Destination-specific configuration fields (varies by destination type)",
            "additionalProperties": "true"
          },
          "new_password": {
            "type": "string",
            "maxLength": "255",
            "description": "New secret value for credential rotation. Field name varies by auth method (e.g., new_private_key for key-pair auth)"
          }
        },
        "additionalProperties": "false"
      },
      "Meta": {
        "type": "object",
        "description": "Metadata included in every API response.",
        "properties": {
          "request_id": {
            "$ref": "#/components/schemas/RequestId"
          }
        },
        "required": [
          "request_id"
        ],
        "additionalProperties": "false"
      },
      "DestinationInfo": {
        "type": "object",
        "required": [
          "display_name",
          "destination_type",
          "edit_settings"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32",
            "minimum": "1",
            "maximum": "2147483647",
            "nullable": "true",
            "description": "Unique identifier for the destination",
            "example": "123"
          },
          "display_name": {
            "type": "string",
            "maxLength": "255",
            "description": "Human-readable name for the destination",
            "example": "My Snowflake Destination"
          },
          "destination_type": {
            "$ref": "#/components/schemas/DestinationType"
          },
          "edit_settings": {
            "type": "array",
            "maxItems": "500",
            "description": "Configuration settings for the destination",
            "items": {
              "$ref": "#/components/schemas/DestinationSetupSetting"
            }
          }
        },
        "additionalProperties": "false"
      },
      "ErrorResponse": {
        "type": "object",
        "description": "Standard envelope returned by all error (4xx/5xx) responses.",
        "properties": {
          "meta": {
            "$ref": "#/components/schemas/Meta"
          },
          "error": {
            "$ref": "#/components/schemas/Error"
          }
        },
        "required": [
          "meta",
          "error"
        ],
        "additionalProperties": "false"
      },
      "RequestId": {
        "type": "string",
        "description": "Unique identifier for the request, for tracking and debugging.",
        "pattern": "^[A-Za-z0-9_-]+$",
        "minLength": "8",
        "maxLength": "64",
        "example": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN",
        "x-faker": {
          "random.alphaNumeric": "30"
        }
      },
      "DestinationType": {
        "type": "object",
        "required": [
          "type",
          "title",
          "icon_url"
        ],
        "properties": {
          "type": {
            "type": "string",
            "maxLength": "50",
            "description": "Destination type identifier",
            "example": "DWH_SNOWFLAKE"
          },
          "title": {
            "type": "string",
            "maxLength": "255",
            "description": "Display name for the destination type",
            "example": "Snowflake"
          },
          "icon_url": {
            "type": "string",
            "format": "uri",
            "maxLength": "2083",
            "description": "URL to the destination type icon",
            "example": "https://supermetrics.com/icons/snowflake.svg"
          },
          "connection_check_url": {
            "type": "string",
            "format": "uri",
            "maxLength": "2083",
            "description": "URL for connection testing"
          },
          "create_url": {
            "type": "string",
            "format": "uri",
            "maxLength": "2083",
            "description": "URL for creating a destination"
          },
          "update_url_template": {
            "type": "string",
            "maxLength": "2083",
            "description": "URL template for updating a destination"
          },
          "app_id": {
            "type": "string",
            "maxLength": "50",
            "description": "Application identifier"
          },
          "is_internal": {
            "type": "boolean",
            "description": "Whether this is an internal destination type",
            "default": "false"
          },
          "settings": {
            "type": "array",
            "maxItems": "500",
            "description": "Available settings for this destination type",
            "items": {
              "$ref": "#/components/schemas/DestinationSetupSetting"
            }
          },
          "auth_methods": {
            "type": "array",
            "maxItems": "50",
            "description": "Available authentication methods",
            "items": {
              "$ref": "#/components/schemas/DestinationAuthMethod"
            }
          }
        },
        "additionalProperties": "false"
      },
      "DestinationSetupSetting": {
        "type": "object",
        "required": [
          "id",
          "input_type",
          "is_required"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": "100",
            "description": "Unique identifier for the setting",
            "example": "hostname"
          },
          "label": {
            "type": "string",
            "maxLength": "255",
            "nullable": "true",
            "description": "Display label for the setting",
            "example": "Hostname"
          },
          "value": {
            "description": "Current value of the setting (type varies based on input_type)",
            "example": "myaccount.snowflakecomputing.com",
            "oneOf": [
              {
                "type": "string",
                "maxLength": "1000"
              },
              {
                "type": "integer",
                "format": "int32",
                "minimum": "-2147483648",
                "maximum": "2147483647"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "input_type": {
            "type": "string",
            "maxLength": "50",
            "description": "Type of input control",
            "example": "text"
          },
          "is_required": {
            "type": "boolean",
            "description": "Whether this setting is required",
            "example": "true"
          },
          "options": {
            "type": "array",
            "maxItems": "500",
            "description": "Available options for select/radio inputs",
            "items": {
              "type": "object"
            },
            "default": []
          },
          "help_text": {
            "type": "string",
            "maxLength": "1000",
            "nullable": "true",
            "description": "Help text for the setting"
          },
          "help_url": {
            "type": "string",
            "format": "uri",
            "maxLength": "2083",
            "nullable": "true",
            "description": "URL to additional help documentation"
          },
          "note": {
            "type": "string",
            "maxLength": "500",
            "nullable": "true",
            "description": "Additional notes about the setting"
          },
          "group": {
            "type": "string",
            "maxLength": "100",
            "description": "Group identifier for organizing settings"
          },
          "group_label": {
            "type": "string",
            "maxLength": "255",
            "description": "Display label for the group"
          },
          "show_for": {
            "type": "array",
            "maxItems": "200",
            "description": "Conditional display rules",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": "100"
                },
                "values": {
                  "type": "array",
                  "maxItems": "500",
                  "items": {
                    "type": "string",
                    "maxLength": "100"
                  }
                }
              }
            },
            "default": []
          }
        },
        "additionalProperties": "false"
      },
      "Error": {
        "type": "object",
        "description": "Machine- and human-readable detail for a failed request.",
        "properties": {
          "code": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]*$",
            "maxLength": "100",
            "description": "Stable, screaming-snake-case identifier for the error condition. Clients should branch on this, not on `message`. Common values include BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT_ERROR, PERMISSION_ERROR, UNPROCESSABLE_ENTITY, UNPROCESSABLE_CONTENT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, DUPLICATION_FAILED, SERVICE_UNAVAILABLE; domains may define additional codes.",
            "example": "BAD_REQUEST"
          },
          "message": {
            "type": "string",
            "maxLength": "255",
            "pattern": "^.+$",
            "description": "Short, human-readable summary of the error.",
            "example": "The request was invalid."
          },
          "description": {
            "type": "string",
            "maxLength": "2048",
            "description": "Optional longer explanation specific to this occurrence.",
            "example": "The field 'display_name' must not be empty."
          }
        },
        "required": [
          "code",
          "message"
        ],
        "additionalProperties": "false"
      },
      "DestinationAuthMethod": {
        "type": "object",
        "required": [
          "id",
          "label"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": "100",
            "description": "Authentication method identifier",
            "example": "AUTH_METHOD_KEY_PAIR"
          },
          "label": {
            "type": "string",
            "maxLength": "255",
            "description": "Display label for the authentication method",
            "example": "Key Pair Authentication"
          },
          "is_default": {
            "type": "boolean",
            "description": "Whether this is the default authentication method",
            "default": "false"
          }
        },
        "additionalProperties": "false"
      }
    },
    "headers": {
      "Access-Control-Allow-Origin": {
        "description": "CORS header",
        "schema": {
          "type": "string",
          "maxLength": "255",
          "enum": [
            "*"
          ],
          "example": "*"
        }
      },
      "X-RateLimit-Limit": {
        "description": "Request limit per hour",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "1",
          "maximum": "10000",
          "example": "5000"
        }
      },
      "X-RateLimit-Remaining": {
        "description": "Remaining requests in current window",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "0",
          "maximum": "10000",
          "example": "4999"
        }
      },
      "WWW-Authenticate": {
        "description": "Bearer token required",
        "schema": {
          "type": "string",
          "maxLength": "255",
          "pattern": "^Bearer.*"
        }
      },
      "Retry-After": {
        "description": "Seconds until rate limit resets",
        "schema": {
          "type": "integer",
          "format": "int32",
          "minimum": "1",
          "maximum": "86400",
          "example": "3600"
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad request - invalid parameters",
        "headers": {
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "BAD_REQUEST",
                "message": "The request was invalid."
              }
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized",
        "headers": {
          "WWW-Authenticate": {
            "$ref": "#/components/headers/WWW-Authenticate"
          },
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "UNAUTHORIZED",
                "message": "Authentication is required."
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "Access forbidden",
        "headers": {
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "FORBIDDEN",
                "message": "You do not have access to this resource."
              }
            }
          }
        }
      },
      "NotFound": {
        "description": "Resource not found",
        "headers": {
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "NOT_FOUND",
                "message": "The requested resource was not found."
              }
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "Too Many Requests",
        "headers": {
          "X-RateLimit-Limit": {
            "$ref": "#/components/headers/X-RateLimit-Limit"
          },
          "X-RateLimit-Remaining": {
            "$ref": "#/components/headers/X-RateLimit-Remaining"
          },
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          },
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "TOO_MANY_REQUESTS",
                "message": "Rate limit exceeded. Retry later."
              }
            }
          }
        }
      },
      "InternalServerError": {
        "description": "Internal server error",
        "headers": {
          "Access-Control-Allow-Origin": {
            "$ref": "#/components/headers/Access-Control-Allow-Origin"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "meta": {
                "request_id": "BXaEFVtjc7TXaJxgZhmFgSUD9edqq_CN"
              },
              "error": {
                "code": "INTERNAL_SERVER_ERROR",
                "message": "An unexpected error occurred."
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "otok",
        "description": "Bearer token authentication. Include the token in the Authorization header:\n`Authorization: Bearer <your-token>`\n"
      }
    }
  }
}
````