Skip to main content
Back to jobs

OAS Engineer

External
readme logoReadme ยท Remote
Full-timeRemote2mo ago
API DesignDocumentationJavaScriptOAuthOpenAPIReact
Cover LetterConnect

Prepare for this interview

Elite

AI-generated questions, company research, and talking points tailored to this role


Benefits

Vision insuranceRemote work options

Additional Information

๐Ÿ“ Locations: San Francisco (Hybrid), New York (Hybrid), Columbus (Hybrid), or Remote (US) We're hiring an OpenAPI (OAS) Engineer to own and evolve the systems that power our API Explorer and API Designer - two of the most critical surfaces in the ReadMe product. This role sits at the intersection of developer experience, API design, and product engineering. You'll shape how thousands of companies design, validate, and interact with their APIs. You won't just be implementing specs...you'll help define how APIs should feel. We're a small team of humans (and one owl ) working together to do big things - and that's where you come in. In this role you'll have a transformational impact on ReadMe across both the trajectory of the business and our thriving culture. ๐Ÿฆ‰ What we do ReadMe helps more than 5,000 leading startups and tech companies build beautiful, personalized, and interactive developer hubs. If you've ever visited the developer docs for PagerDuty, Samsara, or Nvidia, you've used ReadMe! We love what we do because it's so much more than just documentation. We're providing tools for teams to build a better developer experience and make their products and APIs easier to use. We've got great support from our investors at Accel who led our Series A , and our interview process reflects the open, caring, and whimsical culture we want to maintain as we scale. โœ… What you'll do here This isn't a feature team where a PM hands you tickets. You'll help decide what gets built, why it matters, and how it works end-to-end. But you won't be doing it alone. ReadMe is a highly collaborative environment where people show up for each other. Ownership here means you're driving, but not driving solo. You'll specifically own: The API Explorer and API Designer: the tools thousands of companies rely on to design, test, and interact with their APIs through ReadMe. The OAS pipeline: how we parse, validate, transform, and render OpenAPI specs across the product. The technical vision: where these surfaces go next as the API landscape evolves (new spec versions, AI-assisted workflows, shifting developer expectations). The developer experience: y ou'll think deeply about what it feels like to use these tools, not just whether they work. Day-to-day that means you'll: Ship meaningful improvements early , changes that customers notice, even before the full vision takes shape. Define a technical roadmap for the OAS-powered surfaces that the team can get behind and build toward together. Make the big architectural calls . Decide what to evolve, what to reimagine, and how to get there. Stay ahead of the curve . The API tooling landscape is shifting fast. You'll keep an eye on where things are heading and make sure ReadMe stays out in front. ๐Ÿ’™ You'll love this job if you... Care deeply about developer experience and API usability. Have strong opinions on what makes a "good" API - and can back them up. Enjoy working on tools that other developers use every day. Like turning complex systems into simple, elegant interfaces. Are excited about how AI can improve how developers understand and use APIs. ๏ธ โญ๏ธ This role is a great fit if you have... Deep familiarity with OpenAPI / Swagger. Strong JavaScript/TypeScript experience. Experience building or working with API explorers or API clients. Understanding of: Authentication flows (OAuth, API keys, SSO) REST API design patterns JSON Schema and validation systems Comfort debugging real API requests (headers, payloads, errors). Familiarity with frontend systems (React, rendering structured data). Experience designing developer-facing tools is a big plus. ๐ŸŒฑ How you'll grow within one month... Learn how ReadMe ingests and renders OpenAPI specs. Ship your first improvements to the API Explorer or Designer. Pair with engineers across the product and platform teams. ๐Ÿชด Within a few months, you'll... Own meaningful parts of the API Explorer or Designer experience. Identify gaps in how we handle OpenAPI and propose solutions. Become a go-to resource for API-related decisions across the company. ๐ŸŒณ Within your first year, you'll... Define the direction of API tooling at ReadMe. Have shipped major improvements used by thousands of developers daily. Help shape how modern APIs are designed and consumed. ๐Ÿ›ฃ๏ธ What's the hiring process like? We can't wait to read your resume and (hopefully personality-filled) cover letter! Let us know what excites you about full stack engineering, and help us get to know you better! If we think we might be a good fit for you, we'll set up a 30 minute Zoom call with our Engineering Manager, Frank! He'll tell you more about the role, and get a chance to hear about your experiences. Next will be a second 30 minute Zoom interview with Moses, our VP of Engineering where we'll dive a bit more into your background. We'll then do a technical assessment with a couple of ReadMe engineers. Finally we'll invite you to an "onsite" interview conducted o


Your Match

How well this role fits your profile.

Company Intel

What employees say

Worked at readme? Share your experience

Interested in this role?

Apply on the company's website.

Cover LetterConnect