Skip to content

Commit 6392b7c

Browse files
committed
Correct design uploads and dashboard-only context operations
1 parent b7ec10f commit 6392b7c

3 files changed

Lines changed: 7 additions & 6 deletions

File tree

‎content/(concepts)/design-system.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ You can also add the standards yourself in the dashboard. **Look & feel** holds
2020

2121
Use **Brand files** to upload logos, images, fonts, and source documents. After uploading, edit **How to use** to tell your agent where and when a file belongs. A filename alone cannot do that job.
2222

23-
Each upload must be no larger than 25 MB. Files stay in the team's private Media Library. Accepted SVG files are sanitized on upload, so check the saved artwork. An agent must download needed files and put visitor-facing assets in the project's source; private file URLs do not belong in a live page.
23+
Each upload must be no larger than 100 MB. Files stay in the team's private Media Library. Accepted SVG files are sanitized on upload, so check the saved artwork. An agent must download needed files and put visitor-facing assets in the project's source; private file URLs do not belong in a live page.
2424

2525
## Apply it to a project
2626

@@ -52,6 +52,6 @@ All paths below start with `/v1/teams/{teamId}`. Use the current [OpenAPI specif
5252
| `POST /design-system/changes` | Save selected changes with `expectedRevision` and `operationId`. |
5353
| `POST /design-system/undo` | Undo the latest action with its `actionId`, `expectedRevision`, and `operationId`. |
5454

55-
An upload alone does not add an asset record or change the design revision. Reference the returned attachment ID in a changes request. API uploads accept files up to 100 MB; the dashboard upload limit is 25 MB.
55+
An upload alone does not add an asset record or change the design revision. Reference the returned attachment ID in a changes request. Both the API and dashboard accept files up to 100 MB.
5656

5757
Use the numeric revision from `GET /design-system` for writes, not the context fingerprint from `GET /agent-context`. A stale write revision returns `409`. Reuse the same `operationId` and identical input after an uncertain response. Saving standards does not change site files.

‎content/(concepts)/team-context.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,11 @@ All paths below start with `/v1/teams/{teamId}`.
3232
| `GET /memories` | List active memories; use `status=archived` for archived records. |
3333
| `POST /memories` | Save one lasting fact, decision, or preference. |
3434
| `PATCH /memories/{memoryId}` | Update a memory or set `archived:true` to archive it. |
35-
| `DELETE /memories/{memoryId}` | Permanently delete a memory; only owners and admins can do this. |
35+
| `DELETE /memories/{memoryId}` | Permanently delete a memory; only owners and admins using a dashboard session can do this. |
3636
| `GET /skills` | Read preset skills, instructions, and setup status. |
37-
| `PATCH /skills/{skillKey}` | Enable or disable a skill; only owners and admins can do this. |
37+
| `PATCH /skills/{skillKey}` | Enable or disable a skill; only owners and admins using a dashboard session can do this. |
3838

39-
Memory reads use `spaces:read`. Memory saves and updates use `spaces:write`. Agents archive memories instead of deleting them. Agents cannot change skill settings.
39+
Memory reads use `spaces:read`. Memory saves and updates use `spaces:write`. Agents archive memories instead of deleting them. API keys and agent grants cannot delete memories or change skill settings, even when the owner is a team admin. These operations require a dashboard session and otherwise return `authorization_level_not_allowed`.
4040

4141
Save one fact per memory. Do not save credentials, payment details, private contact details, temporary task progress, or build output. List existing memories before creating duplicates. After an uncertain write response, read the saved state before another write.
4242

‎scripts/docs-experience.test.mjs‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,8 @@ test("team context explains setup, eligibility, and administrative boundaries",
3737
assert.match(context, /agents\.memory_skills/u);
3838
assert.match(context, /POST \/v1\/teams\/\{teamId\}\/context/u);
3939
assert.match(context, /no request body/u);
40-
assert.match(context, /Agents cannot change skill settings/u);
40+
assert.match(context, /API keys and agent grants cannot delete memories or change skill settings/u);
41+
assert.match(context, /These operations require a dashboard session/u);
4142
assert.match(design, /POST \/design-system\/assets\/upload/u);
4243
assert.match(design, /numeric revision/u);
4344
assert.match(design, /100 MB/u);

0 commit comments

Comments
 (0)