Coelevate Documentation
API ReferenceContext Repository

List changesets

Returns the project's changesets, newest first: the open one and every one that was merged, closed or invalidated.

GET /context/v1/changesets

Returns the project's changesets, newest first: the open one and every one that was merged, closed or invalidated. Nothing is deleted, so a closed changeset is the record of what was turned down. view=summary lists each changeset's ops in short form (identity and who staged them, without edit bodies or review items); the default full view returns them whole.

Requires the context:read scope.

Parameters

ParameterLocationRequiredDescription
limitquerynoReturn at most this many changesets, from 1 to 200. Defaults to 50.
offsetquerynoSkip this many changesets before returning. Defaults to 0.
viewquerynosummary returns each changeset's ops in short form, without edit bodies or review items; full, the default, returns them whole.

Responses

StatusMeaning
200The request succeeded.
401The token is missing, expired or invalid.
403The token does not carry the scope this operation requires.
404No such project, or the token belongs to a different project.
422The request was not valid: a parameter or the body failed validation.

The 200 response body:

FieldTypeRequiredDescription
changesetsarray of objectyesEach changeset as the history lists it: its status, release, counts and its ops, in short form with view=summary and whole with view=full.

Example

curl -sS "$API_URL/context/v1/changesets" \
  -H "Authorization: Bearer $TOKEN"