---
title: "Set Agent Workspace"
method: PUT
path: "/v1/profile/agent-workspace"
---

# Set Agent Workspace

`PUT /v1/profile/agent-workspace`

## Request

- Base URL: `https://api.graphify.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.graphify.com/v1/profile/agent-workspace`
- Auth: HTTP bearer

Point the caller's agent (MCP/gx) at a workspace by tenant id (AD-MCP-1). Writes
``default_tenant_id`` (authority) + mirrors app_metadata; 404 ``workspace_not_found``
if the caller is not a member (indistinguishable from nonexistent).

## Request body

- AgentWorkspaceUpdate: The body of ``PUT /v1/profile/agent-workspace`` (AD-MCP-1): the workspace a user's agent (MCP/gx) should point at. Writes ``user.default_tenant_id`` as the authority. Accepts ``tenantId`` (camelCase) or ``tenant_id``; membership is validated server-side.
  - `tenantId` string, uuid, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graphify/apis/graphify-control-plane.md) · [All operations](https://skmtc.dev/graphify/apis/graphify-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/graphify/apis/graphify-control-plane/revisions/0e75c82b5ea8?raw)