Report this

What is the reason for this report?

How to create Gradient KB via API?

Posted on November 3, 2025

I’m struggling to create a Knowledge Base via API for my AI agent. I keep getting various datasources errors, that last of which was “Datasource must specify a valid data source type with proper structure.” I can’t find a list of supported types; I’m trying to use a Spaces bucket and it seems like bucket name + region are sufficient. So this is the part of my payload I’m using:

"datasources": [{
    "bucket_name": "name-redacted",
    "bucket_region": "nyc3"
  }],


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

These answers are provided by our Community. If you find them useful, show some love by clicking the heart. If you run into issues leave a comment, or add your own answer to help others.

It looks like the Gradient API requires each datasource in your Knowledge Base payload to include a type-specific structure, not just bucket_name and bucket_region. For Spaces, it likely needs something like a "spaces_bucket" object that defines the bucket details.

https://docs.digitalocean.com/products/gradient-ai-platform/how-to/create-manage-agent-knowledge-bases/

The public docs don’t yet list all supported datasource schemas, so that’s why you’re seeing “Datasource must specify a valid data source type.” I’d recommend opening a support ticket with your payload and error message, they can confirm the exact field names expected for Spaces uploads:

https://www.digitalocean.com/support/

The developer cloud

Scale up as you grow — whether you're running one virtual machine or ten thousand.

Get started for free

Sign up and get $200 in credit for your first 60 days with DigitalOcean.*

*This promotional offer applies to new accounts only.