bits-openapi-real-access

What problem does it solve?

This skill helps agents move from mock or local workflows to real Bits OpenAPI access by diagnosing and fixing authentication, header, username, domain, and permission blockers that produce 401 or 403 failures.

Core Features & Use Cases

• Cloud JWT Exchange: Guides exchanging a Bits service account secret for a cloud JWT and reading the X-Jwt-Token header for subsequent API calls.
• Header & Identity Validation: Advises on constructing required headers including x-jwt-token, username as an email prefix, and domain: pipelines_open;v1 to ensure backend acceptance.
• Failure Interpretation & Next Steps: Distinguishes 401 (auth/header) from 403 (permissions) and recommends minimal verification calls such as GetPipeline before attempting writes like RunPipeline.
• Use Case: Unblock an agent that passes mock tests but gets 401/403 from Bits when attempting to inspect or run pipelines.

Quick Start

Exchange the service account secret for a cloud JWT, then call GetPipeline with headers x-jwt-token, username as the email prefix, and domain: pipelines_open;v1 to verify access.