TrylleDocs
API ReferenceOpenAPI 3 reference

Pull requests

listPullRequests

GET
/v1/pull-requests

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

owner*string

Repository owner query value.

Length1 <= length
repo*string

Repository name query value.

Length1 <= length
state?string

Pull request state filter forwarded to git-gateway (open, closed, all).

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/pull-requests?owner=aa&repo=aa&state=abc123&page=2&per_page=2&cursor=abc123"
"abc123"

myPulls

GET
/v1/pulls/mine

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

state?string

Pull request state filter forwarded to git-gateway.

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/pulls/mine?state=abc123&page=2&per_page=2&cursor=abc123"
"abc123"

createPull

POST
/v1/repositories/{owner}/{name}/pulls

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.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls" \  -H "Content-Type: application/json" \  -d '{    "assignees": [      "abc123"    ],    "base": "aa",    "body": "abc123",    "draft": false,    "head": "aa",    "labels": [      "abc123"    ],    "reviewers": [      "abc123"    ],    "teamReviewers": [      "abc123"    ],    "team_reviewers": [      "abc123"    ],    "title": "aa"  }'
"abc123"

getPullChecksBatch

GET
/v1/repositories/{owner}/{name}/pulls/checks

Return check-run snapshots for a bounded set of pull requests in one repository.

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

numbers*array<>

Repeated pull request numbers (maximum 25).

Items1 <= items <= 25

Response Body

application/json

curl -X GET "https://example.com/v1/repositories/aa/aa/pulls/checks?numbers=1&numbers=1"
"abc123"

listPullStackEvents

GET
/v1/repositories/{owner}/{name}/pulls/stack-events

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/pulls/stack-events"
"abc123"

getPullPage

GET
/v1/repositories/{owner}/{name}/pulls/{number}

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Response Body

application/json

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

editPull

PATCH
/v1/repositories/{owner}/{name}/pulls/{number}

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PATCH "https://example.com/v1/repositories/aa/aa/pulls/2" \  -H "Content-Type: application/json" \  -d '{    "assignees": [      "abc123"    ],    "body": "abc123",    "draft": false,    "ready_for_review": false,    "state": "abc123",    "title": "abc123"  }'
"abc123"

listPullChangelog

GET
/v1/repositories/{owner}/{name}/pulls/{number}/changelog

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
number*integer

Pull request number.

Formatint64
Range1 <= value

Query Parameters

head_sha?string

Head commit SHA filter; omit for all heads.

model*string

AI model identifier (e.g. claude-sonnet-5).

Length1 <= length

Response Body

application/json

curl -X GET "https://example.com/v1/repositories/aa/aa/pulls/2/changelog?head_sha=abc123&model=aa"
"abc123"

upsertPullChangelog

PUT
/v1/repositories/{owner}/{name}/pulls/{number}/changelog

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
number*integer

Pull request number.

Formatint64
Range1 <= value

Header Parameters

X-Trylle-Expected-Repository-ID*string

Immutable repository identity captured by the authorized changelog read.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PUT "https://example.com/v1/repositories/aa/aa/pulls/2/changelog" \  -H "X-Trylle-Expected-Repository-ID: aa" \  -H "Content-Type: application/json" \  -d '{    "data": "abc123",    "file_sha": "abc123",    "head_sha": "abc123",    "model": "aa"  }'
"abc123"

mergePull

POST
/v1/repositories/{owner}/{name}/pulls/{number}/merge

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/merge" \  -H "Content-Type: application/json" \  -d '{    "Do": "aa",    "MergeMessageField": "abc123",    "MergeTitleField": "abc123",    "delete_branch_after_merge": false,    "force_merge": false,    "head_commit_id": "abc123"  }'
"abc123"

requestPullReviewers

POST
/v1/repositories/{owner}/{name}/pulls/{number}/requested-reviewers

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/requested-reviewers" \  -H "Content-Type: application/json" \  -d '{    "reviewers": [      "abc123"    ],    "teamReviewers": [      "abc123"    ],    "team_reviewers": [      "abc123"    ]  }'
"abc123"

removePullReviewers

DELETE
/v1/repositories/{owner}/{name}/pulls/{number}/requested-reviewers

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X DELETE "https://example.com/v1/repositories/aa/aa/pulls/2/requested-reviewers" \  -H "Content-Type: application/json" \  -d '{    "reviewers": [      "abc123"    ],    "teamReviewers": [      "abc123"    ],    "team_reviewers": [      "abc123"    ]  }'
"abc123"

getPullReviewBundle

GET
/v1/repositories/{owner}/{name}/pulls/{number}/review-bundle

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Response Body

application/json

curl -X GET "https://example.com/v1/repositories/aa/aa/pulls/2/review-bundle"
"abc123"

getPullReviewComments

GET
/v1/repositories/{owner}/{name}/pulls/{number}/review-comments

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Response Body

application/json

curl -X GET "https://example.com/v1/repositories/aa/aa/pulls/2/review-comments"
"abc123"

deletePullReviewComment

DELETE
/v1/repositories/{owner}/{name}/pulls/{number}/review-comments/{commentId}

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value
commentId*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Response Body

application/json

curl -X DELETE "https://example.com/v1/repositories/aa/aa/pulls/2/review-comments/2"
"abc123"

replyToPullReviewComment

POST
/v1/repositories/{owner}/{name}/pulls/{number}/review-comments/{commentId}/reply

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value
commentId*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/review-comments/2/reply" \  -H "Content-Type: application/json" \  -d '{    "body": "aa"  }'
"abc123"

markPullReviewCommentConversation

POST
/v1/repositories/{owner}/{name}/pulls/{number}/review-comments/{commentId}/resolution

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value
commentId*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/review-comments/2/resolution" \  -H "Content-Type: application/json" \  -d '{    "resolved": false  }'
"abc123"

createPullReview

POST
/v1/repositories/{owner}/{name}/pulls/{number}/reviews

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/reviews" \  -H "Content-Type: application/json" \  -d '{    "body": "abc123",    "comments": [      {        "body": "abc123",        "new_position": 1,        "old_position": 1,        "path": "abc123"      }    ],    "commit_id": "abc123",    "event": "abc123"  }'
"abc123"

dismissPullReview

POST
/v1/repositories/{owner}/{name}/pulls/{number}/reviews/{id}/dismiss

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value
id*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/reviews/2/dismiss" \  -H "Content-Type: application/json" \  -d '{    "message": "abc123",    "priors": false  }'
"abc123"

setPullStackParent

PUT
/v1/repositories/{owner}/{name}/pulls/{number}/stack-parent

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PUT "https://example.com/v1/repositories/aa/aa/pulls/2/stack-parent" \  -H "Content-Type: application/json" \  -d '{    "parentNumber": 1  }'
"abc123"

syncPullStackChildren

POST
/v1/repositories/{owner}/{name}/pulls/{number}/stack-sync-children

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/stack-sync-children" \  -H "Content-Type: application/json" \  -d '{    "parentNumber": 1  }'
"abc123"

getPullStatus

GET
/v1/repositories/{owner}/{name}/pulls/{number}/status

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Response Body

application/json

curl -X GET "https://example.com/v1/repositories/aa/aa/pulls/2/status"
"abc123"

updatePullBranch

POST
/v1/repositories/{owner}/{name}/pulls/{number}/update

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
number*integer

Positive issue, pull, review, or comment number.

Formatint64
Range1 <= value

Query Parameters

style?string

Update style. Defaults to merge.

Default"merge"

Response Body

application/json

curl -X POST "https://example.com/v1/repositories/aa/aa/pulls/2/update?style=abc123"
"abc123"

Issues

Previous Page

Privacy Policy

How Trylle collects, stores, uses, shares, and protects account and repository data.