Update destination

Replaces the destination's configuration. Leave secret out to keep the credentials already stored; send it to rotate them. The provider and the slug are fixed at creation.

PUT/destinations/{id}
AuthAPI keyorOAuth tokenHow to send it

Path parameters#

idstringrequired

The destination to update.

e.g. "dst_01KE7XWWEQ4MCGWKBQKJ1G47RP"

Request body#

configobjectrequired
path_templatestringrequired
≤ 2048 characters
url_templatestring

URL template used to create an image URL. It must include a {path} which is a resolved path to file from path_template.

Example:

path_template -> "/images/{id}"

On upload path becomes /images/img_si1EywtFZMvDArkcVSSsN759VFNbHtE_.webp

url_template: "https://my-cdn.my-domain.com/{path}"

The url in the response will be: "https://my-cdn.my-domain.com/images/img_si1EywtFZMvDArkcVSSsN759VFNbHtE_.webp"

Note: The double // are automatically removed and replaced with single slash.

providerobjectrequired
account_idstringrequired
bucketstringrequired
id"r2"required
jurisdictionstring
"default""eu""fedramp"
secretobject
access_key_idstringrequired
secret_access_keystringrequired

Response#

200Destination updated

dataobjectrequired
configjson | nullrequired
createdAtanyrequired
idstringrequired
namestringrequired
providerjson | nullrequired
updatedAtanyrequired

Errors#

A failed call names what went wrong in code, with a sentence in message. The codes, which of them are worth retrying, and how to read a validation failure are on Errors.