Trylle Documentation

listRepositories

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

workspaceId?string

Workspace id. Defaults to DEFAULT_WORKSPACE_ID when omitted.

page?integer

One-indexed page. Handler clamps values below 1 to 1.

Formatint64

Range1 <= value

Default1

per_page?integer

Items per page. Handler defaults to 30 and clamps above 100.

Formatint64

Range1 <= value <= 100

Default30

cursor?string

Base64 cursor encoding page and per_page; overrides page/per_page when valid.

Response Body

`application/json`

curl -X GET "https://example.com/v1/repositories?workspaceId=abc123&page=2&per_page=2&cursor=abc123"

"abc123"

createRepository

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

autoInit?boolean

Whether to initialize the repository.

defaultBranch?string

Initial default branch.

description?string

Repository description.

name*string

Repository name.

Length1 <= length

owner?string

Owner handle. Defaults to the authenticated viewer; may also be an organization the viewer is a member of.

private?boolean

Whether the repository is private.

workspaceId?string

Workspace id. Defaults to DEFAULT_WORKSPACE_ID when omitted.

Response Body

`application/json`

curl -X POST "https://example.com/v1/repositories" \  -H "Content-Type: application/json" \  -d '{    "autoInit": false,    "defaultBranch": "abc123",    "description": "abc123",    "name": "aa",    "owner": "abc123",    "private": false,    "workspaceId": "abc123"  }'

"abc123"

getParticipationBatch

Load default-branch participation histograms for a bounded repository list using one Redis MGET.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

Bounded repository participation request.

TypeScript Definitions

Use the request body type in TypeScript.

repositories*array<>

Repositories to load in input order.

Items1 <= items <= 50

Response Body

`application/json`

curl -X POST "https://example.com/v1/repositories/participation/batch" \  -H "Content-Type: application/json" \  -d '{    "repositories": [      {        "name": "aa",        "owner": "aa"      },      {        "name": "aa",        "owner": "aa"      }    ]  }'

{  "items": [    {      "name": "aa",      "owner": "aa",      "weeklyCommits": [        1,        1,        1      ]    },    {      "name": "aa",      "owner": "aa",      "weeklyCommits": [        1,        1,        1      ]    }  ]}

getRepository

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v1/repositories/aa/aa"

"abc123"

editRepository

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

allowMergeCommits?boolean

Whether merge commits are allowed.

allowRebase?boolean

Whether rebase merges are allowed.

allowRebaseUpdate?boolean

Whether contributor branches can be updated by rebase.

allowSquashMerge?boolean

Whether squash merges are allowed.

archived?boolean

Whether the repository is archived.

defaultAllowMaintainerEdit?boolean

Whether maintainers can edit contributor branches by default.

defaultBranch?string

Default branch name.

defaultDeleteBranchAfterMerge?boolean

Whether to delete the head branch after merge by default.

description?string

Repository description.

expectedRepositoryId*string

Immutable repository ID required to fence path reuse.

Length1 <= length

hasIssues?boolean

Whether the issue tracker is enabled.

newName?string

New repository name (rename). Changes the repository URL.

private?boolean

Whether the repository is private.

Response Body

`application/json`

curl -X PATCH "https://example.com/v1/repositories/aa/aa" \  -H "Content-Type: application/json" \  -d '{    "allowMergeCommits": false,    "allowRebase": false,    "allowRebaseUpdate": false,    "allowSquashMerge": false,    "archived": false,    "defaultAllowMaintainerEdit": false,    "defaultBranch": "abc123",    "defaultDeleteBranchAfterMerge": false,    "description": "abc123",    "expectedRepositoryId": "aa",    "hasIssues": false,    "newName": "abc123",    "private": false  }'

"abc123"

deleteRepository

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name.

Length1 <= length

Header Parameters

X-Trylle-Expected-Repository-ID*string

Immutable repository ID required to fence path reuse.

Length1 <= length

Response Body

`application/json`

curl -X DELETE "https://example.com/v1/repositories/aa/aa" \  -H "X-Trylle-Expected-Repository-ID: aa"

"abc123"

repoContributors

Top contributors (by commit count) for a public repository's default branch. Optional auth; public repositories only.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Query Parameters

limit?integer

Maximum contributors to return. Handler defaults to 5.

Formatint64

Response Body

`application/json`

curl -X GET "https://example.com/v1/repositories/aa/aa/contributors?limit=1"

"abc123"

forkRepository

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Request Body

application/json

Fork request body.

TypeScript Definitions

Use the request body type in TypeScript.

name?string

Optional fork name.

Response Body

`application/json`

curl -X POST "https://example.com/v1/repositories/aa/aa/fork" \  -H "Content-Type: application/json" \  -d '{    "name": "abc123"  }'

"abc123"

getRepoLanguages

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v1/repositories/aa/aa/languages"

"abc123"

getParticipation

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Query Parameters

ref?string

Reserved for future bounded custom-ref support; currently the authoritative default branch is always used.

Response Body

`application/json`

curl -X GET "https://example.com/v1/repositories/aa/aa/participation?ref=abc123"

{  "weeklyCommits": [    1,    1,    1  ]}

getRecentPushableBranch

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Response Body

`application/json`

curl -X GET "https://example.com/v1/repositories/aa/aa/recent-pushable-branch"

"abc123"

setStarred

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name from the {name} path segment.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

starred?boolean

Whether the viewer has starred the repository.

Response Body

`application/json`

curl -X POST "https://example.com/v1/repositories/aa/aa/star" \  -H "Content-Type: application/json" \  -d '{    "starred": false  }'

"abc123"

transferRepository

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

owner*string

Repository owner namespace.

Length1 <= length

name*string

Repository name.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

expectedRepositoryId*string

Immutable repository ID required to fence path reuse.

Length1 <= length

newOwner*string

New owner login.

Length1 <= length

Response Body

`application/json`

curl -X POST "https://example.com/v1/repositories/aa/aa/transfer" \  -H "Content-Type: application/json" \  -d '{    "expectedRepositoryId": "aa",    "newOwner": "aa"  }'

"abc123"

Repositories

200application/json

201application/json

200application/json

200application/json

200application/json

200application/json

200application/json

201application/json

200application/json

200application/json

200application/json

200application/json

200application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`