Remote Docs Team Lead — API Docs & AI Tools

Payabli; Miami (FL); Remote; USD 120,000 - 180,000; Full time

Benefits offered by this job

Competitive salary

Stock options

Flexible PTO

Medical, dental, & vision insurance

401K

Job summary

Payabli, the Intelligent Fintech Operating System, is seeking a Senior Docs Team Lead to guide a small team of technical writers and own the API reference for our embedded payments APIs. You will balance hands-on writing with strategic leadership, shaping how developers integrate with Payabli’s Pay In, Pay Out and Pay Ops products.

You will manage docs tooling, CI/CD, and AI-assisted workflows, ensuring high-quality, human-verified documentation.

Qualifications

• 8+ years in technical writing or developer documentation, with real API reference experience.
• Experience leading or mentoring technical writers
• Deep OpenAPI experience, plus docs-as-code workflows with Git, pull requests, CI and Markdown/MDX
• Ability to read API responses, write scripts (TypeScript or Python) and build docOps tools
• Hands-on experience using AI coding agents in a docs workflow, and judgment about where they fail
• A habit of verifying everything, and saying “I don’t know yet” instead of guessing
• Clear written communication, async-first

Responsibilities

• Lead the team by guiding two technical writers, conducting 1:1s, and ensuring ownership areas are clear.
• Own the API reference for our embedded payments API across Pay In, Pay Out and Pay Ops, using OpenAPI 3.1.
• Oversee information architecture, docs CI/CD, style guides, and linting rules.
• Use AI agents in daily workflows with human review gates.
• Review PRs touching docs to ensure quality before SMEs see them.
• Triage incoming engineering/product work to create docs tickets with priorities and ship dates.
• Ship docs with every monthly production release, including API changelog and feature docs.
• Maintain SLA adherence and communicate releases and timelines to stakeholders.
• Own our public agent skills plugin and related tooling, keeping them up to date with API changes.
• Publish a monthly State of the Docs report using product analytics, AI chat and search data.
• Track team velocity and post-release work to set targets for each period

Skills

Technical writing

API reference

OpenAPI

Leadership

Docs tooling

Tools

Git

Markdown/MDX

OpenAPI 3.1

CI/CD

Job description

Payabli, the Intelligent Fintech Operating System, is seeking a Senior Docs Team Lead to guide a small team of technical writers and own the API reference for our embedded payments APIs. You will balance hands-on writing with strategic leadership, shaping how developers integrate with Payabli’s Pay In, Pay Out and Pay Ops products.

You will manage docs tooling, CI/CD, and AI-assisted workflows, ensuring high-quality, human-verified documentation.