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.

GET /v1/orgs/:orgId/resources

Lists repositories, databases and buckets, optionally of one type.

Auth: user access token or platform agent key · Scopes: git:read (with type=repository), resources:read (with any other type, or none)

Response 200

{
  resources: {
    type: "repository" | "database" | "bucket"
    name: string
    status?: "error" | "active" | "creating" | "deleting"
    createdAt?: number
    updatedAt?: number
    region: string
    orgId: string
    createdBy: string
    projectId?: string
    location: string
    resourceId: string
    arn?: string
    physicalName: string
  }[]
}

POST /v1/orgs/:orgId/resources

Creates a repository, database or bucket in a location. With projectId, a database or bucket is linked to that project. Databases take an optional key schema (default pk/sk strings; sortKey: null for a partition key only).

Auth: user access token or platform agent key · Scopes: git:write (for repositories), resources:write (for databases and buckets)

Request body

Response 201

{
  resource: {
    type: "repository" | "database" | "bucket"
    name: string
    status?: "error" | "active" | "creating" | "deleting"
    createdAt?: number
    updatedAt?: number
    region: string
    orgId: string
    createdBy: string
    projectId?: string
    location: string
    resourceId: string
    arn?: string
    physicalName: string
  }
}

Errors

PATCH /v1/orgs/:orgId/resources/:type/:resourceId

Links a database or bucket to a project, or unlinks it with projectId: null. Takes effect on the project's next deployment.

Auth: user access token or platform agent key · Scope: resources:write

Request body

Response 200

{
  resource: {
    type: "repository" | "database" | "bucket"
    name: string
    status?: "error" | "active" | "creating" | "deleting"
    createdAt?: number
    updatedAt?: number
    region: string
    orgId: string
    createdBy: string
    projectId?: string
    location: string
    resourceId: string
    arn?: string
    physicalName: string
  }
}

Errors

DELETE /v1/orgs/:orgId/resources/:type/:resourceId

Deletes 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.

Auth: user access token or platform agent key · Scopes: git:write (for repositories), resources:write (for databases and buckets)

Response 204 with no body.

Errors

Errors from AWS are mapped as in AWS errors.