Skip to content

API Team: Invest in a team which owns REST and GraphQL as a Product

From the decision made at the FY26Q1 Tech Summit -- documented in https://docs.google.com/document/d/1VNB3ivS9aCJc-fck1TLP48pzFYRsEPASLijn9ufXctY/edit?tab=t.2fcx3kdhhtj#bookmark=id.djz9l4fdc97u:

Status

We're actively recruiting internal candidates:rocket:

  1. 1 Staff Backend Engineer - Apply here for Staff level
  2. 2 Backend Engineers - Apply here for Intermediate or Senior levels

Full announcement - #45 (comment 2487328114)

Team focus

Invest in a team that has long term ownership on the API surface in REST and GraphQL as a product 

  1. Action: Fix and maintain the rake tasks that will generate OpenAPI spec based on Grape API definitions (example of using Optic fuzzing to generate CDot OpenAPI docs). The team should also be responsible for automatically updating the docs based on this. See epic gitlab-org&5792
  2. Note: We should be able to mark individual fields as experimental/EE only, etc (with annotations) -- gitlab-org/gitlab#520258 (closed)
  3. Action: Investigate whether we can automatically generate API specs and then auto translate it to REST+GraphQL -- gitlab-org/gitlab#520262
    1. REST APIs from GraphQL endpoints (doesn’t have to work in all cases)
    2. Some to create a blueprint
  4. Action: Investigate observability for GraphQL API
Edited by Amy Phillips