Control Plane

List Datacenters

List the datacenters configured for the control plane.

GET https://api.rivet.dev/datacenters

Examples

curl "https://api.rivet.dev/datacenters" \
  -H "Authorization: Bearer $RIVET_TOKEN"

const endpoint = "https://api.rivet.dev";
const token = process.env.RIVET_TOKEN ?? "";

const response = await fetch(`${endpoint}/datacenters`, {
	headers: { Authorization: `Bearer ${token}` },
});
const { datacenters } = await response.json();
console.log(datacenters);

export {};

Authentication

Send your namespace token as a bearer token in the Authorization header. Every control plane request also requires the namespace query parameter. See Authentication.

Responses

200

Configured datacenters and an empty pagination cursor.

Field	Type	Description
`datacenters`	`object[]`
`datacenters[].label`	`integer`
`datacenters[].name`	`string`
`datacenters[].url`	`string`
`pagination`	`object`
`pagination.cursor`	`string \| null`	Cursor for the next page, or `null` when there are no more results.

{
  "datacenters": [
    {
      "label": 0,
      "name": "my-actor",
      "url": "<url>"
    }
  ],
  "pagination": {
    "cursor": null
  }
}