Get list of repository refs

curl --request GET \
  --url {schemes}://api.upsun.com/projects/{projectId}/git/refs \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "<string>",
    "ref": "<string>",
    "object": {
      "type": "<string>",
      "sha": "<string>"
    },
    "sha": "<string>"
  }
]

GET

projects

{projectId}

git

refs

Error

A valid request URL is required to generate request examples

[
  {
    "id": "<string>",
    "ref": "<string>",
    "object": {
      "type": "<string>",
      "sha": "<string>"
    },
    "sha": "<string>"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

projectId

string

required

Response

default - application/json

string

required

The identifier of Ref

ref

string

required

The name of the reference

object

Object · object

required

The object the reference points to

Show child attributes

sha

string

required

The commit sha of the ref

Last modified on June 16, 2026

Get a commit object Get a ref object

⌘I