What are the responsibilities and job description for the API Developer Portal & Documentation Engineer position at Vertiv?
Job Summary
JOB DESCRIPTION
We are looking for a skilled API Developer Portal & Documentation Engineer to lead the design, implementation, and continuous improvement of a centralized API documentation experience. In this role, you will ensure all edge, gateway, and platform APIs across Vertiv are clearly documented, discoverable, and aligned with governance standards. You will own the developer portal infrastructure, drive consistency across teams, and serve as a bridge between engineering output and developer usability.
Key Responsibilities
You will work closely with API architects, integration engineers, and product managers to support API and API related goals of modular, governed, and schema-driven API ecosystems. This role plays a critical part in enabling internal and third-party developers to understand, adopt, and implement APIs confidently and consistently.
Time Travel Required
OUR CORE PRINCIPALS: Safety. Integrity. Respect. Teamwork. Diversity & Inclusion.
OUR STRATEGIC PRIORITIES
Vertiv is a $8.0 billion global critical infrastructure and data center technology company. We ensure customers’ vital applications run continuously by bringing together hardware, software, analytics and ongoing services. Our portfolio includes power, cooling and IT infrastructure solutions and services that extends from the cloud to the edge of the network. Headquartered in Columbus, Ohio, USA, Vertiv employs around 20,000 people and does business in more than 130 countries. Visit Vertiv.com to learn more.
Work Authorization
No calls or agencies please. Vertiv will only employ those who are legally authorized to work in the United States. This is not a position for which sponsorship will be provided. Individuals with temporary visas such as E, F-1, H-1, H-2, L, B, J, or TN or who need sponsorship for work authorization now or in the future, are not eligible for hire.
Equal Opportunity Employer
Vertiv is an Equal Opportunity/Affirmative Action employer. We promote equal opportunities for all with respect to hiring, terms of employment, mobility, training, compensation, and occupational health, without discrimination as to age, race, color, religion, creed, sex, pregnancy status (including childbirth, breastfeeding, or related medical conditions), marital status, sexual orientation, gender identity / expression (including transgender status or sexual stereotypes), genetic information, citizenship status, national origin, protected veteran status, political affiliation, or disability. If you have a disability and are having difficulty accessing or using this website to apply for a position, you can request help by sending an email to help.join@vertiv.com.
JOB DESCRIPTION
We are looking for a skilled API Developer Portal & Documentation Engineer to lead the design, implementation, and continuous improvement of a centralized API documentation experience. In this role, you will ensure all edge, gateway, and platform APIs across Vertiv are clearly documented, discoverable, and aligned with governance standards. You will own the developer portal infrastructure, drive consistency across teams, and serve as a bridge between engineering output and developer usability.
Key Responsibilities
- Portal Design & Deployment: Architect and implement a unified API developer portal using platforms such as SwaggerHub, Redoc, or GitHub Pages—supporting modular documentation aligned with product and domain-specific API subsets.
- API Documentation Ownership: Write, maintain, and publish OpenAPI specifications, usage tutorials, onboarding guides, and integration how-tos for internal and external developers.
- Content Governance & Quality Control: Establish and enforce documentation style guides, reusable templates, and governance checklists to ensure API documentation across teams remains consistent, compliant, and up-to-date.
- Developer Enablement & Tooling: Enable real-time testing via "Try It Out" API consoles, SDK generation, and build sample applications or Postman collections to accelerate adoption and integration.
- Feedback & Iterative Improvement: Actively engage with developers and internal stakeholders to collect feedback, track documentation pain points, and continuously evolve the portal and content experience.
- Education: Bachelor’s degree in Computer Science, Software Engineering, Technical Communication, or a related field.
- Experience:
- 3 years documenting RESTful APIs and managing developer portals or platforms.
- Strong experience working with OpenAPI/Swagger, Postman, and version control tools (e.g., GitHub).
- Skills:
- Excellent writing and visual communication skills tailored for technical audiences.
- Ability to collaborate closely with engineers to extract and articulate accurate technical details.
- Familiarity with publishing workflows and structured documentation strategies.
- Familiarity with non-REST APIs, such as GraphQL, gRPC, or event-driven models (AsyncAPI).
- Experience managing developer communities, forums, or third-party support channels.
- Basic understanding of front-end technologies (HTML, CSS, JavaScript) for portal customization.
You will work closely with API architects, integration engineers, and product managers to support API and API related goals of modular, governed, and schema-driven API ecosystems. This role plays a critical part in enabling internal and third-party developers to understand, adopt, and implement APIs confidently and consistently.
Time Travel Required
- 25%
OUR CORE PRINCIPALS: Safety. Integrity. Respect. Teamwork. Diversity & Inclusion.
OUR STRATEGIC PRIORITIES
- Customer Focus
- Operational Excellence
- High-Performance Culture
- Innovation
- Financial Strength
- Own It
- Act With Urgency
- Foster a Customer-First Mindset
- Think Big and Execute
- Lead by Example
- Drive Continuous Improvement
- Learn and Seek Out Development
Vertiv is a $8.0 billion global critical infrastructure and data center technology company. We ensure customers’ vital applications run continuously by bringing together hardware, software, analytics and ongoing services. Our portfolio includes power, cooling and IT infrastructure solutions and services that extends from the cloud to the edge of the network. Headquartered in Columbus, Ohio, USA, Vertiv employs around 20,000 people and does business in more than 130 countries. Visit Vertiv.com to learn more.
Work Authorization
No calls or agencies please. Vertiv will only employ those who are legally authorized to work in the United States. This is not a position for which sponsorship will be provided. Individuals with temporary visas such as E, F-1, H-1, H-2, L, B, J, or TN or who need sponsorship for work authorization now or in the future, are not eligible for hire.
Equal Opportunity Employer
Vertiv is an Equal Opportunity/Affirmative Action employer. We promote equal opportunities for all with respect to hiring, terms of employment, mobility, training, compensation, and occupational health, without discrimination as to age, race, color, religion, creed, sex, pregnancy status (including childbirth, breastfeeding, or related medical conditions), marital status, sexual orientation, gender identity / expression (including transgender status or sexual stereotypes), genetic information, citizenship status, national origin, protected veteran status, political affiliation, or disability. If you have a disability and are having difficulty accessing or using this website to apply for a position, you can request help by sending an email to help.join@vertiv.com.