API

Repositories, databases and buckets

Create, list, link and delete repositories, databases and buckets.

Repositories need git scopes; databases and buckets need resource scopes. To read and write data in a database or bucket, use the Databases and Storage routes.

Every route below, with its parameters, request and response, errors and samples, is in the API reference.

RouteWhat it does
GET /v1/orgs/:orgId/resourcesLists repositories, databases and buckets, optionally of one type.
POST /v1/orgs/:orgId/resourcesCreates a repository, database or bucket in a location. With projectId, a database or bucket is linked to that Serverless App Service. Databases take an optional key schema (default pk/sk strings; sortKey: null for a partition key only).
PATCH /v1/orgs/:orgId/resources/:type/:resourceIdLinks a database or bucket to a Serverless App Service, or unlinks it with projectId: null. Takes effect on the Serverless App Service's next deployment.
DELETE /v1/orgs/:orgId/resources/:type/:resourceIdDeletes a resource and the AWS resource behind it. Databases must have deletion protection off; buckets must be empty. On failure the resource keeps its status.