Apps

Set App Source

Bind this app to the repository a build should fetch (J1).

Idempotent, and a REPLACE rather than a merge: every field is written, so rebinding from one provider to another cannot leave the previous provider's credential pointer behind. A build fetching a new repo with a stale credential is the failure this shape exists to prevent.

There is no GET here on purpose. Source is 1:1 with the app and comes back on GET /apps/{app_id} through AppResponse, so a separate read would be a second thing to keep in step for no new information.

credential_ref is a POINTER to a secret, never a secret. The DTO says so and the column comment says so, because a token written here would also live in every backup of the control plane and in this route's own response.

put/apps/{app_id}/source

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/apps/{app_id}/source
  • Auth: HTTP bearer

Path parameters

app_idstring required

Headers

Authorizationstring nullable
X-Org-Idstring nullable

Request body

repo_urlstring required

Clone URL.

providerstring required

One of: github, gitlab, bitbucket.

default_branchstring nullable

Defaults to the repository's own default when omitted.

credential_refstring nullable

Secret-manager PATH for the fetch credential. Never the credential itself.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.