Skip to content

docs(api-reference): UZ-PROVIDER-011, the absent source workspace - #184

Merged
indykish merged 1 commit into
mainfrom
chore/m181-006-provider-011-error-code
Sep 4, 2026
Merged

docs(api-reference): UZ-PROVIDER-011, the absent source workspace#184
indykish merged 1 commit into
mainfrom
chore/m181-006-provider-011-error-code

Conversation

@indykish

@indykish indykish commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Adds the UZ-PROVIDER-011 row to the error-code reference.

PUT /v1/admin/platform-keys answered UZ-REQ-001 when source_workspace_id named a workspace that does not exist. The reader was told "That request wasn't valid. Double-check the values you entered and try again" — sent to re-check a value that was already well-formed. The id parsed; the workspace was simply not there.

The HTTP status is unchanged at 400. source_workspace_id is a body field rather than a path segment, so the resource the route addresses is the platform key and a 404 would name the wrong thing. What changed is the code and the sentence the caller reads.

Column Value
Code UZ-PROVIDER-011
HTTP 400
Title Source workspace not found
Why and fix That workspace doesn't exist. Pick one from your workspace list and try again.

Title and message are copied verbatim from the daemon's registry, since the page and the registry are read against each other.

Pairs with agentsfleet#652 (ffd77b5c2), which declares the code and switches the handler to it.

🤖 Generated with Claude Code

https://claude.ai/code/session_016ftejYp8RxA9yHk1kDSxtR

Greptile Summary

Adds the UZ-PROVIDER-011 API error reference for a well-formed source_workspace_id that identifies a nonexistent workspace.

  • Documents the unchanged HTTP 400 status.
  • Provides the registry-aligned title and actionable workspace-selection guidance.
  • Preserves the established model-provider table structure and ordering.

Confidence Score: 5/5

The documentation-only change appears safe to merge.

The new row follows the reference’s established structure, supplies code-specific recovery guidance in the appropriate column, and introduces no identified correctness, security, or repository-rule violations.

Important Files Changed

Filename Overview
api-reference/error-codes.mdx Adds a correctly structured provider error-code row with specific recovery guidance for an absent source workspace.

Reviews (1): Last reviewed commit: "docs(api-reference): UZ-PROVIDER-011, th..." | Re-trigger Greptile

Context used:

`PUT /v1/admin/platform-keys` used to answer `UZ-REQ-001` when
`source_workspace_id` named a workspace that does not exist, so the reader was
told to re-check a value that was already well-formed. The id parsed; the
workspace was simply not there.

The status is unchanged at 400. What changed is the code and the sentence, so
this page needed the row rather than an edit to an existing one.

Title and message are copied from the daemon's registry verbatim, because the
page and the registry are read against each other.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016ftejYp8RxA9yHk1kDSxtR
@indykish
indykish merged commit ad94e44 into main Sep 4, 2026
4 checks passed
@indykish
indykish deleted the chore/m181-006-provider-011-error-code branch September 4, 2026 17:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant