Location:
Edinburgh, Scotland
Team:
Technology Product
Job Requisition #: R257498
Date posted: Oct. 21, 2025
Job description
About this role
Technical Writer – APIs & Event Streaming (Aladdin Studio)
Aladdin Studio is transforming how developers and data engineers interact with the Aladdin ecosystem — enabling teams to build, integrate, and extend the Aladdin platform through open APIs and event-driven workflows.
We're seeking an experienced Technical Writer with a strong background in API documentation, event streaming, and developer experience to help define and deliver world-class documentation for the Aladdin Studio developer platform.
You'll play a pivotal role in helping developers and integration partners understand how to connect to Aladdin's services, leverage streaming data, and build innovative applications on top of our platform.
Key Responsibilities
* Develop and maintain clear, accurate, and engaging documentation for Aladdin Studio's APIs, SDKs, and event streaming interfaces.
* Collaborate closely with engineers, product managers, and developer experience teams to translate complex technical concepts into approachable guides, tutorials, and reference materials.
* Document event-driven workflows, including streaming APIs, webhook subscriptions, and real-time data integration patterns.
* Design and implement content structures that scale across multiple APIs, microservices, and event channels within Aladdin Studio.
* Contribute to tooling and automation, using OpenAPI/AsyncAPI specs and CI/CD pipelines to generate and version developer documentation.
* Partner with Studio Product Marketing and Solution Architecture teamto create onboarding materials, sample code, and "getting started" experiences for external and internal developers.
* Continuously improve the discoverability and usability of content within the Aladdin Studio Developer Portal.
* Champion documentation standards across the Aladdin Product Group, ensuring consistency, clarity, and technical accuracy.
Required Qualifications
* 4+ years of experience as a Technical Writer, Developer Advocate, or Software Engineer focused on APIs or event-driven systems.
* Deep understanding of RESTful and event-streaming architectures (Kafka, Kinesis, or similar).
* Proven experience writing API and developer documentation using OpenAPI/Swagger or AsyncAPI specifications.
* Hands-on familiarity with developer tooling such as Git, Postman, Redocly, or similar platforms.
* Strong grasp of cloud-based integration concepts, including authentication, webhooks, and event publishing/subscription models.
* Excellent written communication skills and ability to translate complex systems into developer-friendly content.
* Proficiency in Markdown, YAML, and basic scripting (Python, JavaScript, or similar).
Preferred Qualifications
* Experience working within a financial technology or enterprise SaaS environment.
* Knowledge of data integration, analytics, or asset and riskmanagement workflows within Aladdin or similar ecosystems.
* Understanding streaming data pipelines and real-time analytics.
* Familiarity with API lifecycle management, and continuous documentation delivery.
* Background in computer science, information systems, or related technical field.
What We Offer
* Opportunity to shape the developer experience for the Aladdin ecosystem, a platform trusted by the world's largest financial institutions.
* A collaborative, growth-oriented environment within BlackRock's Aladdin Product Group.
* Competitive compensation, benefits, and professional development opportunities.
* Direct impact on how external developers and partners extend Aladdin's capabilities through APIs and streaming data.
Our benefits
To help you stay energized, engaged and inspired, we offer a wide range of employee benefits including: retirement investment and tools designed to help you in building a sound financial future; access to education reimbursement; comprehensive resources to support your physical health and emotional well-being; family support programs; and Flexible Time Off (FTO) so you can relax, recharge and be there for the people you care about.
Our hybrid work model
BlackRock's hybrid work model is designed to enable a culture of collaboration and apprenticeship that enriches the experience of our employees, while supporting flexibility for all. Employees are currently required to work at least 4 days in the office per week, with the flexibility to work from home 1 day a week. Some business groups may require more time in the office due to their roles and responsibilities. We remain focused on increasing the impactful moments that arise when we work together in person – aligned with our commitment to performance and innovation. As a new joiner, you can count on this hybrid model to accelerate your learning and onboarding experience here at BlackRock.
About BlackRock
At BlackRock, we are all connected by one mission: to help more and more people experience financial well-being. Our clients, and the people they serve, are saving for retirement, paying for their children's educations, buying homes and starting businesses. Their investments also help to strengthen the global economy: support businesses small and large; finance infrastructure projects that connect and power cities; and facilitate innovations that drive progress.
This mission would not be possible without our smartest investment – the one we make in our employees. It's why we're dedicated to creating an environment where our colleagues feel welcomed, valued and supported with networks, benefits and development opportunities to help them thrive.
For additional information on BlackRock, please visit @blackrock | Twitter: @blackrock | LinkedIn:
BlackRock is proud to be an Equal Opportunity Employer. We evaluate qualified applicants without regard to age, disability, race, religion, sex, sexual orientation and other protected characteristics at law.
Job Requisition #
R257498