List workspaces

List user’s workspaces. Repo owners and admins can optionally list all workspaces in the repo (not just their own) by setting scope=all.

GET /repos/{repo_id}/workspaces

cURL

cURL

curl --request GET \
  --url https://api.diversion.dev/v0/repos/{repo_id}/workspaces \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "workspace_id": "<string>",
      "base_commit_id": "<string>",
      "repo_id": "<string>",
      "journal_ordinal_id": 123,
      "name": "<string>",
      "source_commit": "<string>",
      "branch_id": "<string>"
    }
  ]
}

Authorizations

OAuth2OAuth2

Authorization · string · header · required

This API uses OAuth 2 with the implicit grant flow

Path Parameters

repo_id · string · required

The repo ID of the repository. Repo name can be used instead of the ID, but usage of ID for permanent linking and API requests is preferred.

Required string length: 3 - 128

Example:

"example_id"

Response

200

application/json

Success

object · enum<string> · required

Available options: Workspace

items · object[] · required

Show child attributes