Workflow GitHub
6 Endpunkte. Basis-URL: https://xapi.ambertech.cloud/api/v1
Connect a GitHub Personal Access Token (org- or space-scoped)#
POST
/workflow-github/connectTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | any | – |
Antworten
- 201Connected; token stored encrypted
- 400Missing token or invalid token
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/workflow-github/connect" \
-H "Authorization: Bearer $XISUITE_TOKEN"Get the active GitHub connection for the scope (no secret)#
GET
/workflow-github/connectionTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | any | – |
Antworten
- 200Connection summary
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/workflow-github/connection" \
-H "Authorization: Bearer $XISUITE_TOKEN"Disconnect the scope's GitHub connection#
DELETE
/workflow-github/connectionTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | any | – |
Antworten
- 200Disconnected
Beispiel (cURL)
curl -X DELETE "https://xapi.ambertech.cloud/api/v1/workflow-github/connection" \
-H "Authorization: Bearer $XISUITE_TOKEN"List the connected GitHub account's repositories#
GET
/workflow-github/reposTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | any | – |
Antworten
- 200Repository list
- 401GitHub token revoked/expired
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/workflow-github/repos" \
-H "Authorization: Bearer $XISUITE_TOKEN"Register a GitHub webhook on a repo for the workflow git triggers#
POST
/workflow-github/repos/webhookTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | any | – |
Antworten
- 201Webhook registered (or already present)
- 403Token lacks repo-admin (webhook) permission
Beispiel (cURL)
curl -X POST "https://xapi.ambertech.cloud/api/v1/workflow-github/repos/webhook" \
-H "Authorization: Bearer $XISUITE_TOKEN"List recent git-trigger events for the scope#
GET
/workflow-github/trigger-eventsTokenParameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
spaceId | Query | string | – |
workflowId | Query | string | – |
Antworten
- 200Recent git-trigger events
Beispiel (cURL)
curl -X GET "https://xapi.ambertech.cloud/api/v1/workflow-github/trigger-events" \
-H "Authorization: Bearer $XISUITE_TOKEN"