List Databases

List every database in a workspace with its canonical app URL.

POST /v1/list-databases

List every database in a workspace with its canonical app URL. A workspace can have more than one database (a CRM database, a bug tracker, and a task list can all live side by side) – use this before list-database-fields, list-database-records, or create-database-record to find the databaseId you need. Every workspace has at least one database.

Request body

FieldTypeRequiredDescription
workspaceIdstringYesThe workspace ID
{
  "workspaceId": "string"
}

Response

[
  {
    "id": "string",
    "name": "string",
    "url": "string"
  }
]

Example

curl -X POST https://rest.blue.app/v1/list-databases \
  -H "Authorization: Bearer $BLUE_TOKEN" \
  -H "blue-org-id: $BLUE_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId":"string"}'