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!
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.
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:
I encountered the same issue before. Gradient doesn’t accept just the bucket name and region; you need to specify the data source type explicitly. For Spaces or S3, you typically need to include something like this: “datasources”: [{ “type”: “s3”, “bucket_name”: “name-redacted”, “bucket_region”: “nyc3” }]
Additionally, some setups may require credentials to be included in the payload or pre-configured in Gradient. Once I added "type": "s3", the API stopped complaining. It might be worth checking their latest documentation or sample payloads, as the error message isn’t very clear about this requirement.
Become a contributor for community
Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.
DigitalOcean Documentation
Full documentation for every DigitalOcean product.
Resources for startups and SMBs
The Wave has everything you need to know about building a business, from raising funding to marketing your product.
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.