---
title: "Get workspace context"
method: GET
path: "/api/v1/me"
tags: ["workspace"]
---

# Get workspace context

`GET /api/v1/me`

## Request

- Base URL: `https://app.blueticked.com`
- URL: `https://app.blueticked.com/api/v1/me`
- Auth: HTTP bearer

Read the authenticated credential's organization, accessible businesses and effective permission boundary.

Call this first in an agent session. It is the authoritative boundary for business ids, environment and granted scopes.

A null allowed_business_ids means organization-wide access; a non-empty array is the complete business allowlist.

The environment is test for blu_test_ credentials and live for blu_live_ credentials.

## Response `200`

Success

- object
  - `organization` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `timezone` string, required
    - `subscription_tier` string, required
  - `businesses` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, required
    - `status` string, required
    - `timezone` string, nullable, required
    - `is_default` boolean, required
  - `access` object, required
    - `scopes` string[], required
    - `allowed_business_ids` string[], nullable, required
    - `organization_wide` boolean, required
    - `environment` 'test' | 'live', required
    - `rate_limit_per_minute` number, required
  - `request_id` string, required

## Other responses

- `400`: Validation failed
- `401`: Unauthorized: missing or invalid API key
- `402`: Insufficient wallet balance
- `403`: Forbidden: scope, plan limit, or suspension
- `404`: Not found
- `409`: Conflict (idempotency-key reuse or resource in use)
- `422`: Understood but refused: the request is well-formed, the action is not permitted for this resource
- `429`: Rate limited
- `500`: Internal error
- `502`: An upstream provider refused or failed the request
- `503`: Channel or send queue unavailable

---

[API](https://skmtc.dev/blueticked/apis/blueticked-api.md) · [All operations](https://skmtc.dev/blueticked/apis/blueticked-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blueticked/apis/blueticked-api/revisions/07132284f4ff?raw)