Harness

Harness Pullreq API

The pullreq API from Harness — 40 operation(s) for pullreq.

GitHub OpenAPI

Operations 52

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /code/api/v1/pullreq List pull requests across an account, org or project · List pull requests in account/org/project #
Ask an LLM
“Can I see every open pull request across all repos in my Harness project at once?”
“Which pull requests across my whole org are waiting on my review?”
Tell an agent
List all open pull requests across every repo in account {account}.
Show pull requests across all repos in project {project} that target branch {target_branch}.
GET /code/api/v1/pullreq/count Count pull requests across an account, org or project · Count pull requests in account/org/project #
Ask an LLM
“How many pull requests are open across all repositories in my project?”
“What's the total number of merged PRs in my org, without listing them?”
Tell an agent
Count the pull requests in state {state} across all repos in account {account}.
Give me a count of PRs authored by {author_id} across the whole org.
GET /code/api/v1/repos/{repo_identifier}/pullreq List pull requests in a repository · List pull requests #
Ask an LLM
“What pull requests are open in one specific Harness Code repository?”
“Can I sort a single repo's pull requests by when they were last updated?”
Tell an agent
List the open pull requests in repo {repo_identifier}.
Show pull requests in repo {repo_identifier} coming from branch {source_branch}.
POST /code/api/v1/repos/{repo_identifier}/pullreq Open a pull request · Create pull request #
Ask an LLM
“How do I open a pull request from a feature branch into main?”
“Can I open a PR as a draft and assign reviewers in the same step?”
Tell an agent
Open a pull request in repo {repo_identifier} from {source_branch} into {target_branch} titled {title}.
Create a draft PR in {repo_identifier} from branch {source_branch} with reviewers {reviewer_ids}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number} Get a pull request · Get pull request #
Ask an LLM
“Where can I look up the title, branches and state of one pull request by its number?”
“Is pull request number 42 still open or already merged?”
Tell an agent
Fetch pull request #{pullreq_number} in repo {repo_identifier}.
Show me the details of PR {pullreq_number} in {repo_identifier}.
PATCH /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number} Edit a pull request's title or description · Update pull request #
Ask an LLM
“Can I rename a pull request after it's been opened?”
“How do I rewrite the description on an existing PR?”
Tell an agent
Change the title of PR #{pullreq_number} in {repo_identifier} to {title}.
Replace the description of pull request {pullreq_number} in repo {repo_identifier} with {description}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/activities List a pull request's activity timeline · List activities #
Ask an LLM
“What has happened on a pull request so far, comments, reviews and state changes included?”
“Can I filter a PR's activity feed to only one kind of event?”
Tell an agent
Show the activity timeline for PR #{pullreq_number} in {repo_identifier}.
List activities of kind {kind} on pull request {pullreq_number} in repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/automerge Turn off auto-merge for a pull request · Disable the auto-merge option for the pull request #
Ask an LLM
“How do I stop a pull request from merging automatically?”
“Can I cancel auto-merge on a PR without closing it?”
Tell an agent destructive · confirm first
Disable auto-merge on PR #{pullreq_number} in {repo_identifier}.
Cancel the pending auto-merge for pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/automerge Check a pull request's auto-merge setting · Get the auto-merge option for the pull request #
Ask an LLM
“Is auto-merge turned on for this pull request?”
“Which merge method will auto-merge use once my PR's checks pass?”
Tell an agent
Tell me whether auto-merge is enabled on PR #{pullreq_number} in {repo_identifier}.
Get the auto-merge options for pull request {pullreq_number} in repo {repo_identifier}.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/automerge Turn on auto-merge for a pull request · Enable the auto-merge option for the pull request #
Ask an LLM
“Can a pull request merge itself automatically once it's ready?”
“Can auto-merge delete the source branch after it merges my PR?”
Tell an agent
Enable auto-merge on PR #{pullreq_number} in {repo_identifier} using the {method} method.
Set pull request {pullreq_number} in repo {repo_identifier} to auto-merge and delete its source branch afterwards.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/branch Restore a pull request's deleted source branch · Restore source branch #
Ask an LLM
“The source branch of my PR was deleted after merge; can I bring it back?”
“Is there a dry run to see if restoring a PR's branch would break protection rules?”
Tell an agent
Restore the source branch of PR #{pullreq_number} in {repo_identifier}.
Dry-run restoring the deleted source branch for pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/checks Get a pull request's status checks · Get status checks #
Ask an LLM
“Have the CI status checks on my pull request passed?”
“Which checks are failing and blocking this PR?”
Tell an agent
Show the status checks for PR #{pullreq_number} in {repo_identifier}.
List failing checks on pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/codeowners Get code owners for a pull request · Get code owners #
Ask an LLM
“Who are the code owners for the files changed in this pull request?”
“Does my PR still need approval from a CODEOWNERS entry?”
Tell an agent
Show the code owners for PR #{pullreq_number} in {repo_identifier}.
Find which code owners must sign off on pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments Comment on a pull request · Create new pull request comment #
Ask an LLM
“Can I leave a comment on a specific line of a file in a pull request?”
“How do I reply to an existing comment thread on a PR?”
Tell an agent
Post the comment {text} on PR #{pullreq_number} in {repo_identifier}.
Add a code comment {text} on {path} line {line_start} of pull request {pullreq_number} in {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments/{pullreq_comment_id} Delete a pull request comment · Delete pull request comment #
Ask an LLM
“Can I remove a comment I posted on a pull request?”
“What happens to a PR comment once I delete it?”
Tell an agent destructive · confirm first
Delete comment {pullreq_comment_id} on PR #{pullreq_number} in {repo_identifier}.
Remove my comment {pullreq_comment_id} from pull request {pullreq_number} in repo {repo_identifier}.
PATCH /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments/{pullreq_comment_id} Edit a pull request comment · Update pull request comment #
Ask an LLM
“Can I fix a typo in a comment I already left on a PR?”
“Is it possible to change the text of an existing review comment?”
Tell an agent
Change the text of comment {pullreq_comment_id} on PR #{pullreq_number} in {repo_identifier} to {text}.
Edit my comment {pullreq_comment_id} on pull request {pullreq_number} in repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments/{pullreq_comment_id}/reactions/{pullreq_reaction_emoji} Remove an emoji reaction from a PR comment · Remove emoji reaction from pull request comment #
Ask an LLM
“How do I take back an emoji reaction I added to a pull request comment?”
“Can I undo a reaction on a PR comment?”
Tell an agent destructive · confirm first
Remove my {pullreq_reaction_emoji} reaction from comment {pullreq_comment_id} on PR #{pullreq_number} in {repo_identifier}.
Undo the {pullreq_reaction_emoji} emoji on comment {pullreq_comment_id} in pull request {pullreq_number} of repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments/{pullreq_comment_id}/reactions/{pullreq_reaction_emoji} React to a pull request comment with an emoji · Add emoji reaction to pull request comment #
Ask an LLM
“Can I add a thumbs-up emoji to someone's comment on a pull request?”
“Which emoji reactions can I put on a PR comment?”
Tell an agent
React with {pullreq_reaction_emoji} to comment {pullreq_comment_id} on PR #{pullreq_number} in {repo_identifier}.
Add a {pullreq_reaction_emoji} reaction to comment {pullreq_comment_id} in pull request {pullreq_number} of repo {repo_identifier}.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments/{pullreq_comment_id}/status Resolve or reopen a pull request comment · Update status of pull request comment #
Ask an LLM
“Can I mark a review comment thread as resolved?”
“Is there a way to reopen a PR comment that was resolved too early?”
Tell an agent
Mark comment {pullreq_comment_id} on PR #{pullreq_number} in {repo_identifier} as resolved.
Set the status of comment {pullreq_comment_id} on pull request {pullreq_number} in repo {repo_identifier} to {status}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/comments/apply-suggestions Apply code suggestions from PR comments · Apply pull request code comment suggestions #
Ask an LLM
“Can I commit the code suggestions reviewers left in comments straight to my PR branch?”
“How do I accept several suggested changes on a pull request in one commit?”
Tell an agent
Apply the suggested code changes {suggestions} to PR #{pullreq_number} in {repo_identifier}.
Commit the review suggestions on pull request {pullreq_number} in repo {repo_identifier} with message {message}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/commits List the commits in a pull request · List commits #
Ask an LLM
“Which commits are included in this pull request?”
“How many commits has the author pushed to a PR?”
Tell an agent
List the commits on PR #{pullreq_number} in {repo_identifier}.
Show the commit history of pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/diff Get a pull request's file changes · Get file changes #
Ask an LLM
“What files and lines did this pull request change?”
“Can I see the diff of just one file path within a PR?”
Tell an agent
Show the diff for PR #{pullreq_number} in {repo_identifier}.
Get the changes to file {path} in pull request {pullreq_number} of repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/diff Get a pull request's file changes via POST · Get file changes #
Ask an LLM
“Is there a POST form of the pull request diff endpoint for large file lists?”
“Can I fetch a PR's file changes with a POST request instead of a GET?”
Tell an agent
Fetch the file changes of PR #{pullreq_number} in {repo_identifier} using the POST diff endpoint.
Use the POST variant to retrieve the diff of pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/file-views List files I've marked as viewed in a PR · List viewed files #
Ask an LLM
“Which files in this pull request have I already marked as viewed?”
“How far through reviewing a PR's files am I?”
Tell an agent
List the files I've marked viewed on PR #{pullreq_number} in {repo_identifier}.
Show my viewed-file progress for pull request {pullreq_number} in repo {repo_identifier}.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/file-views Mark a pull request file as viewed · Mark file as viewed #
Ask an LLM
“Can I tick off a file as reviewed while going through a pull request?”
“Does marking a PR file viewed track which commit I reviewed it at?”
Tell an agent
Mark file {path} as viewed on PR #{pullreq_number} in {repo_identifier}.
Record {path} as reviewed at commit {commit_sha} in pull request {pullreq_number} of repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/file-views/{file_path} Unmark a pull request file as viewed · Remove file view #
Ask an LLM
“How do I unmark a file I flagged as viewed in a PR so it shows up again?”
“Can I reset the viewed state of one file in a pull request?”
Tell an agent destructive · confirm first
Unmark {file_path} as viewed on PR #{pullreq_number} in {repo_identifier}.
Clear the viewed flag on file {file_path} in pull request {pullreq_number} of repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/merge Merge a pull request · Merge #
Ask an LLM
“How do I merge a pull request right now with a squash or rebase?”
“Can I dry-run a merge to see if a PR is mergeable before doing it?”
Tell an agent
Merge PR #{pullreq_number} in {repo_identifier} using the {method} method.
Do a dry-run merge of pull request {pullreq_number} in repo {repo_identifier} and tell me if it would succeed.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/mergequeue Remove a pull request from the merge queue · Remove the pull request from the merge queue #
Ask an LLM
“Can I pull a PR back out of the merge queue before it merges?”
“What do I do if I queued the wrong pull request for merge?”
Tell an agent destructive · confirm first
Remove PR #{pullreq_number} in {repo_identifier} from the merge queue.
Dequeue pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/mergequeue Get a pull request's merge queue status · Get the pull request's merge-queue details #
Ask an LLM
“Where is my pull request sitting in the merge queue?”
“Is this PR currently queued to merge into its target branch?”
Tell an agent
Show the merge-queue details for PR #{pullreq_number} in {repo_identifier}.
Check the merge queue position of pull request {pullreq_number} in repo {repo_identifier}.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/mergequeue Add a pull request to the merge queue · Place the pull request to the target branch's merge queue #
Ask an LLM
“How do I put a pull request into the target branch's merge queue?”
“Can a queued PR delete its source branch once the queue merges it?”
Tell an agent
Add PR #{pullreq_number} in {repo_identifier} to the merge queue.
Queue pull request {pullreq_number} in repo {repo_identifier} for merge with the {method} method.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/mergequeue/prioritize Move a pull request to the head of the merge queue · Reorder the merge queue so that this PR is at the head of the queue #
Ask an LLM
“Can I jump an urgent hotfix PR to the front of the merge queue?”
“Is there a way to prioritize one queued pull request over the others?”
Tell an agent
Move PR #{pullreq_number} in {repo_identifier} to the head of the merge queue.
Prioritize pull request {pullreq_number} in repo {repo_identifier} so it merges next.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/metadata Get a pull request's metadata · Get metadata #
Ask an LLM
“Is there a lightweight way to get just the metadata of a pull request?”
“Can I fetch a PR's metadata without loading its full diff or comments?”
Tell an agent
Get the metadata for PR #{pullreq_number} in {repo_identifier}.
Pull only the metadata record of pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/revert Revert a merged pull request · Revert of a merged pull request #
Ask an LLM
“A merged PR broke production; how do I revert it?”
“Can I choose the branch name that the revert of a merged pull request goes on?”
Tell an agent
Revert merged PR #{pullreq_number} in {repo_identifier}.
Create a revert of pull request {pullreq_number} in repo {repo_identifier} on branch {revert_branch}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviewers List a pull request's individual reviewers · List reviewers #
Ask an LLM
“Who is assigned to review this pull request, and have they approved?”
“Which individual reviewers still haven't reviewed my PR?”
Tell an agent
List the individual reviewers on PR #{pullreq_number} in {repo_identifier}.
Show each person reviewing pull request {pullreq_number} in repo {repo_identifier} and their decision.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviewers Add a reviewer to a pull request · Add reviewer #
Ask an LLM
“Can I request a review from a specific teammate on my PR?”
“How do I add one more person as a reviewer after the pull request is open?”
Tell an agent
Add user {reviewer_id} as a reviewer on PR #{pullreq_number} in {repo_identifier}.
Request a review from {reviewer_id} on pull request {pullreq_number} of repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviewers/{pullreq_reviewer_id} Remove a reviewer from a pull request · Remove reviewer #
Ask an LLM
“Can I take someone off the reviewer list of a pull request?”
“What if I assigned the wrong person to review my PR?”
Tell an agent destructive · confirm first
Remove reviewer {pullreq_reviewer_id} from PR #{pullreq_number} in {repo_identifier}.
Unassign user {pullreq_reviewer_id} as a reviewer of pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviewers/combined List all reviewers of a PR, users and groups · Reviewer combined list pull req #
Ask an LLM
“Can I see individual and user-group reviewers of a pull request in one combined list?”
“Which teams and people together are reviewing this PR?”
Tell an agent
Show the combined list of user and group reviewers on PR #{pullreq_number} in {repo_identifier}.
List every reviewer, including user groups, for pull request {pullreq_number} in repo {repo_identifier}.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviewers/usergroups Add a user group as a pull request reviewer · User group reviewer add pull req #
Ask an LLM
“Can I assign a whole team to review a pull request instead of one person?”
“How do I request a review from a user group on a PR?”
Tell an agent
Assign the whole team {usergroup_id} to review PR #{pullreq_number} in {repo_identifier}.
Request a review from the {usergroup_id} group on pull request {pullreq_number} of repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviewers/usergroups/{user_group_id} Remove a user group reviewer from a PR · User group reviewer delete pull req #
Ask an LLM
“Can I take a team off a pull request's reviewers?”
“What's the way to drop a user group from reviewing my PR?”
Tell an agent destructive · confirm first
Remove user group {user_group_id} from the reviewers of PR #{pullreq_number} in {repo_identifier}.
Unassign the {user_group_id} group from reviewing pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/reviews Submit a review on a pull request · Submit review #
Ask an LLM
“How do I approve a pull request?”
“Can I request changes on a PR at a particular commit?”
Tell an agent
Approve PR #{pullreq_number} in {repo_identifier}.
Submit a {decision} review on pull request {pullreq_number} in repo {repo_identifier} at commit {commit_sha}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/state Close, reopen or change draft state of a PR · Update state of pull request #
Ask an LLM
“Can I close a pull request without merging it?”
“How do I mark a draft PR as ready for review?”
Tell an agent
Close PR #{pullreq_number} in {repo_identifier} without merging.
Set the state of pull request {pullreq_number} in repo {repo_identifier} to {state}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/labels List labels suggested for a pull request · List suggested labels #
Ask an LLM
“What labels have been suggested for my pull request but not applied yet?”
“Are there pending label suggestions on this PR?”
Tell an agent
List the suggested labels on PR #{pullreq_number} in {repo_identifier}.
Show pending label suggestions for pull request {pullreq_number} in repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/labels/{label_id} Dismiss a suggested label on a pull request · Remove suggested label #
Ask an LLM
“Can I dismiss a label suggestion I don't agree with on a PR?”
“What if a suggested label on my pull request is wrong?”
Tell an agent destructive · confirm first
Dismiss suggested label {label_id} on PR #{pullreq_number} in {repo_identifier}.
Remove the label suggestion {label_id} from pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/labels/{label_id}/apply Apply a suggested label to a pull request · Apply suggested label #
Ask an LLM
“How do I accept a label that was suggested for my pull request?”
“Can I turn a label suggestion into a real label on the PR?”
Tell an agent
Apply suggested label {label_id} to PR #{pullreq_number} in {repo_identifier}.
Accept the label suggestion {label_id} on pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/labels/batch Suggest labels for a pull request · Create label suggestions #
Ask an LLM
“Can I propose several labels for a PR without applying them directly?”
“How do I suggest labels on someone else's pull request?”
Tell an agent
Suggest labels {labels} for PR #{pullreq_number} in {repo_identifier}.
Create a batch of label suggestions {labels} on pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/reviewers List reviewers suggested for a pull request · List suggested reviewers #
Ask an LLM
“Who has been suggested as a reviewer for my PR but not added yet?”
“Are there pending reviewer suggestions on this pull request?”
Tell an agent
List the suggested reviewers on PR #{pullreq_number} in {repo_identifier}.
Show pending reviewer suggestions for pull request {pullreq_number} in repo {repo_identifier}.
DELETE /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/reviewers/{principal_id} Dismiss a suggested reviewer on a pull request · Remove suggested reviewer #
Ask an LLM
“Can I dismiss a reviewer suggestion on my pull request?”
“What if the suggested reviewer for a PR is on vacation?”
Tell an agent destructive · confirm first
Dismiss suggested reviewer {principal_id} on PR #{pullreq_number} in {repo_identifier}.
Remove the reviewer suggestion for {principal_id} from pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/reviewers/{principal_id}/apply Accept a suggested reviewer on a pull request · Apply suggested reviewer #
Ask an LLM
“How do I turn a suggested reviewer into an actual reviewer on my PR?”
“Can I accept one of the reviewer suggestions on a pull request?”
Tell an agent
Apply suggested reviewer {principal_id} to PR #{pullreq_number} in {repo_identifier}.
Accept the reviewer suggestion {principal_id} on pull request {pullreq_number} in repo {repo_identifier}.
POST /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/suggestions/reviewers/batch Suggest reviewers for a pull request · Create reviewer suggestions #
Ask an LLM
“Can I propose reviewers for a PR without assigning them directly?”
“How do I suggest several people to review a pull request at once?”
Tell an agent
Suggest reviewers {reviewer_ids} for PR #{pullreq_number} in {repo_identifier}.
Create a batch of reviewer suggestions {reviewer_ids} on pull request {pullreq_number} in repo {repo_identifier}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/view Get my saved view of a pull request · Get pull request view #
Ask an LLM
“Can I retrieve the saved review view, with its file groups, for a pull request?”
“What merge base and source SHA did I save in my PR view?”
Tell an agent
Get my saved view for PR #{pullreq_number} in {repo_identifier}.
Show the file groups in my view of pull request {pullreq_number} in repo {repo_identifier}.
PUT /code/api/v1/repos/{repo_identifier}/pullreq/{pullreq_number}/view Save a custom view of a pull request · Create or update pull request view #
Ask an LLM
“Can I group a pull request's files my own way for review and save that?”
“Is it possible to pin a PR view to a specific merge base and source commit?”
Tell an agent
Save a view of PR #{pullreq_number} in {repo_identifier} with file groups {groups}.
Update my view of pull request {pullreq_number} in repo {repo_identifier} to source SHA {source_sha}.
GET /code/api/v1/repos/{repo_identifier}/pullreq/candidates List branches that are candidates for a new PR · Pr candidates #
Ask an LLM
“Which recently pushed branches in my repo don't have a pull request yet?”
“Can Harness Code suggest branches I might want to open a PR from?”
Tell an agent
List branch candidates for new pull requests in repo {repo_identifier}.
Show up to {limit} branches in {repo_identifier} that are ready for a pull request.

Documentation

📖
Documentation
https://apidocs.harness.io
📖
APIReference
https://apidocs.harness.io
📖
GettingStarted
https://developer.harness.io/docs/platform/automation/api/api-quickstart/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/authentication/harness-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/rate-limits/harness-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-pullreq-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/scopes/harness-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/errors/harness-error-codes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/conventions/harness-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/harness:harness-pullreq-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

harness-pullreq-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Harness Pullreq API
  version: '1.0'
  description: The Harness Software Delivery Platform uses OpenAPI Specification v3.0.
  contact:
    name: API Support
    email: contact@harness.io
    url: https://harness.io/
  x-logo:
    url: https://mma.prnewswire.com/media/779232/Harnes_logo_horizontal.jpg?p=facebook
    altText: Harness
  termsOfService: https://harness.io/terms-of-use/
servers:
- url: https://app.harness.io
  description: Harness host URL
- url: https://{vanity}
  description: Vanity URL
  variables:
    vanity:
      default: app.harness.io
security:
- x-api-key: []
tags:


# --- truncated at 32 KB (158 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/openapi/harness-pullreq-api-openapi.yml