GET /workspaces is the one call a token can make without naming a workspace. It lists every workspace the token’s creator can reach now, with the key each other call needs.
| Method and path | Scope | What it does |
|---|---|---|
GET /workspaces |
any | The workspaces this token can be used for |
curl -H "Authorization: Bearer $TARKLE_TOKEN" https://tarkle.com/api/v1/workspaces{
"workspaces": [
{ "workspace_key": "abcd1234", "name": "Studio", "url": "https://studio.tarkle.com", "relationship": "owner" }
]
}| Field | Meaning |
|---|---|
workspace_key |
The 8-character key to send as X-Workspace-Key |
name |
The workspace name |
url |
The workspace address |
relationship |
owner, member or linked |
The internal workspace id is never shown. See Authentication for how keys are used.