Skip to main content
GET
/
v1
/
workspaces
/
{workspace_id}
Get workspace
curl --request GET \
  --url https://api.app.layer.ai/api/v1/workspaces/{workspace_id} \
  --header 'Authorization: Bearer <token>'
{
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "name": "<string>",
  "balance_creative_units": 123,
  "reserved_creative_units": 123,
  "available_creative_units": 123,
  "last_active_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Personal Access Token or OAuth2 JWT. Create a PAT at app.layer.ai → Settings → Personal Access Tokens.

Path Parameters

​
workspace_id
string<uuid>
required

Response

Successful Response

​
workspace_id
string<uuid>
required

The workspace's unique identifier.

​
slug
string
required

The workspace slug (its representation in the app URL).

​
name
string
required

The workspace display name.

​
balance_creative_units
number
required

Total Creative Units balance before reservations.

​
reserved_creative_units
number
required

Creative Units reserved by in-progress generations.

​
available_creative_units
number
required

Usable balance (balance minus reserved). Can be negative.

​
last_active_at
string<date-time> | null
required

When the current user was last active in this workspace.