Skip to main content
GET
/
v1
/
teams
/
{team_id}
/
locations
List Locations
curl --request GET \
  --url https://api.dataraven.io/v1/teams/{team_id}/locations \
  --header 'Authorization: Bearer <token>'
{
  "locations": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "location_type": "s3",
      "bucket_name": "<string>",
      "region": "<string>",
      "last_verified_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "total_pages": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
team_id
string<uuid>
required

Query Parameters

​
location_type
enum<string> | null

Filter by location type Cloud storage provider types.

Available options:
s3,
azure_blob,
gcs,
r2,
b2,
wasabi,
railway,
oracle_object_storage_s3,
s3_compatible
​
q
string | null

Search by name (case-insensitive)

​
page
integer
default:1

Page number

Required range: x >= 1
​
limit
integer
default:50

Items per page

Required range: 1 <= x <= 100
​
sort_by
enum<string> | null

Field to sort by: name, created_at, last_verified_at

Available options:
name,
created_at,
last_verified_at
​
sort_order
enum<string> | null

Sort order: asc or desc (default: desc) Sort order for list endpoints.

Available options:
asc,
desc

Response

Successful Response

Schema for paginated location list.

​
locations
LocationResponse · object[]
required
​
pagination
PaginationResponse · object
required

Pagination metadata in responses.