Actualizar S3

POST

api

instance

:instance

Actualizar S3

curl --request POST \
  --url https://api.example.com/api/instance/s3/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "enabled": true,
  "region": "<string>",
  "bucket": "<string>",
  "accessKey": "<string>",
  "secretKey": "<string>",
  "endpoint": "<string>",
  "pathPrefix": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {token: '<token>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({
    enabled: true,
    region: '<string>',
    bucket: '<string>',
    accessKey: '<string>',
    secretKey: '<string>',
    endpoint: '<string>',
    pathPrefix: '<string>'
  })
};

fetch('https://api.example.com/api/instance/s3/:instance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/instance/s3/:instance"

payload = {
    "enabled": True,
    "region": "<string>",
    "bucket": "<string>",
    "accessKey": "<string>",
    "secretKey": "<string>",
    "endpoint": "<string>",
    "pathPrefix": "<string>"
}
headers = {
    "token": "<token>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

Descripción

Configura el almacenamiento S3 de la instancia. La secretKey es cifrada at-rest y nunca devuelta. Para almacenamiento S3-compatible (MinIO, Backblaze, DO Spaces), rellena endpoint con la URL.

Ejemplos

AWS S3

Apunta el almacenamiento al AWS S3 oficial: bucket ryzeapi-media en us-east-1, con endpoint vacío para usar el dominio default de AWS y prefijo media/myinstance/ para aislar los archivos.

curl -X POST "https://ryzeapi.cloud/api/instance/s3/my-instance" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "region": "us-east-1",
    "bucket": "ryzeapi-media",
    "accessKey": "AKIA...",
    "secretKey": "secret-redacted",
    "endpoint": "",
    "pathPrefix": "media/myinstance/"
  }'

await fetch("https://ryzeapi.cloud/api/instance/s3/my-instance", {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    enabled:    true,
    region:     "us-east-1",
    bucket:     "ryzeapi-media",
    accessKey:  "AKIA...",
    secretKey:  "secret-redacted",
    endpoint:   "",
    pathPrefix: "media/myinstance/"
  })
});

import os, requests

requests.post(
    "https://ryzeapi.cloud/api/instance/s3/my-instance",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "enabled":    True,
        "region":     "us-east-1",
        "bucket":     "ryzeapi-media",
        "accessKey":  "AKIA...",
        "secretKey":  "secret-redacted",
        "endpoint":   "",
        "pathPrefix": "media/myinstance/"
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "enabled":    true,
        "region":     "us-east-1",
        "bucket":     "ryzeapi-media",
        "accessKey":  "AKIA...",
        "secretKey":  "secret-redacted",
        "endpoint":   "",
        "pathPrefix": "media/myinstance/"
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/instance/s3/my-instance", body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

MinIO self-hosted

Mismo formato que AWS, pero con endpoint apuntando a un MinIO interno (https://minio.internal.company.com). El mismo patrón funciona para DigitalOcean Spaces, Backblaze B2 y otros almacenamientos S3-compatibles.

curl -X POST "https://ryzeapi.cloud/api/instance/s3/my-instance" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "region": "us-east-1",
    "bucket": "whatsapp",
    "endpoint": "https://minio.internal.company.com",
    "accessKey": "minioadmin",
    "secretKey": "minioadmin",
    "pathPrefix": "ryzeapi/"
  }'

await fetch("https://ryzeapi.cloud/api/instance/s3/my-instance", {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    enabled:    true,
    region:     "us-east-1",
    bucket:     "whatsapp",
    endpoint:   "https://minio.internal.company.com",
    accessKey:  "minioadmin",
    secretKey:  "minioadmin",
    pathPrefix: "ryzeapi/"
  })
});

import os, requests

requests.post(
    "https://ryzeapi.cloud/api/instance/s3/my-instance",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "enabled":    True,
        "region":     "us-east-1",
        "bucket":     "whatsapp",
        "endpoint":   "https://minio.internal.company.com",
        "accessKey":  "minioadmin",
        "secretKey":  "minioadmin",
        "pathPrefix": "ryzeapi/"
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "enabled":    true,
        "region":     "us-east-1",
        "bucket":     "whatsapp",
        "endpoint":   "https://minio.internal.company.com",
        "accessKey":  "minioadmin",
        "secretKey":  "minioadmin",
        "pathPrefix": "ryzeapi/"
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/instance/s3/my-instance", body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Deshabilitar

Envía solo enabled: false para deshabilitar el almacenamiento y eliminar las credenciales de la base de datos. Para volver a habilitar más tarde, todos los campos deben enviarse de nuevo.

curl -X POST "https://ryzeapi.cloud/api/instance/s3/my-instance" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'

await fetch("https://ryzeapi.cloud/api/instance/s3/my-instance", {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ enabled: false })
});

import os, requests

requests.post(
    "https://ryzeapi.cloud/api/instance/s3/my-instance",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={"enabled": False}
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{"enabled":false}`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/instance/s3/my-instance", body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Respuesta exitosa

200 OK

{
  "success": true,
  "message": "S3 configuration updated",
  "s3": {
    "enabled": true,
    "region": "us-east-1",
    "bucket": "ryzeapi-media",
    "accessKey": "AKIA...",
    "endpoint": "",
    "pathPrefix": "media/myinstance/"
  }
}

secretKey no aparece en la respuesta, el servidor nunca devuelve la clave en texto plano.

Parámetros de ruta

string

requerido

Nombre de la instancia.

Cabeceras

string

requerido

TokenAccount o TokenInstance.

string

requerido

application/json.

Cuerpo de la solicitud

boolean

requerido

Habilita/deshabilita el S3 de la instancia. false limpia todos los campos.

string

Región (p. ej., us-east-1).

string

Nombre del bucket (debe existir; no se realiza creación).

string

Access Key ID.

string

Secret Access Key. Cifrada at-rest.

string

Endpoint personalizado (MinIO, DO Spaces, Backblaze). Vacío para AWS S3 oficial.

string

Prefijo de path (p. ej., media/myinstance/).

Notas

No hay testing de credenciales. El endpoint guarda la config sin validar si el bucket existe o si las credenciales funcionan, el error solo aparece cuando el próximo upload de media intenta autenticarse (visible en los logs del servidor).

Deshabilitar (enabled=false) elimina las credenciales de la base de datos. Para volver a habilitar más tarde, todos los campos deben enviarse de nuevo.

Errores

HTTP	`error.message`	Cuándo
400	`Invalid request body`	JSON malformado.
401	`Invalid token`	Token faltante o inválido.
404	`Instance not found`	Nombre no existe.
429	`Rate limit exceeded. Try again later.`	Más de 100 req/min.
500	`Failed to update S3 configuration`	Error de base de datos.

{
  "success": false,
  "error": {
    "message": "Failed to update S3 configuration"
  }
}

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Descripción

Ejemplos

AWS S3

MinIO self-hosted

Deshabilitar

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Errores

​Descripción

​Ejemplos

​AWS S3

​MinIO self-hosted

​Deshabilitar

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Cuerpo de la solicitud

​Notas

​Errores

Descripción

Ejemplos

AWS S3

MinIO self-hosted

Deshabilitar

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Errores