{ "swagger": "2.0", "host": "example.com", "info": { "title": "Bitbucket Server API", "description": "Bitbucket Server API (former stash).", "version": "1.0.0" }, "basePath": "/rest/", "schemes": [ "http", "https" ], "paths": { "/api/1.0/admin/cluster": { "parameters": [], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Gets information about the nodes that currently make up the stash cluster.\n

\n The authenticated user must have the SYS_ADMIN permission to call this resource.", "operationId": "getInformation" } }, "/api/1.0/admin/groups": { "parameters": [], "delete": { "parameters": [ { "description": "the name identifying the group to delete", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Deletes the specified group, removing them from the system. This also removes any permissions that may have been\n granted to the group.\n

\n A user may not delete the last group that is granting them administrative permissions, or a group with greater\n permissions than themselves.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "deleteGroup" }, "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups.\n

\n The authenticated user must have LICENSED_USER permission or higher to call this resource.", "operationId": "getGroupsAdmin" }, "post": { "parameters": [ { "description": "Name of the group.", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Create a new group.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "createGroup" } }, "/api/1.0/admin/groups/add-user": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Deprecated since 2.10. Use /rest/users/add-groups instead.\n

\n Add a user to a group.\n

\n In the request entity, the context attribute is the group and the itemName is the user.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "addUserToGroup" } }, "/api/1.0/admin/groups/add-users": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Add multiple users to a group.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "addUsersToGroup" } }, "/api/1.0/admin/groups/more-members": { "parameters": [], "get": { "parameters": [ { "description": "the group which should be used to locate members", "in": "query", "name": "context", "required": false, "type": "string" }, { "default": "", "description": "if specified only users with usernames, display names or email addresses containing the\n supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a list of users that are members of a specified group.\n

\n The authenticated user must have the LICENSED_USER permission to call this resource.", "operationId": "findUsersInGroup" } }, "/api/1.0/admin/groups/more-non-members": { "parameters": [], "get": { "parameters": [ { "description": "the group which should be used to locate non-members", "in": "query", "name": "context", "required": false, "type": "string" }, { "default": "", "description": "if specified only users with usernames, display names or email addresses containing the\n supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a list of users that are not members of a specified group.\n

\n The authenticated user must have the LICENSED_USER permission to call this resource.", "operationId": "findUsersNotInGroup" } }, "/api/1.0/admin/groups/remove-user": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Deprecated since 2.10. Use /rest/users/remove-groups instead.\n

\n Remove a user from a group.\n

\n The authenticated user must have the ADMIN permission to call this resource.\n

\n In the request entity, the context attribute is the group and the itemName is the user.", "operationId": "removeUserFromGroup" } }, "/api/1.0/admin/license": { "parameters": [], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves details about the current license, as well as the current status of the system with regards to the\n installed license. The status includes the current number of users applied toward the license limit, as well\n as any status messages about the license (warnings about expiry or user counts exceeding license limits).\n

\n The authenticated user must have ADMIN permission. Unauthenticated users, and non-administrators, are\n not permitted to access license details.", "operationId": "getLicense" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Decodes the provided encoded license and sets it as the active license. If no license was provided, a 400 is\n returned. If the license cannot be decoded, or cannot be applied, a 409 is returned. Some possible reasons a\n license may not be applied include:\n

\n Otherwise, if the license is updated successfully, details for the new license are returned with a 200 response.\n

\n Warning: It is possible to downgrade the license during update, applying a license with a lower number\n of permitted users. If the number of currently-licensed users exceeds the limits of the new license, pushing\n will be disabled until the licensed user count is brought into compliance with the new license.\n

\n The authenticated user must have SYS_ADMIN permission. ADMIN users may view the current\n license details, but they may not update the license.", "operationId": "updateLicense" } }, "/api/1.0/admin/mail-server": { "parameters": [], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Deletes the current mail configuration.\n

\n The authenticated user must have the SYS_ADMIN permission to call this resource.", "operationId": "deleteMailConfig" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves the current mail configuration.\n\n The authenticated user must have the SYS_ADMIN permission to call this resource.", "operationId": "getMailConfig" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Updates the mail configuration\n\n The authenticated user must have the SYS_ADMIN permission to call this resource.", "operationId": "setMailConfig" } }, "/api/1.0/admin/mail-server/sender-address": { "parameters": [], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Clears the server email address.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "clearSenderAddress" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves the server email address", "operationId": "getSenderAddress" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Updates the server email address\n\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "setSenderAddress" } }, "/api/1.0/admin/permissions/groups": { "parameters": [], "delete": { "parameters": [ { "description": "the name of the group", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Revoke all global permissions for a group.\n\n

\n The authenticated user must have:\n

\n to call this resource. In addition, a user may not revoke a group's permissions if their own permission level\n would be reduced as a result.", "operationId": "revokePermissionsForGroupAll" }, "get": { "parameters": [ { "default": "", "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups that have been granted at least one global permission.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "getGroupsWithAnyPermission" }, "put": { "parameters": [ { "description": "the permission to grant", "in": "query", "name": "permission", "required": false, "type": "string" }, { "description": "the names of the groups", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Promote or demote a user's global permission level. Available global permissions are:\n

\n See the Bitbucket Server\n documentation for a detailed explanation of what each permission entails.\n

\n The authenticated user must have:\n

\n to call this resource. In addition, a user may not demote a group's permission level if their own permission\n level would be reduced as a result.", "operationId": "setPermissionForGroups" } }, "/api/1.0/admin/permissions/groups/none": { "parameters": [], "get": { "parameters": [ { "default": "", "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups that have no granted global permissions.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "getGroupsWithoutAnyPermission" } }, "/api/1.0/admin/permissions/users": { "parameters": [], "delete": { "parameters": [ { "description": "the name of the user", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Revoke all global permissions for a user.\n

\n The authenticated user must have:\n

\n to call this resource. In addition, a user may not demote their own permission level.", "operationId": "revokePermissionsForUserAll" }, "get": { "parameters": [ { "default": "", "description": "if specified only user names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of users that have been granted at least one global permission.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "getUsersWithAnyPermissionAll" }, "put": { "parameters": [ { "description": "the names of the users", "in": "query", "name": "name", "required": false, "type": "string" }, { "description": "the permission to grant", "in": "query", "name": "permission", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Promote or demote the global permission level of a user. Available global permissions are:\n

\n See the Bitbucket Server\n documentation for a detailed explanation of what each permission entails.\n

\n The authenticated user must have:\n

\n to call this resource. In addition, a user may not demote their own permission level.", "operationId": "setPermissionForUsers" } }, "/api/1.0/admin/permissions/users/none": { "parameters": [], "get": { "parameters": [ { "default": "", "description": "if specified only user names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of users that have no granted global permissions.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "getUsersWithoutAnyPermission" } }, "/api/1.0/admin/pull-requests/{scmId}": { "parameters": [ { "description": "the id of the scm to get strategies for", "in": "path", "name": "scmId", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the merge strategies available for this instance.\n

\n The user must be authenticated to call this resource.", "operationId": "getMergeConfig" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the pull request merge strategies for the context repository.\n

\n The authenticated user must have ADMIN permission for the context repository to call this\n resource.\n

\n Only the strategies provided will be enabled, only one may be set to default\n

\n An explicitly set pull request merge strategy configuration can be deleted by POSTing a document with\n an empty \"mergeConfig\" attribute. i.e:\n 

\n {\n     \"mergeConfig\": {\n     }\n }\n
\n Upon completion of this request, the effective configuration will be the default configuration.", "operationId": "setMergeConfig" } }, "/api/1.0/admin/users": { "parameters": [], "delete": { "parameters": [ { "description": "the username identifying the user to delete", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Deletes the specified user, removing them from the system. This also removes any permissions that may have been\n granted to the user.\n

\n A user may not delete themselves, and a user with ADMIN permissions may not delete a user with\n SYS_ADMINpermissions.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "deleteUser" }, "get": { "parameters": [ { "description": "if specified only users with usernames, display name or email addresses containing the supplied\n string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of users.\n

\n The authenticated user must have the LICENSED_USER permission to call this resource.", "operationId": "getUsers" }, "post": { "parameters": [ { "description": "the username for the new user", "in": "query", "name": "name", "required": false, "type": "string" }, { "description": "the password for the new user", "in": "query", "name": "password", "required": false, "type": "string" }, { "description": "the display name for the new user", "in": "query", "name": "displayName", "required": false, "type": "string" }, { "description": "the e-mail address for the new user", "in": "query", "name": "emailAddress", "required": false, "type": "string" }, { "default": true, "description": "true to add the user to the default group, which can be used to grant them\n a set of initial permissions; otherwise, false to not add them to a group", "in": "query", "name": "addToDefaultGroup", "required": false, "type": "boolean" }, { "description": "if present and not false instead of requiring a password,\n the create user will be notified via email their account has been created and requires\n a password to be reset. This option can only be used if a mail server has been configured", "in": "query", "name": "notify", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Creates a new user from the assembled query parameters.\n

\n The default group can be used to control initial permissions for new users, such as granting users the ability\n to login or providing read access to certain projects or repositories. If the user is not added to the default\n group, they may not be able to login after their account is created until explicit permissions are configured.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "createUser" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update a user's details.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "updateUserDetails" } }, "/api/1.0/admin/users/add-group": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Deprecated since 2.10. Use /rest/users/add-groups instead.\n

\n Add a user to a group. This is very similar to groups/add-user, but with the context and\n itemName attributes of the supplied request entity reversed. On the face of it this may appear\n redundant, but it facilitates a specific UI component in Stash.\n

\n In the request entity, the context attribute is the user and the itemName is the group.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "addGroupToUser" } }, "/api/1.0/admin/users/add-groups": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Add a user to one or more groups.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "addUserToGroups" } }, "/api/1.0/admin/users/captcha": { "parameters": [], "delete": { "parameters": [ { "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Clears any CAPTCHA challenge that may constrain the user with the supplied username when they authenticate.\n Additionally any counter or metric that contributed towards the user being issued the CAPTCHA challenge\n (for instance too many consecutive failed logins) will also be reset.\n

\n The authenticated user must have the ADMIN permission to call this resource, and may not clear\n the CAPTCHA of a user with greater permissions than themselves.", "operationId": "clearUserCaptchaChallenge" } }, "/api/1.0/admin/users/credentials": { "parameters": [], "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update a user's password.\n

\n The authenticated user must have the ADMIN permission to call this resource, and may not update\n the password of a user with greater permissions than themselves.", "operationId": "updateUserPassword" } }, "/api/1.0/admin/users/more-members": { "parameters": [], "get": { "parameters": [ { "description": "the user which should be used to locate groups", "in": "query", "name": "context", "required": false, "type": "string" }, { "default": "", "description": "if specified only groups with names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a list of groups the specified user is a member of.\n

\n The authenticated user must have the LICENSED_USER permission to call this resource.", "operationId": "findGroupsForUser" } }, "/api/1.0/admin/users/more-non-members": { "parameters": [], "get": { "parameters": [ { "description": "the user which should be used to locate groups", "in": "query", "name": "context", "required": false, "type": "string" }, { "default": "", "description": "if specified only groups with names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a list of groups the specified user is not a member of.\n

\n The authenticated user must have the LICENSED_USER permission to call this resource.", "operationId": "findOtherGroupsForUser" } }, "/api/1.0/admin/users/remove-group": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Remove a user from a group. This is very similar to groups/remove-user, but with the context\n and itemName attributes of the supplied request entity reversed. On the face of it this may appear\n redundant, but it facilitates a specific UI component in Stash.\n

\n In the request entity, the context attribute is the user and the itemName is the group.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "removeGroupFromUser" } }, "/api/1.0/admin/users/rename": { "parameters": [], "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Rename a user.\n

\n The authenticated user must have the ADMIN permission to call this resource.", "operationId": "renameUser" } }, "/api/1.0/application-properties": { "parameters": [], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve version information and other application properties.\n

\n No authentication is required to call this resource.", "operationId": "getApplicationProperties" } }, "/api/1.0/dashboard/pull-request-suggestions": { "parameters": [], "get": { "parameters": [ { "default": "172800", "description": "restrict pull request suggestions to be based on events that occurred since some time\n in the past. This is expressed in seconds since \"now\". So to return suggestions\n based only on activity within the past 48 hours, pass a value of 172800.", "in": "query", "name": "changesSince", "required": false, "type": "string" }, { "default": 3, "description": "restricts the result set to return at most this many suggestions.", "format": "int32", "in": "query", "name": "limit", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a page of suggestions for pull requests that the currently authenticated user may wish to\n raise. Such suggestions are based on ref changes occurring and so contain the ref change that\n prompted the suggestion plus the time the change event occurred. Changes will be returned in\n descending order based on the time the change that prompted the suggestion occurred.\n

\n Note that although the response is a page object, the interface does not support paging, however\n a limit can be applied to the size of the returned page.", "operationId": "getPullRequestSuggestions" } }, "/api/1.0/dashboard/pull-requests": { "parameters": [], "get": { "parameters": [ { "description": "(optional, defaults to returning pull requests in any state). If a state is supplied only pull\n requests in the specified state will be returned. Either OPEN,\n DECLINED or MERGED.\n Omit this parameter to return pull request in any state.", "in": "query", "name": "state", "required": false, "type": "string" }, { "description": "(optional, defaults to returning pull requests for any role). If a role is supplied only pull\n requests where the authenticated user is a participant in the given role will be returned.\n Either REVIEWER, AUTHOR or PARTICIPANT.", "in": "query", "name": "role", "required": false, "type": "string" }, { "description": "(optional, defaults to returning pull requests with any participant status). A comma\n separated list of participant status. That is, one or more of\n UNAPPROVED, NEEDS_WORK, or APPROVED.", "in": "query", "name": "participantStatus", "required": false, "type": "string" }, { "description": "(optional, defaults to NEWEST) the order to return pull requests in, either\n OLDEST (as in: \"oldest first\"), NEWEST,\n PARTICIPANT_STATUS, or CLOSED_DATE. Where\n CLOSED_DATE is specified and the result set includes pull requests that are not in\n the closed state, these pull requests will appear first in the result set, followed by most recently\n closed pull requests.", "in": "query", "name": "order", "required": false, "type": "string" }, { "description": "(optional, defaults to returning pull requests regardless of closed since date). Permits\n returning only pull requests with a closed timestamp set more recently that\n (now - closedSince). Units are in seconds. So for example if closed since 86400 is set only\n pull requests closed in the previous 24 hours will be returned.", "in": "query", "name": "closedSince", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of pull requests where the current authenticated user is involved as either a reviewer, author\n or a participant. The request may be filtered by pull request state, role or participant status.", "operationId": "getPullRequests" } }, "/api/1.0/groups": { "parameters": [], "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of group names.\n

\n The authenticated user must have PROJECT_ADMIN permission or higher to call this resource.", "operationId": "getGroups" } }, "/api/1.0/hooks/{hookKey}/avatar": { "parameters": [ { "description": "the complete module key of the hook module", "in": "path", "name": "hookKey", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "optional version used for HTTP caching only - any non-blank version will result in a large max-age Cache-Control header.\n Note that this does not affect the Last-Modified header.", "in": "query", "name": "version", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the avatar for the project matching the supplied moduleKey.", "operationId": "getAvatar" } }, "/api/1.0/inbox/pull-requests": { "parameters": [], "get": { "parameters": [ { "default": 0, "format": "int32", "in": "query", "name": "start", "required": false, "type": "integer" }, { "default": 25, "format": "int32", "in": "query", "name": "limit", "required": false, "type": "integer" }, { "default": "reviewer", "in": "query", "name": "role", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "operationId": "getPullRequestsInbox" } }, "/api/1.0/inbox/pull-requests/count": { "parameters": [], "get": { "responses": { "200": { "description": "Successful Response" } }, "operationId": "getPullRequestCount" } }, "/api/1.0/logs/logger/{loggerName}": { "parameters": [ { "description": "the name of the logger.", "in": "path", "name": "loggerName", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the current log level for a given logger.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "getLevel" } }, "/api/1.0/logs/logger/{loggerName}/{levelName}": { "parameters": [ { "description": "the level to set the logger to. Either TRACE, DEBUG, INFO, WARN or ERROR", "in": "path", "name": "levelName", "required": true, "type": "string" }, { "description": "the name of the logger.", "in": "path", "name": "loggerName", "required": true, "type": "string" } ], "put": { "responses": { "200": { "description": "Successful Response" } }, "description": "Set the current log level for a given logger.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "setLevel" } }, "/api/1.0/logs/rootLogger": { "parameters": [], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the current log level for the root logger.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "getRootLevel" } }, "/api/1.0/logs/rootLogger/{levelName}": { "parameters": [ { "description": "the level to set the logger to. Either TRACE, DEBUG, INFO, WARN or ERROR", "in": "path", "name": "levelName", "required": true, "type": "string" } ], "put": { "responses": { "200": { "description": "Successful Response" } }, "description": "Set the current log level for the root logger.\n

\n The authenticated user must have ADMIN permission or higher to call this resource.", "operationId": "setRootLevel" } }, "/api/1.0/markup/preview": { "parameters": [], "post": { "parameters": [ { "description": "(Optional) The UrlMode used when building the url. One of: ABSOLUTE, RELATIVE and CONFIGURED\n By default this is RELATIVE.", "in": "query", "name": "urlMode", "required": false, "type": "string" }, { "description": "(Optional) Whether the markup implementation should convert newlines to breaks.\n By default this is false which reflects the standard markdown specification.", "in": "query", "name": "hardwrap", "required": false, "type": "boolean" }, { "description": "(Optional) true if HTML should be escaped in the input markup, false otherwise.", "in": "query", "name": "htmlEscape", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Preview the generated html for given markdown contents.\n

\n Only authenticated users may call this resource.", "operationId": "preview" } }, "/api/1.0/profile/recent/repos": { "parameters": [], "get": { "parameters": [ { "description": "(optional) if specified, it must be a valid repository permission level name and will limit\n the resulting repository list to ones that the requesting user has the specified permission\n level to. If not specified, the default REPO_READ permission level will be assumed.", "in": "query", "name": "permission", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of recently accessed repositories for the currently authenticated user.\n

\n Repositories are ordered from most recently to least recently accessed.\n

\n Only authenticated users may call this resource.", "operationId": "getRepositoriesRecentlyAccessed" } }, "/api/1.0/projects": { "parameters": [], "get": { "parameters": [ { "in": "query", "name": "name", "required": false, "type": "string" }, { "in": "query", "name": "permission", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of projects.\n

\n Only projects for which the authenticated user has the PROJECT_VIEW permission will be returned.", "operationId": "getProjects" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Create a new project.\n

\n To include a custom avatar for the project, the project definition should contain an additional attribute with\n the key avatar and the value a data URI containing Base64-encoded image data. The URI should be in\n the following format:\n 

\n     data:(content type, e.g. image/png);base64,(data)\n
\n If the data is not Base64-encoded, or if a character set is defined in the URI, or the URI is otherwise invalid,\n project creation will fail.\n

\n The authenticated user must have PROJECT_CREATE permission to call this resource.", "operationId": "createProject" } }, "/api/1.0/projects/{projectKey}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Delete the project matching the supplied projectKey.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project to call this\n resource.", "operationId": "deleteProject" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the project matching the supplied projectKey.\n

\n The authenticated user must have PROJECT_VIEW permission for the specified project to call this\n resource.", "operationId": "getProject" }, "put": { "responses": { "200": { "description": "Successful Response" } }, "description": "Update the project matching the projectKey supplied in the resource path.\n

\n To include a custom avatar for the updated project, the project definition should contain an additional attribute\n with the key avatar and the value a data URI containing Base64-encoded image data. The URI should be\n in the following format:\n \n data:(content type, e.g. image/png);base64,(data)\n \n If the data is not Base64-encoded, or if a character set is defined in the URI, or the URI is otherwise invalid,\n project creation will fail.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project to call this\n resource.", "operationId": "updateProject" } }, "/api/1.0/projects/{projectKey}/avatar.png": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": 0, "description": "The desired size of the image. The server will return an image as close as possible to the specified\n size.", "format": "int32", "in": "query", "name": "s", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the avatar for the project matching the supplied projectKey.\n

\n The authenticated user must have PROJECT_VIEW permission for the specified project to call this\n resource.", "operationId": "getProjectAvatar" }, "post": { "responses": { "200": { "description": "Successful Response" } }, "description": "Update the avatar for the project matching the supplied projectKey.\n

\n This resource accepts POST multipart form data, containing a single image in a form-field named 'avatar'.\n

\n There are configurable server limits on both the dimensions (1024x1024 pixels by default) and uploaded file size\n (1MB by default). Several different image formats are supported, but PNG and\n JPEG are preferred due to the file size limit.\n

\n This resource has Cross-Site Request Forgery (XSRF) protection. To allow the request to\n pass the XSRF check the caller needs to send an X-Atlassian-Token HTTP header with the\n value no-check.\n

\n An example curl request to upload an image name 'avatar.png' would be:\n 

\n curl -X POST -u username:password -H \"X-Atlassian-Token: no-check\" http://example.com/rest/api/1.0/projects/STASH/avatar.png -F avatar=@avatar.png\n
\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project to call this\n resource.", "operationId": "uploadAvatarProject" } }, "/api/1.0/projects/{projectKey}/permissions/groups": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "delete": { "parameters": [ { "description": "the name of the group", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Revoke all permissions for the specified project for a group.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.\n

\n In addition, a user may not revoke a group's permissions if it will reduce their own permission level.", "operationId": "revokePermissionsForGroupProject" }, "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups that have been granted at least one permission for the specified project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.", "operationId": "getGroupsWithAnyPermissionProject" }, "put": { "parameters": [ { "description": "The permission to grant.\n See the [permissions documentation](https://confluence.atlassian.com/display/BitbucketServer/Using+project+permissions)\n for a detailed explanation of what each permission entails.\n Available project permissions are:\n

", "in": "query", "name": "permission", "required": false, "type": "string" }, { "description": "the names of the groups", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Promote or demote a group's permission level for the specified project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource. In addition, a user may not demote a group's permission level if their\n own permission level would be reduced as a result.", "operationId": "setPermissionForGroupsProject" } }, "/api/1.0/projects/{projectKey}/permissions/groups/none": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups that have no granted permissions for the specified project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.", "operationId": "getGroupsWithoutAnyPermissionProject" } }, "/api/1.0/projects/{projectKey}/permissions/users": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "delete": { "parameters": [ { "description": "the name of the user", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Revoke all permissions for the specified project for a user.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.\n

\n In addition, a user may not revoke their own project permissions if they do not have a higher global permission.", "operationId": "revokePermissionsForUserProject" }, "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of users that have been granted at least one permission for the specified project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.", "operationId": "getUsersWithAnyPermissionProject" }, "put": { "parameters": [ { "description": "the names of the users", "in": "query", "name": "name", "required": false, "type": "string" }, { "description": "the permission to grant. See the [permissions documentation](https://confluence.atlassian.com/display/BitbucketServer/Using+project+permissions)\n for a detailed explanation of what each permission entails.\n Available project permissions are:\n

", "in": "query", "name": "permission", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Promote or demote a user's permission level for the specified project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource. In addition, a user may not reduce their own permission level unless\n they have a global permission that already implies that permission.", "operationId": "setPermissionForUsersProject" } }, "/api/1.0/projects/{projectKey}/permissions/users/none": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of licensed users that have no granted permissions for the specified project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.", "operationId": "getUsersWithoutPermissionProject" } }, "/api/1.0/projects/{projectKey}/permissions/{permission}/all": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the permission to grant\n Available project permissions are:\n

", "in": "path", "name": "permission", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Check whether the specified permission is the default permission (granted to all users) for a project.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.", "operationId": "hasAllUserPermission" }, "post": { "parameters": [ { "description": "true to grant the specified permission to all users, or false to revoke it", "in": "query", "name": "allow", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Grant or revoke a project permission to all users, i.e. set the default permission.\n

\n The authenticated user must have PROJECT_ADMIN permission for the specified project or a higher\n global permission to call this resource.", "operationId": "modifyAllUserPermission" } }, "/api/1.0/projects/{projectKey}/repos": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve repositories from the project corresponding to the supplied projectKey.\n

\n The authenticated user must have REPO_READ permission for the specified project to call this\n resource.", "operationId": "getRepositories" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Create a new repository. Requires an existing project in which this repository will be created.\n The only parameters which will be used are name and scmId.\n

\n The authenticated user must have PROJECT_ADMIN permission for the context project to call this\n resource.", "operationId": "createRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Schedule the repository matching the supplied projectKey and repositorySlug to\n be deleted. If the request repository is not present\n

\n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.", "operationId": "deleteRepository" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the repository matching the supplied projectKey and repositorySlug.\n

\n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getRepository" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Create a new repository forked from an existing repository.\n

\n The JSON body for this {@code POST} is not required to contain any properties. Even the name may be\n omitted. The following properties will be used, if provided:\n

\n

\n The authenticated user must have REPO_READ permission for the specified repository and\n PROJECT_ADMIN on the target project to call this resource. Note that users always\n have PROJECT_ADMIN permission on their personal projects.", "operationId": "forkRepository" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the repository matching the repositorySlug supplied in the resource path.\n

\n The repository's slug is derived from its name. If the name changes the slug may also change.\n

\n This API can be used to move the repository to a different project by setting the new project in the request,\n example: {@code {\"project\":{\"key\":\"NEW_KEY\"}}} .\n

\n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.", "operationId": "updateRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/archive": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit to stream an archive of; if not supplied, an archive of the default branch is streamed", "in": "query", "name": "at", "required": false, "type": "string" }, { "description": "a filename to include the \"Content-Disposition\" header", "in": "query", "name": "filename", "required": false, "type": "string" }, { "description": "the format to stream the archive in; must be one of: zip, tar, tar.gz or tgz", "in": "query", "name": "format", "required": false, "type": "string" }, { "description": "paths to include in the streamed archive; may be repeated to include multiple paths", "in": "query", "name": "path", "required": false, "type": "string" }, { "description": "a prefix to apply to all entries in the streamed archive; if the supplied prefix does not end\n with a trailing /, one will be added automatically", "in": "query", "name": "prefix", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Streams an archive of the repository's contents at the requested commit. If no at= commit is\n requested, an archive of the default branch is streamed.\n

\n The filename= query parameter may be used to specify the exact filename to include in the\n \"Content-Disposition\" header. If an explicit filename is not provided, one will be automatically\n generated based on what is being archived. Its format depends on the at= value:\n

\n

\n Archives may be requested in the following formats by adding the format= query parameter:\n

\n The contents of the archive may be filtered by using the path= query parameter to specify paths to\n include. path= may be specified multiple times to include multiple paths.\n

\n The prefix= query parameter may be used to define a directory (or multiple directories) where\n the archive's contents should be placed. If the prefix does not end with /, one will be added\n automatically. The prefix is always treated as a directory; it is not possible to use it to prepend\n characters to the entries in the archive.\n

\n Archives of public repositories may be streamed by any authenticated or anonymous user. Streaming archives for\n non-public repositories requires an authenticated user with at least REPO_READ permission.", "operationId": "getArchive" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/branches": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "base branch or tag to compare each branch to (for the metadata providers that uses that information)", "in": "query", "name": "base", "required": false, "type": "string" }, { "description": "whether to retrieve plugin-provided metadata about each branch", "in": "query", "name": "details", "required": false, "type": "boolean" }, { "description": "the text to match on", "in": "query", "name": "filterText", "required": false, "type": "string" }, { "description": "ordering of refs either ALPHABETICAL (by name) or MODIFICATION (last updated)", "in": "query", "name": "orderBy", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the branches matching the supplied filterText param.\n

\n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getBranches" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Creates a branch using the information provided in the {@link RestCreateBranchRequest request}\n

\n The authenticated user must have REPO_WRITE permission for the context repository to call\n this resource.", "operationId": "createBranch" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/branches/default": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Get the default branch of the repository.\n

\n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getDefaultBranch" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the default branch of a repository.\n

\n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.", "operationId": "setDefaultBranch" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/browse": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": "", "description": "the commit ID or ref to retrieve the content for.", "in": "query", "name": "at", "required": false, "type": "string" }, { "default": false, "description": "if true only the type will be returned for the file path instead of the contents.", "in": "query", "name": "type", "required": false, "type": "boolean" }, { "description": "if present the blame will be returned for the file as well.", "in": "query", "name": "blame", "required": false, "type": "string" }, { "description": "if present and used with blame only the blame is retrieved instead of the contents.", "in": "query", "name": "noContent", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of content for a file path at a specified revision.\n

\n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getContentBrowse" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/browse/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "default": "", "description": "the file path to retrieve content from", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": "", "description": "the commit ID or ref to retrieve the content for.", "in": "query", "name": "at", "required": false, "type": "string" }, { "default": false, "description": "if true only the type will be returned for the file path instead of the contents.", "in": "query", "name": "type", "required": false, "type": "boolean" }, { "description": "if present the blame will be returned for the file as well.", "in": "query", "name": "blame", "required": false, "type": "string" }, { "description": "if present and used with blame only the blame is retrieved instead of the contents.", "in": "query", "name": "noContent", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of content for a file path at a specified revision.\n

\n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getContentFile" }, "put": { "responses": { "200": { "description": "Successful Response" } }, "description": "Update the content of path, on the given repository and branch.\n

\n This resource accepts PUT multipart form data, containing the file in a form-field named content.\n

\n An example curl request to update 'README.md' would be:\n 

\n curl -X PUT -u username:password -F content=@README.md  -F 'message=Updated using file-edit REST API'\n -F branch=master -F  sourceCommitId=5636641a50b\n  http://example.com/rest/api/latest/projects/PROJECT_1/repos/repo_1/browse/README.md\n
\n

\n \n

  • branch: the branch on which the path should be modified or created
    • \n
  • content: the full content of the file at path
    • \n
  • message: the message associated with this change, to be used as the commit message.\n Or null if the default message should be used.
    • \n
  • sourceCommitId: the commit ID of the file before it was edited, used to identify if\n content has changed. Or null if this is a new file
    • \n \n

    \n The file can be updated or created on a new branch. In this case, the sourceBranch parameter should\n be provided to identify the starting point for the new branch and the branch parameter identifies\n the branch to create the new commit on.", "operationId": "editFile" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/changes": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit to which until should be compared to produce a page of changes.\n If not specified the commit's first parent is assumed (if one exists)", "in": "query", "name": "since", "required": false, "type": "string" }, { "description": "the commit to retrieve changes for", "in": "query", "name": "until", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of changes made in a specified commit.\n

    \n Note: The implementation will apply a hard cap ({@code page.max.changes}) and it is not\n possible to request subsequent content when that cap is exceeded.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getChanges" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": false, "description": "if true, the commit history of the specified file will be followed past renames.\n Only valid for a path to a single file.", "in": "query", "name": "followRenames", "required": false, "type": "boolean" }, { "default": false, "description": "true to ignore missing commits, false otherwise", "in": "query", "name": "ignoreMissing", "required": false, "type": "boolean" }, { "description": "if present, controls how merge commits should be filtered. Can be either exclude,\n to exclude merge commits, include, to include both merge commits and non-merge\n commits or only, to only return merge commits.", "in": "query", "name": "merges", "required": false, "type": "string" }, { "description": "an optional path to filter commits by", "in": "query", "name": "path", "required": false, "type": "string" }, { "description": "the commit ID or ref (exclusively) to retrieve commits after", "in": "query", "name": "since", "required": false, "type": "string" }, { "description": "the commit ID (SHA1) or ref (inclusively) to retrieve commits before", "in": "query", "name": "until", "required": false, "type": "string" }, { "default": false, "description": "optionally include the total number of commits and total number of unique authors", "in": "query", "name": "withCounts", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of commits from a given starting commit or \"between\" two commits. If no explicit commit is\n specified, the tip of the repository's default branch is assumed. commits may be identified by branch or tag\n name or by ID. A path may be supplied to restrict the returned commits to only those which affect that path.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getCommits" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the commit ID to retrieve", "in": "path", "name": "commitId", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "an optional path to filter the commit by. If supplied the details returned may not\n be for the specified commit. Instead, starting from the specified commit, they will be the\n details for the first commit affecting the specified path.", "in": "query", "name": "path", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a single commit identified by its ID>. In general, that ID is a SHA1. From 2.11, ref names\n like \"refs/heads/master\" are no longer accepted by this resource.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getCommit" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}/changes": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the commit to retrieve changes for", "in": "path", "name": "commitId", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit to which until should be compared to produce a page of changes.\n If not specified the commit's first parent is assumed (if one exists)", "in": "query", "name": "since", "required": false, "type": "string" }, { "default": true, "description": "{@code true} to apply comment counts in the changes (the default); otherwise, {@code false}\n to stream changes without comment counts", "in": "query", "name": "withComments", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of changes made in a specified commit.\n

    \n Note: The implementation will apply a hard cap ({@code page.max.changes}) and it is not\n possible to request subsequent content when that cap is exceeded.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getChangesFile" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}/comments": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the commit to which the comments must be anchored", "in": "path", "name": "commitId", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the path to the file on which comments were made", "in": "query", "name": "path", "required": false, "type": "string" }, { "description": "For a merge commit, a parent can be provided to specify which diff the comments are on. For\n a commit range, a {@code sinceId} can be provided to specify where the comments are anchored\n from.", "in": "query", "name": "since", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves the commit discussion comments that match the specified search criteria.\n

    \n It is possible to retrieve commit discussion comments that are anchored to a range of commits by providing the\n {@code sinceId} that the comments anchored from.\n

    \n The authenticated user must have REPO_READ permission for the repository that the commit\n is in to call this resource.", "operationId": "getComments" }, "post": { "parameters": [ { "description": "For a merge commit, a parent can be provided to specify which diff the comments should be on. For\n a commit range, a {@code sinceId} can be provided to specify where the comments should be\n anchored from.", "in": "query", "name": "since", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Add a new comment.\n

    \n Comments can be added in a few places by setting different attributes:\n

    \n General commit comment:\n\n 

    \n     {\n         \"text\": \"An insightful general comment on a commit.\"\n     }\n
    \n\n Reply to a comment:\n\n 
    \n     {\n         \"text\": \"A measured reply.\",\n         \"parent\": {\n             \"id\": 1\n         }\n     }\n
    \n\n General file comment:\n\n 
    \n     {\n         \"text\": \"An insightful general comment on a file.\",\n         \"anchor\": {\n             \"diffType\": \"COMMIT\",\n             \"fromHash\": \"6df3858eeb9a53a911cd17e66a9174d44ffb02cd\",\n             \"path\": \"path/to/file\",\n             \"srcPath\": \"path/to/file\",\n             \"toHash\": \"04c7c5c931b9418ca7b66f51fe934d0bd9b2ba4b\"\n         }\n     }\n
    \n\n File line comment:\n\n 
    \n     {\n         \"text\": \"A pithy comment on a particular line within a file.\",\n         \"anchor\": {\n             \"diffType\": \"COMMIT\",\n             \"line\": 1,\n             \"lineType\": \"CONTEXT\",\n             \"fileType\": \"FROM\",\n             \"fromHash\": \"6df3858eeb9a53a911cd17e66a9174d44ffb02cd\",\n             \"path\": \"path/to/file\",\n             \"srcPath\": \"path/to/file\",\n             \"toHash\": \"04c7c5c931b9418ca7b66f51fe934d0bd9b2ba4b\"\n     }\n     }\n
    \n Note: general file comments are an experimental feature and may change in the near future!\n

    \n For file and line comments, 'path' refers to the path of the file to which the comment should be applied and\n 'srcPath' refers to the path the that file used to have (only required for copies and moves). Also,\n fromHash and toHash refer to the sinceId / untilId (respectively) used to produce the diff on which the comment\n was added. Finally diffType refers to the type of diff the comment was added on.\n

    \n For line comments, 'line' refers to the line in the diff that the comment should apply to. 'lineType' refers to\n the type of diff hunk, which can be:\n

    \n 'fileType' refers to the file of the diff to which the anchor should be attached - which is of relevance when\n displaying the diff in a side-by-side way. Currently the supported values are:\n \n If the current user is not a participant the user is added as one and updated to watch the commit.\n

    \n The authenticated user must have REPO_READ permission for the repository that the commit\n is in to call this resource.", "operationId": "createComment" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}/comments/{commentId}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the commit to which the comments must be anchored", "in": "path", "name": "commitId", "required": true, "type": "string" }, { "description": "the ID of the comment to retrieve", "format": "int64", "in": "path", "name": "commentId", "required": true, "type": "integer" } ], "delete": { "parameters": [ { "default": -1, "description": "The expected version of the comment. This must match the server's version of the comment or\n the delete will fail. To determine the current version of the comment, the comment should be\n fetched from the server prior to the delete. Look for the 'version' attribute in the returned\n JSON structure.", "format": "int32", "in": "query", "name": "version", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Delete a commit comment. Anyone can delete their own comment. Only users with REPO_ADMIN\n and above may delete comments created by other users. Comments which have replies may not be deleted,\n regardless of the user's granted permissions.\n

    \n The authenticated user must have REPO_READ permission for the repository that the commit\n is in to call this resource.", "operationId": "deleteComment" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a commit discussion comment.\n

    \n The authenticated user must have REPO_READ permission for the repository that the commit\n is in to call this resource.", "operationId": "getComment" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the text of a comment. Only the user who created a comment may update it.\n

    \n Note: the supplied supplied JSON object must contain a version that must match\n the server's version of the comment or the update will fail. To determine the current version of the comment,\n the comment should be fetched from the server prior to the update. Look for the 'version' attribute in the\n returned JSON structure.\n

    \n The authenticated user must have REPO_READ permission for the repository that the commit\n is in to call this resource.", "operationId": "updateComment" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}/diff": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "in": "path", "name": "commitId", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": false, "description": "{@code true} to automatically try to find the source path when it's not provided,\n {@code false} otherwise. Requires the {@code path} to be provided.", "in": "query", "name": "autoSrcPath", "required": false, "type": "boolean" }, { "default": -1, "description": "the number of context lines to include around added/removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "description": "the base revision to diff from. If omitted the parent revision of the until revision is used", "in": "query", "name": "since", "required": false, "type": "string" }, { "description": "the source path for the file, if it was copied, moved or renamed", "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "description": "optional whitespace flag which can be set to {@code ignore-all}", "in": "query", "name": "whitespace", "required": false, "type": "string" }, { "default": true, "description": "{@code true} to embed comments in the diff (the default); otherwise {@code false}\n to stream the diff without comments", "in": "query", "name": "withComments", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the diff between two provided revisions.\n

    \n Note: This resource is currently not paged. The server will internally apply a hard cap\n to the streamed lines, and it is not possible to request subsequent pages if that cap is exceeded. In the event\n that the cap is reached, the diff will be cut short and one or more {@code truncated} flags will be set to\n {@code true} on the {@code \"segments\"}, {@code \"hunks\"} and {@code \"diffs\"} properties, as well as the top-level\n object, in the returned JSON response.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "streamDiffCommit" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}/diff/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "in": "path", "name": "commitId", "required": true, "type": "string" }, { "description": "the path to the file which should be diffed (optional)", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": false, "description": "{@code true} to automatically try to find the source path when it's not provided,\n {@code false} otherwise. Requires the {@code path} to be provided.", "in": "query", "name": "autoSrcPath", "required": false, "type": "boolean" }, { "default": -1, "description": "the number of context lines to include around added/removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "description": "the base revision to diff from. If omitted the parent revision of the until revision is used", "in": "query", "name": "since", "required": false, "type": "string" }, { "description": "the source path for the file, if it was copied, moved or renamed", "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "description": "optional whitespace flag which can be set to {@code ignore-all}", "in": "query", "name": "whitespace", "required": false, "type": "string" }, { "default": true, "description": "{@code true} to embed comments in the diff (the default); otherwise {@code false}\n to stream the diff without comments", "in": "query", "name": "withComments", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the diff between two provided revisions.\n

    \n Note: This resource is currently not paged. The server will internally apply a hard cap\n to the streamed lines, and it is not possible to request subsequent pages if that cap is exceeded. In the event\n that the cap is reached, the diff will be cut short and one or more {@code truncated} flags will be set to\n {@code true} on the {@code \"segments\"}, {@code \"hunks\"} and {@code \"diffs\"} properties, as well as the top-level\n object, in the returned JSON response.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "streamDiffCommits" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/commits/{commitId}/watch": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the full {@link Commit#getId() ID} of the commit within the repository", "in": "path", "name": "commitId", "required": true, "type": "string" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Removes the authenticated user as a watcher for the specified commit.\n

    \n The authenticated user must have REPO_READ permission for the repository containing the commit\n to call this resource.", "operationId": "unwatch" }, "post": { "responses": { "200": { "description": "Successful Response" } }, "description": "Adds the authenticated user as a watcher for the specified commit.\n

    \n The authenticated user must have REPO_READ permission for the repository containing the commit\n to call this resource.", "operationId": "watchCommit" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/compare/changes": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the source commit (can be a partial/full commit ID or qualified/unqualified ref name)", "in": "query", "name": "from", "required": false, "type": "string" }, { "description": "the target commit (can be a partial/full commit ID or qualified/unqualified ref name)", "in": "query", "name": "to", "required": false, "type": "string" }, { "default": "", "description": "an optional parameter specifying the source repository containing the source commit\n if that commit is not present in the current repository; the repository can be specified\n by either its ID fromRepo=42 or by its project key plus its repo slug separated by\n a slash: fromRepo=projectKey/repoSlug", "in": "query", "name": "fromRepo", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Gets the file changes available in the {@code from} commit but not in the {@code to} commit.\n

    \n If either the {@code from} or {@code to} commit are not specified, they will be replaced by the\n default branch of their containing repository.", "operationId": "streamChangesCompare" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/compare/commits": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the source commit (can be a partial/full commit ID or qualified/unqualified ref name)", "in": "query", "name": "from", "required": false, "type": "string" }, { "description": "the target commit (can be a partial/full commit ID or qualified/unqualified ref name)", "in": "query", "name": "to", "required": false, "type": "string" }, { "default": "", "description": "an optional parameter specifying the source repository containing the source commit\n if that commit is not present in the current repository; the repository can be specified\n by either its ID fromRepo=42 or by its project key plus its repo slug separated by\n a slash: fromRepo=projectKey/repoSlug", "in": "query", "name": "fromRepo", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Gets the commits accessible from the {@code from} commit but not in the {@code to} commit.\n

    \n If either the {@code from} or {@code to} commit are not specified, they will be replaced by the\n default branch of their containing repository.", "operationId": "streamCommits" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/compare/diff{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the path to the file to diff (optional)", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the source commit (can be a partial/full commit ID or qualified/unqualified ref name)", "in": "query", "name": "from", "required": false, "type": "string" }, { "description": "the target commit (can be a partial/full commit ID or qualified/unqualified ref name)", "in": "query", "name": "to", "required": false, "type": "string" }, { "default": "", "description": "an optional parameter specifying the source repository containing the source commit\n if that commit is not present in the current repository; the repository can be specified\n by either its ID fromRepo=42 or by its project key plus its repo slug separated by\n a slash: fromRepo=projectKey/repoSlug", "in": "query", "name": "fromRepo", "required": false, "type": "string" }, { "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "default": -1, "description": "an optional number of context lines to include around each added or removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "description": "an optional whitespace flag which can be set to ignore-all", "in": "query", "name": "whitespace", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Gets a diff of the changes available in the {@code from} commit but not in the {@code to} commit.\n

    \n If either the {@code from} or {@code to} commit are not specified, they will be replaced by the\n default branch of their containing repository.", "operationId": "streamDiffCompare" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/diff": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": -1, "description": "the number of context lines to include around added/removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "description": "the base revision to diff from. If omitted the parent revision of the until revision is used", "in": "query", "name": "since", "required": false, "type": "string" }, { "description": "the source path for the file, if it was copied, moved or renamed", "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "description": "the target revision to diff to (required)", "in": "query", "name": "until", "required": false, "type": "string" }, { "description": "optional whitespace flag which can be set to ignore-all", "in": "query", "name": "whitespace", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the diff for a specified file path between two provided revisions.\n

    \n Note: This resource is currently not paged. The server will internally apply a hard cap\n to the streamed lines, and it is not possible to request subsequent pages if that cap is exceeded. In the event\n that the cap is reached, the diff will be cut short and one or more truncated flags will be set to\n true on the segments, hunks and diffs substructures in the returned JSON response.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "streamDiffRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/diff/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the path to the file which should be diffed (required)", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": -1, "description": "the number of context lines to include around added/removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "description": "the base revision to diff from. If omitted the parent revision of the until revision is used", "in": "query", "name": "since", "required": false, "type": "string" }, { "description": "the source path for the file, if it was copied, moved or renamed", "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "description": "the target revision to diff to (required)", "in": "query", "name": "until", "required": false, "type": "string" }, { "description": "optional whitespace flag which can be set to ignore-all", "in": "query", "name": "whitespace", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the diff for a specified file path between two provided revisions.\n

    \n Note: This resource is currently not paged. The server will internally apply a hard cap\n to the streamed lines, and it is not possible to request subsequent pages if that cap is exceeded. In the event\n that the cap is reached, the diff will be cut short and one or more truncated flags will be set to\n true on the segments, hunks and diffs substructures in the returned JSON response.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "streamDiffRepositoryFile" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/files": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit ID or ref (e.g. a branch or tag) to list the files at.\n If not specified the default branch will be used instead.", "in": "query", "name": "at", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of files from particular directory of a repository. The search is done recursively, so all files\n from any sub-directory of the specified directory will be returned.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "streamFiles" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/files/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "default": "", "description": "the directory to list files for.", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit ID or ref (e.g. a branch or tag) to list the files at.\n If not specified the default branch will be used instead.", "in": "query", "name": "at", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of files from particular directory of a repository. The search is done recursively, so all files\n from any sub-directory of the specified directory will be returned.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "streamFilesRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/forks": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve repositories which have been forked from this one. Unlike {@link #getRelatedRepositories(Repository,\n PageRequest) related repositories}, this only looks at a given repository's direct forks. If those forks have\n themselves been the origin of more forks, such \"grandchildren\" repositories will not be retrieved.\n

    \n Only repositories to which the authenticated user has REPO_READ permission will be included, even\n if other repositories have been forked from this one.", "operationId": "getForkedRepositories" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/last-modified": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit to use as the starting point when listing files and calculating modifications", "in": "query", "name": "at", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Streams files in the requested path with the last commit to modify each file. Commit modifications\n are traversed starting from the at commit or, if not specified, from the tip of the default branch.\n

    \n Unless the repository is public, the authenticated user must have REPO_READ access to call this resource.", "operationId": "stream" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/last-modified/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the path within the repository whose files should be streamed", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit to use as the starting point when listing files and calculating modifications", "in": "query", "name": "at", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Streams files in the requested path with the last commit to modify each file. Commit modifications\n are traversed starting from the at commit or, if not specified, from the tip of the default branch.\n

    \n Unless the repository is public, the authenticated user must have REPO_READ access to call this resource.", "operationId": "streamFilesLastMofied" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/participants": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": "incoming", "description": "(optional, defaults to INCOMING) the direction relative to the specified\n repository. Either INCOMING or OUTGOING.", "in": "query", "name": "direction", "required": false, "type": "string" }, { "description": "(optional) return only users, whose username, name or email address contain\n the {@code filter} value", "in": "query", "name": "filter", "required": false, "type": "string" }, { "description": "(optional) The role associated with the pull request participant.\n This must be one of {@code AUTHOR}, {@code REVIEWER}, or{@code PARTICIPANT}", "in": "query", "name": "role", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of participant users for all the pull requests to or from the specified repository.\n

    \n

    \n Optionally clients can specify following filters.", "operationId": "search" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/permissions/groups": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "delete": { "parameters": [ { "description": "the name of the group", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Revoke all permissions for the specified repository for a group.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource.\n

    \n In addition, a user may not revoke a group's permissions if it will reduce their own permission level.", "operationId": "revokePermissionsForGroup" }, "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups that have been granted at least one permission for the specified repository.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource.", "operationId": "getGroupsWithAnyPermissionRepository" }, "put": { "parameters": [ { "description": "the permission to grant", "in": "query", "name": "permission", "required": false, "type": "string" }, { "description": "the names of the groups", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Promote or demote a group's permission level for the specified repository. Available repository permissions are:\n

    \n See the Bitbucket\n Server documentation for a detailed explanation of what each permission entails.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource. In addition, a user may not demote a group's permission level if their\n own permission level would be reduced as a result.", "operationId": "setPermissionForGroup" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/permissions/groups/none": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of groups that have no granted permissions for the specified repository.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource.", "operationId": "getGroupsWithoutAnyPermissionRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/permissions/users": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "delete": { "parameters": [ { "description": "the name of the user", "in": "query", "name": "name", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Revoke all permissions for the specified repository for a user.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource.\n

    \n In addition, a user may not revoke their own repository permissions if they do not have a higher\n project or global permission.", "operationId": "revokePermissionsForUser" }, "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of users that have been granted at least one permission for the specified repository.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource.", "operationId": "getUsersWithAnyPermission" }, "put": { "parameters": [ { "description": "the names of the users", "in": "query", "name": "name", "required": false, "type": "string" }, { "description": "the permission to grant", "in": "query", "name": "permission", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Promote or demote a user's permission level for the specified repository. Available repository permissions are:\n

    \n See the Bitbucket\n Server documentation for a detailed explanation of what each permission entails.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource. In addition, a user may not reduce their own permission level unless\n they have a project or global permission that already implies that permission.", "operationId": "setPermissionForUser" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/permissions/users/none": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "if specified only group names containing the supplied string will be returned", "in": "query", "name": "filter", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of licensed users that have no granted permissions for the specified repository.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository or a higher\n project or global permission to call this resource.", "operationId": "getUsersWithoutPermission" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": "incoming", "description": "(optional, defaults to INCOMING) the direction relative to the specified\n repository. Either INCOMING or OUTGOING.", "in": "query", "name": "direction", "required": false, "type": "string" }, { "description": "(optional) a fully-qualified branch ID to find pull requests to or from,\n such as {@code refs/heads/master}", "in": "query", "name": "at", "required": false, "type": "string" }, { "description": "(optional, defaults to OPEN). Supply ALL to return pull request\n in any state. If a state is supplied only pull requests in the specified state will be returned.\n Either OPEN, DECLINED or MERGED.", "in": "query", "name": "state", "required": false, "type": "string" }, { "description": "(optional, defaults to NEWEST) the order to return pull requests in, either\n OLDEST (as in: \"oldest first\") or NEWEST.", "in": "query", "name": "order", "required": false, "type": "string" }, { "default": true, "description": "(optional) defaults to true, whether to return additional pull request attributes", "in": "query", "name": "withAttributes", "required": false, "type": "boolean" }, { "default": true, "description": "(optional) defaults to true, whether to return additional pull request properties", "in": "query", "name": "withProperties", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of pull requests to or from the specified repository.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call\n this resource.\n\n Optionally clients can specify PR participant filters. Each filter has a mandatory {@code username.N}\n parameter, and the optional {@code role.N} and {@code approved.N} parameters.\n

    ", "operationId": "getPage" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Create a new pull request between two branches. The branches may be in the same repository, or different ones.\n When using different repositories, they must still be in the same {@link Repository#getHierarchyId() hierarchy}.\n

    \n The authenticated user must have REPO_READ permission for the \"from\" and \"to\"repositories to\n call this resource.", "operationId": "create" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the ID of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "delete": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Deletes a pull request.\n

    \n To call this resource, users must be authenticated and have permission to view the pull request.\n Additionally, they must:\n

    \n\n A body containing the version of the pull request must be provided with this request.\n\n 
    { \"version\": 1 }
    ", "operationId": "delete" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "get" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the title, description, reviewers or destination branch of an existing pull request.\n

    \n Note: the reviewers list may be updated using this resource. However the\n author and participants list may not.\n

    \n The authenticated user must either:\n

    \n to call this resource.", "operationId": "update" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/activities": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "parameters": [ { "description": "(optional) the id of the activity item to use as the first item in the returned page", "format": "int64", "in": "query", "name": "fromId", "required": false, "type": "integer" }, { "description": "(required if fromId is present) the type of the activity item specified by\n fromId (either COMMENT or ACTIVITY)", "in": "query", "name": "fromType", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of activity associated with a pull request.\n

    \n Activity items include comments, approvals, rescopes (i.e. adding and removing of commits), merges and more.\n

    \n Different types of activity items may be introduced in newer versions of Stash or by user installed plugins, so\n clients should be flexible enough to handle unexpected entity shapes in the returned page.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "getActivities" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/approve": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Remove approval from a pull request as the current user. This does not remove the user as a participant.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.\n

    \n Deprecated since 4.2. Use\n /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/participants/{userSlug} instead", "operationId": "withdrawApproval" }, "post": { "responses": { "200": { "description": "Successful Response" } }, "description": "Approve a pull request as the current user. Implicitly adds the user as a participant if they are not already.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.\n

    \n Deprecated since 4.2. Use\n /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/participants/{userSlug} instead", "operationId": "approve" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/changes": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "parameters": [ { "default": "ALL", "description": "{@code UNREVIEWED} to stream the unreviewed changes for the current user (if they exist);\n {@code RANGE} to stream changes between two arbitrary commits (requires {@code sinceId} and\n {@code untilId}); otherwise {@code ALL} to stream all changes (the default)", "in": "query", "name": "changeScope", "required": false, "type": "string" }, { "description": "the since commit hash to stream changes for a {@code RANGE} arbitrary change scope", "in": "query", "name": "sinceId", "required": false, "type": "string" }, { "description": "the until commit hash to stream changes for a {@code RANGE} arbitrary change scope", "in": "query", "name": "untilId", "required": false, "type": "string" }, { "default": true, "description": "{@code true} to apply comment counts in the changes (the default); otherwise, {@code false}\n to stream changes without comment counts", "in": "query", "name": "withComments", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Gets changes for the specified PullRequest.\n

    \n If the {@code changeScope} query parameter is set to {@code unreviewed}, the application will attempt to stream\n unreviewed changes based on the {@code lastReviewedCommit} of the current user, which are the changes between the\n {@code lastReviewedCommit} and the latest commit of the source branch. The current user is considered to\n not have any unreviewed changes for the pull request when the {@code lastReviewedCommit} is either\n {@code null} (everything is unreviewed, so all changes are streamed), equal to the latest commit of the source\n branch (everything is reviewed), or no longer on the source branch (the source branch has been rebased). In these\n cases, the application will fall back to streaming all changes (the default), which is the effective diff for the\n pull request. The type of changes streamed can be determined by the {@code changeScope} parameter included in the\n properties map of the response.\n

    \n Note: This resource is currently not paged. The server will return at most one page. The server will\n truncate the number of changes to either the request's page limit or an internal maximum, whichever is smaller.\n The start parameter of the page request is also ignored.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "streamChanges" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/comments": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "parameters": [ { "default": "ACTIVE", "description": "{@code ACTIVE} to stream the active comments;\n {@code ORPHANED} to stream the orphaned comments;\n {@code ALL} to stream both the active and the orphaned comments;", "in": "query", "name": "anchorState", "required": false, "type": "string" }, { "description": "{@code EFFECTIVE} to stream the comments related to the effective diff of the pull request;\n {@code RANGE} to stream comments related to a commit range between two arbitrary commits\n (requires {@code fromHash} and {@code toHash});\n {@code COMMIT} to stream comments related to a commit between two arbitrary commits (requires\n {@code fromHash} and {@code toHash})", "in": "query", "name": "diffType", "required": false, "type": "string" }, { "description": "the from commit hash to stream comments for a {@code RANGE} or {@code COMMIT} arbitrary change scope", "in": "query", "name": "fromHash", "required": false, "type": "string" }, { "description": "the path to stream comments for a given path", "in": "query", "name": "path", "required": false, "type": "string" }, { "description": "the to commit hash to stream comments for a {@code RANGE} or {@code COMMIT} arbitrary change scope", "in": "query", "name": "toHash", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Gets comments for the specified PullRequest.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "getCommentsCommit" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Add a new comment.\n

    \n Comments can be added in a few places by setting different attributes:\n

    \n General pull request comment:\n\n 

    \n     {\n         \"text\": \"An insightful general comment on a pull request.\"\n     }\n
    \n\n Reply to a comment:\n\n 
    \n     {\n         \"text\": \"A measured reply.\",\n         \"parent\": {\n             \"id\": 1\n         }\n     }\n
    \n\n General file comment:\n\n 
    \n     {\n         \"text\": \"An insightful general comment on a file.\",\n         \"anchor\": {\n             \"diffType\": \"RANGE\",\n             \"fromHash\": \"6df3858eeb9a53a911cd17e66a9174d44ffb02cd\",\n             \"path\": \"path/to/file\",\n             \"srcPath\": \"path/to/file\",\n             \"toHash\": \"04c7c5c931b9418ca7b66f51fe934d0bd9b2ba4b\"\n         }\n     }\n
    \n\n File line comment:\n\n 
    \n     {\n         \"text\": \"A pithy comment on a particular line within a file.\",\n         \"anchor\": {\n             \"diffType\": \"COMMIT\",\n             \"line\": 1,\n             \"lineType\": \"CONTEXT\",\n             \"fileType\": \"FROM\",\n             \"fromHash\": \"6df3858eeb9a53a911cd17e66a9174d44ffb02cd\",\n             \"path\": \"path/to/file\",\n             \"srcPath\": \"path/to/file\",\n             \"toHash\": \"04c7c5c931b9418ca7b66f51fe934d0bd9b2ba4b\"\n         }\n     }\n
    \n

    \n For file and line comments, 'path' refers to the path of the file to which the comment should be applied and\n 'srcPath' refers to the path the that file used to have (only required for copies and moves). Also,\n fromHash and toHash refer to the sinceId / untilId (respectively) used to produce the diff on which the comment\n was added. Finally diffType refers to the type of diff the comment was added on. For backwards compatibility\n purposes if no diffType is provided and no fromHash/toHash pair is provided the diffType will be resolved to\n 'EFFECTIVE'. In any other cases the diffType is REQUIRED.\n

    \n For line comments, 'line' refers to the line in the diff that the comment should apply to. 'lineType' refers to\n the type of diff hunk, which can be:\n

    \n 'fileType' refers to the file of the diff to which the anchor should be attached - which is of relevance when\n displaying the diff in a side-by-side way. Currently the supported values are:\n \n If the current user is not a participant the user is added as a watcher of the pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "createCommentCommit" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/comments/{commentId}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pullRequest to retrieve", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" }, { "description": "the id of the comment to retrieve", "format": "int64", "in": "path", "name": "commentId", "required": true, "type": "integer" } ], "delete": { "parameters": [ { "default": -1, "description": "The expected version of the comment. This must match the server's version of the comment or\n the delete will fail. To determine the current version of the comment, the comment should be\n fetched from the server prior to the delete. Look for the 'version' attribute in the\n returned JSON structure.", "format": "int32", "in": "query", "name": "version", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Delete a pull request comment. Anyone can delete their own comment. Only users with REPO_ADMIN\n and above may delete comments created by other users.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "deleteCommentCommit" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a pull request comment.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "getCommentCommit" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the text of a comment. Only the user who created a comment may update it.\n

    \n Note: the supplied supplied JSON object must contain a version that must match the\n server's version of the comment or the update will fail. To determine the current version of\n the comment, the comment should be fetched from the server prior to the update. Look for the\n 'version' attribute in the returned JSON structure.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "updateCommentCommit" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/commits": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "parameters": [ { "description": "if set to true, the service will add \"authorCount\" and \"totalCount\" at the end of the page.\n \"authorCount\" is the number of different authors and \"totalCount\" is the total number of commits.", "in": "query", "name": "withCounts", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve commits for the specified pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "getCommitsPR" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/decline": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "post": { "parameters": [ { "default": -1, "description": "the current version of the pull request. If the server's version isn't the same as the specified\n version the operation will fail. To determine the current version of the pull request it should be\n fetched from the server prior to this operation. Look for the 'version' attribute in the returned\n JSON structure.", "format": "int32", "in": "query", "name": "version", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Decline a pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "decline" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/diff": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "parameters": [ { "default": -1, "description": "the number of context lines to include around added/removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "default": "EFFECTIVE", "description": "the type of diff being requested. When {@code withComments} is {@code true}\n this works as a hint to the system to attach the correct set of comments to the diff", "in": "query", "name": "diffType", "required": false, "type": "string" }, { "description": "the since commit hash to stream a diff between two arbitrary hashes", "in": "query", "name": "sinceId", "required": false, "type": "string" }, { "description": "the previous path to the file, if the file has been copied, moved or renamed", "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "description": "the until commit hash to stream a diff between two arbitrary hashes", "in": "query", "name": "untilId", "required": false, "type": "string" }, { "description": "optional whitespace flag which can be set to ignore-all", "in": "query", "name": "whitespace", "required": false, "type": "string" }, { "default": true, "description": "true to embed comments in the diff (the default); otherwise, false\n to stream the diff without comments", "in": "query", "name": "withComments", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Streams a diff within a pull request.\n

    \n If the specified file has been copied, moved or renamed, the srcPath must also be specified to\n produce the correct diff.\n

    \n Note: This RESTful endpoint is currently not paged. The server will internally apply a hard cap to the\n streamed lines, and it is not possible to request subsequent pages if that cap is exceeded.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "streamDiffPR" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/diff/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" }, { "description": "the path to the file which should be diffed (optional)", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": -1, "description": "the number of context lines to include around added/removed lines in the diff", "format": "int32", "in": "query", "name": "contextLines", "required": false, "type": "integer" }, { "default": "EFFECTIVE", "description": "the type of diff being requested. When {@code withComments} is {@code true}\n this works as a hint to the system to attach the correct set of comments to the diff", "in": "query", "name": "diffType", "required": false, "type": "string" }, { "description": "the since commit hash to stream a diff between two arbitrary hashes", "in": "query", "name": "sinceId", "required": false, "type": "string" }, { "description": "the previous path to the file, if the file has been copied, moved or renamed", "in": "query", "name": "srcPath", "required": false, "type": "string" }, { "description": "the until commit hash to stream a diff between two arbitrary hashes", "in": "query", "name": "untilId", "required": false, "type": "string" }, { "description": "optional whitespace flag which can be set to ignore-all", "in": "query", "name": "whitespace", "required": false, "type": "string" }, { "default": true, "description": "true to embed comments in the diff (the default); otherwise, false\n to stream the diff without comments", "in": "query", "name": "withComments", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Streams a diff within a pull request.\n

    \n If the specified file has been copied, moved or renamed, the srcPath must also be specified to\n produce the correct diff.\n

    \n Note: This RESTful endpoint is currently not paged. The server will internally apply a hard cap to the\n streamed lines, and it is not possible to request subsequent pages if that cap is exceeded.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "streamDiff" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/merge": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the ID of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Test whether a pull request can be merged.\n

    \n A pull request may not be merged if:\n

    \n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "canMerge" }, "post": { "parameters": [ { "default": -1, "description": "the current version of the pull request. If the server's version isn't the same as the specified\n version the operation will fail. To determine the current version of the pull request it should be\n fetched from the server prior to this operation. Look for the 'version' attribute in the returned\n JSON structure.", "format": "int32", "in": "query", "name": "version", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Merge the specified pull request.\n

    \n The authenticated user must have REPO_WRITE permission for the repository that this pull request\n targets to call this resource.", "operationId": "merge" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/participants": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "delete": { "parameters": [ { "description": "the participant's user name", "in": "query", "name": "username", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Unassigns a participant from the REVIEWER role they may have been given in a pull request.\n

    \n If the participant has no explicit role this method has no effect.\n

    \n Afterwards, the user will still remain a participant in the pull request but their role will be reduced to\n PARTICIPANT. This is because once made a participant of a pull request,\n a user will forever remain a participant. Only their role may be altered.\n

    \n The authenticated user must have REPO_WRITE permission for the repository that this pull request\n targets to call this resource.\n

    \n Deprecated since 4.2. Use\n /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/participants/{userSlug}\n instead.", "operationId": "unassignParticipantRolePR" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieves a page of the participants for a given pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "listParticipants" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Assigns a participant to an explicit role in pull request. Currently only the REVIEWER role may be assigned.\n

    \n If the user is not yet a participant in the pull request, they are made one and assigned the supplied role.\n

    \n If the user is already a participant in the pull request, their previous role is replaced with the supplied role\n unless they are already assigned the AUTHOR role which cannot be changed and will result in a Bad Request (400)\n response code.\n

    \n The authenticated user must have REPO_WRITE permission for the repository that this pull request\n targets to call this resource.", "operationId": "assignParticipantRole" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/participants/{userSlug}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" }, { "description": "the slug for the user changing their status", "in": "path", "name": "userSlug", "required": true, "type": "string" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Unassigns a participant from the REVIEWER role they may have been given in a pull request.\n

    \n If the participant has no explicit role this method has no effect.\n

    \n Afterwards, the user will still remain a participant in the pull request but their role will be reduced to\n PARTICIPANT. This is because once made a participant of a pull request,\n a user will forever remain a participant. Only their role may be altered.\n

    \n The authenticated user must have REPO_WRITE permission for the repository that this pull request\n targets to call this resource.\n

    \n Deprecated since 4.2. Use\n /rest/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/participants/{userSlug}\n instead.", "operationId": "unassignParticipantRole" }, "put": { "responses": { "200": { "description": "Successful Response" } }, "description": "Change the current user's status for a pull request. Implicitly adds the user as a participant if they are not\n already. If the current user is the author, this method will fail.\n

    \n The possible values for {@code status} are UNAPPROVED, NEEDS_WORK, or\n APPROVED.\n

    \n If the new {@code status} is NEEDS_WORK or APPROVED then the\n {@code lastReviewedCommit} for the participant will be updated to the latest commit of the source branch of the\n pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "updateStatus" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/reopen": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "post": { "parameters": [ { "default": -1, "description": "the current version of the pull request. If the server's version isn't the same as the specified\n version the operation will fail. To determine the current version of the pull request it should be\n fetched from the server prior to this operation. Look for the 'version' attribute in the returned\n JSON structure.", "format": "int32", "in": "query", "name": "version", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Re-open a declined pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "reopen" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/tasks": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the tasks associated with a pull request.", "operationId": "getPullRequestTasks" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/tasks/count": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the total number of {@link TaskState#OPEN open} and\n {@link TaskState#RESOLVED resolved} tasks associated with a pull request.", "operationId": "countPullRequestTasks" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/pull-requests/{pullRequestId}/watch": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the id of the pull request within the repository", "format": "int64", "in": "path", "name": "pullRequestId", "required": true, "type": "integer" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Make the authenticated user stop watching the specified pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "unwatchPR" }, "post": { "responses": { "200": { "description": "Successful Response" } }, "description": "Make the authenticated user watch the specified pull request.\n

    \n The authenticated user must have REPO_READ permission for the repository that this pull request\n targets to call this resource.", "operationId": "watchPR" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/raw": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit ID or ref to retrieve the content for.", "in": "query", "name": "at", "required": false, "type": "string" }, { "description": "if present or \"true\", triggers the raw content to be markup-rendered and returned\n as HTML; otherwise, if not specified, or any value other than \"true\", the content\n is streamed without markup", "in": "query", "name": "markup", "required": false, "type": "string" }, { "description": "(Optional) Whether the markup implementation should convert newlines to breaks.\n If not specified, {@link MarkupService} will use the value of the\n markup.render.hardwrap property, which is true by default", "in": "query", "name": "hardwrap", "required": false, "type": "boolean" }, { "description": "(Optional) true if HTML should be escaped in the input markup, false otherwise.\n If not specified, {@link MarkupService} will use the value of the\n markup.render.html.escape property, which is true by default", "in": "query", "name": "htmlEscape", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the raw content for a file path at a specified revision.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getContentRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/raw/{path}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "description": "the file path to retrieve content from", "in": "path", "name": "path", "required": true, "type": "string" } ], "get": { "parameters": [ { "description": "the commit ID or ref to retrieve the content for.", "in": "query", "name": "at", "required": false, "type": "string" }, { "description": "if present or \"true\", triggers the raw content to be markup-rendered and returned\n as HTML; otherwise, if not specified, or any value other than \"true\", the content\n is streamed without markup", "in": "query", "name": "markup", "required": false, "type": "string" }, { "description": "(Optional) Whether the markup implementation should convert newlines to breaks.\n If not specified, {@link MarkupService} will use the value of the\n markup.render.hardwrap property, which is true by default", "in": "query", "name": "hardwrap", "required": false, "type": "boolean" }, { "description": "(Optional) true if HTML should be escaped in the input markup, false otherwise.\n If not specified, {@link MarkupService} will use the value of the\n markup.render.html.escape property, which is true by default", "in": "query", "name": "htmlEscape", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the raw content for a file path at a specified revision.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getContentRepositoryPath" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/recreate": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "post": { "responses": { "200": { "description": "Successful Response" } }, "description": "If a create or fork operation fails, calling this method will clean up the broken repository and try again. The\n repository must be in an INITIALISATION_FAILED state.\n

    \n The authenticated user must have PROJECT_ADMIN permission for the specified project to call this\n resource.", "operationId": "retryCreateRepository" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/related": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve repositories which are related to this one. Related repositories are from the same\n {@link Repository#getHierarchyId() hierarchy} as this repository.\n

    \n Only repositories to which the authenticated user has REPO_READ permission will be included, even\n if more repositories are part of this repository's hierarchy.", "operationId": "getRelatedRepositories" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/hooks": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "parameters": [ { "default": "", "description": "the optional type to filter by. Valid values are PRE_RECEIVE or POST_RECEIVE", "in": "query", "name": "type", "required": false, "type": "string" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a page of repository hooks for this repository.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getRepositoryHooksSettings" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/hooks/{hookKey}": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "in": "path", "name": "hookKey", "required": true, "type": "string" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Delete repository hook configuration for the supplied hookKey and repositorySlug\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.", "operationId": "deleteRepositoryHook" }, "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve a repository hook for this repository.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getRepositoryHookSettings" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/hooks/{hookKey}/enabled": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "in": "path", "name": "hookKey", "required": true, "type": "string" } ], "delete": { "responses": { "200": { "description": "Successful Response" } }, "description": "Disable a repository hook for this repository.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.", "operationId": "disableHookRepo" }, "put": { "parameters": [ { "default": 0, "format": "int32", "in": "header", "name": "Content-Length", "required": false, "type": "integer" } ], "responses": { "200": { "description": "Successful Response" } }, "description": "Enable a repository hook for this repository and optionally apply new configuration.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.\n

    \n A JSON document may be provided to use as the settings for the hook. These structure and validity of\n the document is decided by the plugin providing the hook.", "operationId": "enableHookRepo" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/hooks/{hookKey}/settings": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" }, { "in": "path", "name": "hookKey", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the settings for a repository hook for this repository.\n

    \n The authenticated user must have REPO_READ permission for the specified repository to call this\n resource.", "operationId": "getSettingsHook" }, "put": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Modify the settings for a repository hook for this repository.\n

    \n The service will reject any settings which are too large, the current limit is 32KB once serialized.\n

    \n The authenticated user must have REPO_ADMIN permission for the specified repository to call this\n resource.\n

    \n A JSON document can be provided to use as the settings for the hook. These structure and validity of the document\n is decided by the plugin providing the hook.", "operationId": "setSettings" } }, "/api/1.0/projects/{projectKey}/repos/{repositorySlug}/settings/pull-requests": { "parameters": [ { "description": "the parent project key", "in": "path", "name": "projectKey", "required": true, "type": "string" }, { "description": "the repository slug", "in": "path", "name": "repositorySlug", "required": true, "type": "string" } ], "get": { "responses": { "200": { "description": "Successful Response" } }, "description": "Retrieve the pull request settings for the context repository.\n

    \n The authenticated user must have REPO_READ permission for the context repository to call this\n resource.\n

    \n This resource will call all RestFragments that are registered with the key\n bitbucket.repository.settings.pullRequests. If any fragment fails validations by returning a\n non-empty Map of errors, then no fragments will execute.\n

    \n The property keys for the settings that are bundled with the application are\n

    ", "operationId": "getPullRequestSettings" }, "post": { "parameters": [], "responses": { "200": { "description": "Successful Response" } }, "description": "Update the pull request settings for the context repository.\n

    \n The authenticated user must have REPO_ADMIN permission for the context repository to call this\n resource.\n

    \n This resource will call all RestFragments that are registered with the key\n bitbucket.repository.settings.pullRequests. If any fragment fails validations by returning a\n non-empty Map of errors, then no fragments will execute.\n

    \n Only the settings that should be updated need to be included in the request.\n

    \n The property keys for the settings that are bundled with the application are\n

    \n Merge strategy configuration deletion:\n

    \n An explicitly set pull request merge strategy configuration can be deleted by POSTing a document with an empty\n \"mergeConfig\" attribute. i.e:\n 

    \n {\n     \"mergeConfig\": {\n     }\n }\n
    \n Upon completion of this request, the effective configuration will be:\n