Agent Interface
REST API v4GraphQL APIWebhooksCI/CD Pipeline Triggers
What an agent can do
- ✓Create, read, and manage repositories, branches, and merge requests
- ✓Trigger and monitor CI/CD pipelines
- ✓Manage issues, labels, milestones, and boards
- ✓Search across projects, issues, and merge requests
- ✓Manage container registry and package registry
- ✓Access and configure project-level settings and variables
What it can't do
- ✗Modify instance-level admin settings via API (self-hosted only)
- ✗Access GitLab Duo AI features programmatically
- ✗Stream CI/CD job logs in real-time via REST (need WebSocket)
- ✗Manage GitLab Pages custom domains via API
- ✗Access security dashboard data on Free tier
Auth Model
OAuth 2.0Personal Access TokenProject/Group Access TokenCI/CD Job Token
Builder Notes
Comprehensive API covering the full DevOps lifecycle. GraphQL API offers efficient data fetching for complex queries. Pipeline triggers enable CI/CD-as-a-service patterns. Rate limits: 2,000 req/min authenticated.
Sources
Last verified: 2026-03-15