Skip to content

Commit b6204b6

Browse files
devin-ai-integration[bot]bot_apk
andauthored
docs(source-gitlab): improve rate limits, fix outdated tier names, document 403 behavior (#75538)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: bot_apk <apk@cognition.ai>
1 parent 93b1f49 commit b6204b6

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

docs/integrations/sources/gitlab.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -80,8 +80,8 @@ This connector outputs the following streams:
8080
- [Branches](https://docs.gitlab.com/ee/api/branches.html)
8181
- [Commits](https://docs.gitlab.com/ee/api/commits.html) (Incremental)
8282
- [Deployments](https://docs.gitlab.com/ee/api/deployments/index.html)
83-
- [Epic Issues](https://docs.gitlab.com/ee/api/epic_issues.html) (GitLab Ultimate and GitLab.com Gold only)
84-
- [Epics](https://docs.gitlab.com/ee/api/epics.html) (GitLab Ultimate and GitLab.com Gold only)
83+
- [Epic Issues](https://docs.gitlab.com/ee/api/epic_issues.html) (GitLab Ultimate only)
84+
- [Epics](https://docs.gitlab.com/ee/api/epics.html) (GitLab Ultimate only)
8585
- [Group Issue Boards](https://docs.gitlab.com/ee/api/group_boards.html)
8686
- [Group Labels](https://docs.gitlab.com/ee/api/group_labels.html)
8787
- [Group Members](https://docs.gitlab.com/ee/api/members.html)
@@ -109,7 +109,7 @@ This connector uses GitLab API v4. It works with both GitLab.com and self-hosted
109109

110110
### Rate limits
111111

112-
GitLab.com enforces [per-endpoint rate limits](https://docs.gitlab.com/ee/user/gitlab_com/#gitlabcom-specific-rate-limits) on its REST API. Key limits that affect this connector include:
112+
GitLab.com enforces per-endpoint rate limits on its REST API. The following defaults apply to [Groups API](https://docs.gitlab.com/administration/settings/rate_limit_on_members_api/), [Projects API](https://docs.gitlab.com/administration/settings/rate_limit_on_projects_api/), and general authenticated traffic:
113113

114114
| Endpoint | Rate limit |
115115
| :--- | :--- |
@@ -120,9 +120,13 @@ GitLab.com enforces [per-endpoint rate limits](https://docs.gitlab.com/ee/user/g
120120
| `GET /projects/:id/members/all` | 200 requests/min |
121121
| All other authenticated requests | 2,000 requests/min |
122122

123-
Self-hosted GitLab instances may have different rate limits configured by the administrator. If you encounter rate limit errors that are not automatically retried, [create an issue](https://github.com/airbytehq/airbyte/issues).
123+
Self-hosted GitLab instances may have different rate limits configured by the administrator. The connector automatically retries requests that receive HTTP 429 responses. If you encounter persistent rate limit errors, [create an issue](https://github.com/airbytehq/airbyte/issues).
124124

125-
You can adjust the **Number of Concurrent Workers** setting to control how many parallel requests the connector makes. The default value of 8 is suitable for most GitLab.com users. Lower this value if you share your API quota with other integrations.
125+
You can adjust the **Number of Concurrent Workers** setting to control how many parallel requests the connector makes. Lower this value if you share your API quota with other integrations or if you experience rate limiting.
126+
127+
### Inaccessible resources
128+
129+
The connector silently skips any group, project, or resource that returns an HTTP 403 (Forbidden) response. If you notice missing data, verify that your access token has the required permissions for the groups and projects you want to sync.
126130

127131
## Changelog
128132

0 commit comments

Comments
 (0)