---
title: "What the identity in the Authorization header stands for [identity]"
method: GET
path: "/workspace-identity"
tags: ["workspace-identity"]
---

# What the identity in the Authorization header stands for \[identity\]

`GET /workspace-identity`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/workspace-identity`
- Auth: HTTP bearer

Only a session's workspace identity (Bearer wid_…, delivered to the pod beside each turn) may ask: its session, workspace, role, expiry, the route groups a token from the exchange may call, and the installed connectors with whether its role is granted each.

## Response `200`

OK

- object
  - `identity` WorkspaceIdentity, required
    - `session_id` string, required
    - `agent_id` string, nullable, required
    - `workspace` object, required
      - `id` string
      - `slug` string
      - `name` string
    - `role` 'owner' | 'admin' | 'member', required
    - `expires_at` string, date-time, required
    - `api_route_groups` string[], required: The /v1 route groups a token from the exchange may call
    - `connectors` object[], required
      - `kind` string
      - `name` string
      - `origin` string
      - `granted` boolean

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/workspace-identity/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)