---
title: "What is still open in Brand Memory, as the questions a human answers, with hints. PUT each answer to /api/workspace/file and call again until open is empty."
method: GET
path: "/api/workspace/onboarding"
---

# What is still open in Brand Memory, as the questions a human answers, with hints. PUT each answer to /api/workspace/file and call again until open is empty.

`GET /api/workspace/onboarding`

## Request

- Base URL: `https://shapelessai.com`
- URL: `https://shapelessai.com/api/workspace/onboarding`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://shapelessai.com/api/auth/mcp/authorize`, token URL `https://shapelessai.com/api/auth/mcp/token`, scopes: `read`)

## Response `200`

OK

- Onboarding
  - `percent` integer, required: The completion ring, 20 (endowed) to 100.
  - `sections` object[], required
    - `id` string
    - `label` string
    - `score` integer
    - `weight` integer
  - `open` object[], required: One file per open section, most valuable first; empty when done.
    - `path` string, required: PUT /api/workspace/file with this path.
    - `question` string, required: The one-line ask the screen shows.
    - `gainPercent` integer, required: What answering it adds to the ring.
    - `questions` object[], required: The file's headings as questions; write answers under them as markdown.
      - `level` integer
      - `question` string
      - `hint` string
  - `done` boolean, required
  - `how` string, required

## Other responses

- `401`: No credential, or not valid.
- `403`: The key is missing the "read" scope.
- `429`: Over the key's rate limit (600 requests an hour).

---

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