check-workspace-status
check-workspace-status
Check configured targets, sources, and workspace info.
When to Use
- Checking what SDK targets are configured
- Viewing published SDK versions and URLs
- Verifying workspace authentication is working
- User says: "workspace status", "what targets configured", "list SDK targets"
Inputs
| Input | Required | Description |
|---|---|---|
| Authentication | Yes | Via speakeasy auth login or SPEAKEASY_API_KEY env var |
Outputs
| Output | Description |
|---|---|
| Workspace info | Name, account type |
| Published targets | Version, URLs, last publish date |
| Configured targets | Unpublished targets, repo URLs |
| Unconfigured targets | Targets with issues |
Command
# For LLMs/automation (recommended)
speakeasy status --output json
# For human-readable output
speakeasy status --output console
Requires SPEAKEASY_API_KEY env var (see configure-authentication skill).
Output Includes
- Workspace name and account type
- Published targets (version, URLs, last publish/generate)
- Configured targets (unpublished, with repo URLs)
- Unconfigured targets and generation failures
Troubleshooting
| Error | Cause | Solution |
|---|---|---|
| "unauthorized" | Missing or invalid API key | Run speakeasy auth login or set SPEAKEASY_API_KEY |
| Empty output | No targets configured | Run start-new-sdk-project to set up first |
| "workspace not found" | Wrong workspace ID | Check ~/.speakeasy/config.yaml |
Related Skills
configure-authentication- Set up API key if status failsregenerate-sdk- Run generation for configured targetsstart-new-sdk-project- Set up new targets
More from speakeasy-api/agent-skills
writing-openapi-specs
Reference guide for OpenAPI specification best practices, naming conventions, and expressing complex REST API patterns like polymorphism, enums, file uploads, and server-sent events. Use when writing or improving OpenAPI specs to ensure they follow established conventions and generate quality SDKs.
16manage-openapi-overlays
Use when creating, applying, or validating overlay files including x-speakeasy extensions. Covers overlay syntax, JSONPath targeting, retries, pagination, naming, grouping, open enums, global headers, custom security. Triggers on "create overlay", "apply overlay", "overlay file", "x-speakeasy", "add extension", "configure retries", "add pagination", "overlay for retries".
13extract-openapi-from-code
Use when extracting or generating an OpenAPI spec from existing API code. Triggers on "extract OpenAPI", "code first", "generate spec from code", "FastAPI OpenAPI", "Spring Boot OpenAPI", "NestJS swagger", "Django OpenAPI", "Flask OpenAPI", "Rails swagger", "Laravel OpenAPI", "existing API code
10speakeasy-context
Speakeasy workflow: run 'agent context' FIRST, do task, run 'agent feedback' LAST. Triggers on speakeasy, SDK, OpenAPI.
10improve-sdk-naming
Use when you want AI-powered suggestions for SDK naming improvements via the `speakeasy suggest` command (not manual overlay creation). Triggers on "suggest improvements", "speakeasy suggest", "AI suggestions", "suggest operation-ids", "suggest error-types", "auto-improve naming", "get AI recommendations".
9validate-openapi-spec
Use when checking if an OpenAPI spec is valid or has errors. Triggers on "validate spec", "lint spec", "check OpenAPI", "spec errors", "is my spec valid", "run speakeasy lint
9