AWS S3

Reads objects from an Amazon S3 bucket. Scope it with a key prefix so one bucket can serve several connections.

Shape: credential — no browser redirect, so this one can be connected headlessly. Provider id: aws_s3.

Credentials

| Field | Required | Notes | | --- | --- | --- | | accessKeyId | ✅ | | | secretAccessKey | ✅ | Stored encrypted; never returned by any read endpoint | | region | ✅ | Defaults to us-east-1 if omitted | | bucket | ✅ | |

Connect

Web app: Setup → Connectors → AWS S3, fill the four fields.

Or over the API — the credentials are validated against the bucket before anything is stored, so a typo comes back as a 400, not a connection that silently syncs nothing:

curl -X POST https://api.divinci.app/api/v1/connectors/aws_s3/auth \
  -H "Authorization: Bearer $DIVINCI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "credentials": {
          "accessKeyId": "AKIA…",
          "secretAccessKey": "…",
          "region": "us-east-1",
          "bucket": "my-docs"
        },
        "syncConfig": { "autoSync": true, "syncIntervalMinutes": 1440, "syncFilter": "handbook/" }
      }'

syncFilter is used as the key prefix, so handbook/ restricts the connection to that folder.

What gets ingested

Objects under the prefix, selected on the Connectors page. Folder-shaped keys are presented as folders so you can pick a subtree.

From the CLI

divinci connectors status aws_s3
divinci connectors settings aws_s3 --auto-sync on --cadence 1440
divinci connectors disconnect aws_s3