Source source
GET
/api/projects/{projectId}/sources/{sourceId}Signed-in memberRead-only
Path parameters
| Name | Type | Required | Notes |
|---|---|---|---|
projectId | string (uuid) | Required | |
sourceId | string (uuid) | Required |
Response
Success: 200
| Field | Type | Required | Notes |
|---|---|---|---|
id | string (uuid) | Optional | |
type | enum SourceType | Optional | GITHUBGITLABLINEARJIRA |
deliveryMechanism | string | Optional | |
externalProjectKey | string | Optional | |
externalTeamKey | string | Optional | |
owner | string | Optional | |
repository | string | Optional | |
apiBaseUrl | string | Optional | |
externalWorkspaceKey | string | Optional | |
credentialIdentity | string | Optional | |
webhookAuthMode | enum WebhookAuthMode | Optional | GITHUB_HMACGITLAB_SIGNING_TOKENGITLAB_SECRET_TOKENLINEAR_HMACNONE |
webhookId | string (uuid) | Optional | |
webhookPath | string | Optional | |
createdAt | string (date-time) | Optional | |
lastDeliveryAt | string (date-time) | Optional | |
accessTokenConfigured | boolean | Optional | |
accessTokenUpdatedAt | string (date-time) | Optional | |
connectionStatus | enum ConnectionStatus | Optional | ACTIVEERRORDISCONNECTED |
lastSyncAt | string (date-time) | Optional | |
lastErrorCode | string | Optional | |
nextPollAt | string (date-time) | Optional | |
health | SourceHealth | Optional | |
health.connected | boolean | Optional | |
health.disconnectedAt | string (date-time) | Optional | |
health.secretUpdatedAt | string (date-time) | Optional | |
health.signatureFailureCount | integer | Optional | |
health.lastSignatureFailureAt | string (date-time) | Optional | |
health.quiet | boolean | Optional | |
health.quietSince | string (date-time) | Optional | |
health.usualGapHours | integer | Optional | |
health.overdue | boolean | Optional |
Errors
| Status | Code | Applies to |
|---|---|---|
400 | validation_faileda field is missing or out of range | Any endpoint |
400 | invalid_parametera path or query parameter is missing or does not convert, such as an ID that is not a UUID | Any endpoint |
401 | authentication_requiredno session | Any endpoint |
404 | not_foundno such address | Any endpoint |
405 | method_not_allowedthe address does not take that method | Any endpoint |
415 | unsupported_media_typethe address does not read a body of that type | Any endpoint |
500 | internal_errora fault ReleaseFlow did not foresee; the body never carries the exception behind it | Any endpoint |
400 | gitlab_base_url_invalid | Sources area |
400 | gitlab_host_not_allowed | Sources area |
400 | jira_site_invalid | Sources area |
400 | github_token_rejected | Sources area |
400 | gitlab_token_rejected | Sources area |
400 | linear_token_rejected | Sources area |
400 | jira_token_rejected | Sources area |
400 | source_credential_required | Sources area |
400 | source_signing_token_invalid | Sources area |
404 | project_not_found | Sources area |
404 | source_not_found | Sources area |
409 | github_repository_already_connected | Sources area |
409 | gitlab_project_already_connected | Sources area |
409 | linear_team_already_connected | Sources area |
409 | jira_project_already_connected | Sources area |
409 | source_token_missing | Sources area |
409 | source_sync_in_progress | Sources area |
409 | source_import_not_supported | Sources area |
409 | source_import_not_resumable | Sources area |
409 | source_disconnected | Sources area |
409 | source_not_disconnected | Sources area |
409 | source_reconnect_required | Sources area |
409 | source_has_no_webhook | Sources area |
409 | source_secret_generated | Sources area |
409 | source_secret_pasted | Sources area |
503 | github_unavailable | Sources area |
503 | gitlab_unavailable | Sources area |
503 | jira_unavailable | Sources area |
Request
bash
# Sign in first and keep the session cookie in cookies.txt (see Sessions and CSRF).
curl "http://localhost:8080/api/projects/$PROJECT_ID/sources/$SOURCE_ID" \
-b cookies.txt -c cookies.txt
Response
200Example
{
"id": "<uuid>",
"type": "GITHUB",
"deliveryMechanism": "<string>",
"externalProjectKey": "<string>",
"externalTeamKey": "<string>",
"owner": "<string>",
"repository": "<string>",
"apiBaseUrl": "<string>",
"externalWorkspaceKey": "<string>",
"credentialIdentity": "<string>",
"webhookAuthMode": "GITHUB_HMAC",
"webhookId": "<uuid>",
"webhookPath": "<string>",
"createdAt": "<date-time>",
"lastDeliveryAt": "<date-time>",
"accessTokenConfigured": false,
"accessTokenUpdatedAt": "<date-time>",
"connectionStatus": "ACTIVE",
"lastSyncAt": "<date-time>",
"lastErrorCode": "<string>",
"nextPollAt": "<date-time>",
"health": {
"connected": false,
"disconnectedAt": "<date-time>",
"secretUpdatedAt": "<date-time>",
"signatureFailureCount": 0,
"lastSignatureFailureAt": "<date-time>",
"quiet": false,
"quietSince": "<date-time>",
"usualGapHours": 0,
"overdue": false
}
}