---
title: "Sync Chat Pin Workspace"
method: POST
path: "/agent-loop/sync-chat/pin"
tags: ["sync-chat"]
---

# Sync Chat Pin Workspace

`POST /agent-loop/sync-chat/pin`

Pin or unpin one of the caller's own push planspaces (agent-service-facing).

Both endpoints are strictly user-scoped: a sync-chat turn can pin or write up
ONLY the caller's own push planspaces. A workspace_id that is not one of the
caller's own scott_push_artifacts (matched on captured_by_user_id == user_id)
returns 403.

Authed by the sync-chat-turn JWT; the JWT's user_id is the only identity that
matters. The request body cannot widen scope.

## Headers

- `authorization` string, nullable

## Request body

- SyncChatPinRequest — Agent-service body to pin one of the caller's push planspaces.
  - `workspace_id` string, required
  - `pinned` boolean

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)