Get Repo Url By Id

Resolve the repository URL path for an internal repository ID in the current organisation. The returned url is the value clients use in the JWT repo claim.

JWT claims

Required scopes: org:read
Requires per repo scope: No

GET /api/repo-urls/{repo_id}

Get Repo Url By Id

cURL

curl --request GET \
  --url https://api.{cluster}.code.storage/api/repo-urls/{repo_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "repo_id": "repo_7f2b3d9",
  "repo_name": "team/project-alpha",
  "url": "team/project-alpha"
}

Authorizations

Authorization · string · header · required

JWT bearer token signed with your organization's registered signing key. There is no OAuth authorization server; you mint tokens yourself and the token's scopes claim carries the granted permission scopes. Public scopes: git:read (read repository contents), git:write (write branches, commits, tags, and notes), repo:write (create and manage repositories), org:read (list an organization's repositories). Each operation's security requirement names the scopes it requires. See https://code.storage/docs/getting-started/authentication for how to mint tokens.

Path Parameters

repo_id · string · required

Internal repository ID to resolve.

Response

200

application/json

Repository URL path resolved from the supplied internal repository ID.

Repository URL path resolved from an internal repository ID.

repo_id · string · required

Stable repository identifier.

Example:

"repo_7f2b3d9"

repo_name · string · required

Repository name or path. It can contain a slash. It matches the JWT repo claim.

Example:

"team/project-alpha"

url · string · required · deprecated

Deprecated: use repo_name. Repository name or path, not a full URL.

Example:

"team/project-alpha"