OAS Engineer

ReadMe

5d • Hybrid

About The Position

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.

Requirements

• 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).

Nice To Haves

• Experience designing developer-facing tools is a big plus.

Responsibilities

• 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: you’ll think deeply about what it feels like to use these tools, not just whether they work.
• 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.

Benefits

• Unlimited PTO with a three-week minimum. 🏝️
• Fully covered medical, dental, and vision insurance for you, and 100% for your dependents.
• A One Medical membership. 👨‍⚕️
• A gym or fitness stipend of up to $150 per month. 🏋️‍♀️
• One-to-one donation matching of up to $1,000 per year. 💸
• Twelve weeks of paid parental leave after the birth or adoption of a child. 🐣
• Work from home. 🏠
• Three offsite retreats per year to get together with coworkers and plan for the quarter ahead. ✈️

What This Job Offers

• Job Type: Full-time
• Career Level: Mid Level
• Education Level: No Education Listed
• Number of Employees: 11-50 employees