@PublicApi This API is public. See our policy.
@PublicApi This API is public. See our policy.
Search for baselines.@since 2.6.3 and since APIv9.
Type | Name | Description |
---|---|---|
Query param | ?q=... | String. |
Query param | ?spaceKeys=... | String. the (comma-separated) list of spaces where the search needs to be made |
Query param | ?limit=... | Integer. |
Query param | ?expand=... | String. Use "details" if you need to URL to the baseline or the count of requirements. |
Returns | HTTP Response. a list of SpaceAndBaseliness. |
@PublicApi This API is public. See our policy.
@PublicAPI
– Read our API policy
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the space key |
Query param | ?expand=... | String. Use "details" if you need to URL to the baseline or the count of requirements. |
Returns | HTTP Response. a list of Baselines. |
@Internal Private resource. It will change often and it is not entirely documented.
List the baselines in this space.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {version} | int. |
Returns | HTTP Response. a list of pages. |
@Internal Private resource. It will change often and it is not entirely documented.
Freeze a baseline, based on a query.
API subject to change in micro releases.
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the space key |
Body |
JSON containing:
{ // Object of type CreationPayloadClassic
queryString: String,
name: String,
ceo: String,
}
|
|
Returns | HTTP Response. the details of the baseline, in JSON. |
@Internal Private resource. It will change often and it is not entirely documented.
Freeze a baseline, based on a query.
API subject to change in micro releases.
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the space key |
Body |
JSON containing:
{ // Object of type CreationPayloadInstant
name: String,
fromCeo: Long,
fromCeoWithChildren: boolean,
}
|
|
Returns | HTTP Response. the details of the baseline, in JSON. |
@PublicApi This API is public. See our policy.
Not documentedType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {version} | int. |
Body | String. | |
Returns | HTTP Response. |
@PublicApi This API is public. See our policy.
Not documentedType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {version} | int. |
Returns | HTTP Response. |
@PublicApi This API is public. See our policy.
Verifies the validity of the name for the next baselineType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?baselineName=... | String. |
Returns | HTTP Response. |
@PublicApi This API is public. See our policy.
Suggest the name for the next baselineType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?pageName=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Used to refreeze a baseline and create a new page for it. It executes a longRunningTask that will do this operation.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body |
{ // Object of type RefreezePayload
baselineToRefreeze: int,
queryForRequirementsToExcludeFromBaseline: String, // Query string for the requirements to exclude from the baseline.
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not documentedType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body |
{ // Object of type RefreezePayload
baselineToRefreeze: int,
queryForRequirementsToExcludeFromBaseline: String, // Query string for the requirements to exclude from the baseline.
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Returns a MultiMap (key: relationship, values: requirementRef) to show the dependencies that should be added to the new baseline if we are refreezingType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. String space key. |
Query param | ?queryForRequirementsToBaseline=... | String. String query for requirements to baseline. |
Query param | ?queryForRequirementsToRemove=... | String. String query for requirements to exclude from the baseline. |
Returns | HTTP Response. |
CRUD API for requirements. As opposed to RequirementResource, this one is space-local.
@PublicApi This API is public. See our policy.
@PublicApi This API is public. See our policy.
@PublicAPI – Read our API policy
Get a requirementType | Name | Description |
---|---|---|
Path param | {key} | String. the key |
Path param | {spaceKey} | String. the space key |
Query param | ?v=... | String. the baseline (optional) |
Query param | ?expand=... | String. Use "references" if references need to be expanded (optional) |
Returns | HTTP Response. |
@PublicApi This API is public. See our policy.
@PublicAPI – Read our API policy
Search for requirements.Type | Name | Description |
---|---|---|
Path param | {spaceKey} |
String.
The space key in the URL path. It is only used for information purpose. If the other spaceKey is missing, and if the option "Isolate Spaces" is ticked in the administration, then the search is restricted to this space. Can be "*". |
Query param | ?q=... |
String.
the search query, in the Search Syntax format |
Query param | ?spaceKey=... |
String.
Comma-separated list, or "*" to ignore spaces. Restricts the search to this specific space. If null, and if the option "isolate spaces" is ticked, then it is defaulted to the current space. |
Query param | ?offset=... | Integer. Used for pagination |
Query param | ?includeArchived=... |
boolean.
Whether the archived requirements should be included. By default (false), only current (ACTIVE) requirements are displayed, unless there is a reason not to (such as a baselineCondition). |
Query param | ?baselineCondition=... |
String.
Restrict the search to these specific baselines. Example: "ds-1,ie-8" signifies "The baseline 1 of space 'ds' or the baseline 8 of space 'ie'". |
Query param | ?limit=... | Integer. Used for pagination |
Query param | ?sort=... | String. The SQL ORDER BY clause, by default "KEY ASC, BASELINE DESC" |
Query param | ?order=... | String. Do not use. |
Query param | ?suggest=... | Integer. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@InternalAPI – Not intended for use by customers
Reserve one or several requirements for a given page or draft.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {key} | String. |
Query param | ?mode=... | String. |
Query param | ?suggestPrefix=... | String. |
Query param | ?suggestStart=... | Integer. |
Query param | ?suggestPadding=... | Integer. |
Query param | ?suggestQuantity=... | Integer. |
Query param | ?override=... | boolean. |
Query param | ?pageId=... | Long. |
Body |
{ // Object of type CreationRequest
providedJson: String,
spaceKey: String,
page: { // Object of type PageRef
pageId: Long,
version: Long, // The version of the page. This is useful when a link points to an older version of a page.
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@InternalAPI – Not intended for use by customers
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {key} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@InternalAPI – Not intended for use by customers
This is the key place where we write the requirement descriptionType | Name | Description |
---|---|---|
Path param | {key} | String. |
Path param | {spaceKey} | String. |
Body |
{ // Object of type Requirement
id: Long, // The ID of the requirement in the database. It should not be communicated to the UI, and we should not
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Modify requirements
@InternalAPI – Not intended for use by customers
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body |
[ { // Object of type Requirement
id: Long, // The ID of the requirement in the database. It should not be communicated to the UI, and we should not
|
|
Returns | HTTP Response. |
A Requirement resource that returns requirements in bulk
@PublicApi This API is public. See our policy.
@Internal Private resource. It will change often and it is not entirely documented.
Returns the list of requirements that match the requests.Type | Name | Description |
---|---|---|
Query param | ?fetchDependentPages=... | boolean. |
Query param | ?limit=... | int. |
Body |
[ { // Object of type RequirementResource3.RequirementRequest
spaceKey: String,
key: String,
v: Integer,
}, ... ]
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Returns the result of the formula applied to the properties found with the searchQueryType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. The current spaceKey |
Query param | ?q=... | String. Query to search requirements, and so the properties |
Query param | ?includeBaselined=... | boolean. Include the baselined requirements |
Query param | ?withJira=... | boolean. Include Jira data |
Query param | ?crossSpace=... | boolean. If the query is cross-spaced |
Query param | ?matrixType=... | String. One of ESTIMATION or TRACEABILITY: note that accumulators do not work with TRACEABILITY (but no check is implemented) |
Query param | ?formula=... |
String.
Here are some examples:
|
Body |
TraceabilityUIRenderRequest includes the variables for the currentBaseline
{ // Object of type TraceabilityResource.TraceabilityUIRenderRequest
traceabilityMatrixColumns: String,
offsetJson: String,
variables: { // Object of type java.util.Map<java.lang.String,java.lang.Object>
},
}
|
|
Returns | HTTP Response. A map with the { formulas -> result } |
REST endpoint to handle files for excel Integration
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {attachmentId} | Long. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {attachmentId} | Long. |
Body |
{ // Object of type WorkbookConfig.IntegrationState
}
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {attachmentId} | Long. |
Returns | HTTP Response. |
CRUD API for External Properties.
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Updates the value of the property name with EXTERNAL type
Example:
PUT /requirement/spacekey/REQ-001/external-properties/Estimate
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. The space key should be URI encoded (js ex: encodeURIComponent()) |
Path param | {key} | String. The requirement key should be URI encoded (js ex: encodeURIComponent()) |
Path param | {propertyName} | String. The property name should be URI encoded (js ex: encodeURIComponent()) |
Query param | ?v=... | String. The baseline number/name should be URI encoded (js ex: encodeURIComponent()) |
Body |
The property to save (Property
{ // Object of type Property
type: { // Object of type PropertyType
}, // Type of the property, a property can be INLINE (created in a page)
|
|
Returns | HTTP Response. |
Various functions that didn't fit in other resources
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Reindexes a page.Type | Name | Description |
---|---|---|
Path param | {contentId} | Long. |
Returns | Object. |
A REST resource to integrate RY with any other software.
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Returns the list of connected applicationsType | Name | Description |
---|---|---|
Query param | ?url=... | String. since 2.5.0, set to true if you want to filter for this URL. |
Query param | ?filterJira=... | boolean. since 2.3.1, set to true if you only want Jira instances to be returned. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Add an integrationType | Name | Description |
---|---|---|
Body |
a descriptor of the form IntegrationDescriptor. The serviceID will be randomly assigned. { // Object of type IntegrationDescriptor
serviceId: String,
applinkId: String, // The applink Id. If provided, the values should be copied over before it is used.
label: String,
displayUrl: String,
rpcUrl: String,
endpoint: String,
userKey: String, // userKey => String value of the UserKey
|
|
Returns | HTTP Response. the IntegrationDescriptor |
@Internal Private resource. It will change often and it is not entirely documented.
Get the details of an integration.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. the Service ID |
Query param | ?url=... | String. the base url, if the service ID is null. |
Returns | HTTP Response. the descriptor |
@Internal Private resource. It will change often and it is not entirely documented.
Checks and updates all the application links, and returns the list for display in global-admin.vm.Type | Name | Description |
---|---|---|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Body |
{ // Object of type AuthenticateUserInJiraPayload
username: String, // The username of the person to connect to Jira with.
checkUpgrade: boolean,
performUpgrade: boolean,
performUpgradeIfAuto: boolean, // Performs the update if and only if Jira has the applink configured in Auto mode
desiredVersion: Integer, // Desired version if performUpgrade = true. By default, it is the latest supported version.
}
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
This resource changes the version of the descriptor in Confluence, and attempts to notify Jira.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Query param | ?version=... | Integer. |
Query param | ?status=... | String. |
Returns | HTTP Response. |
@PublicApi This API is public. See our policy.
Update the descriptor. Also called by Jira.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Query param | ?url=... | String. |
Query param | ?fields=... | String. the fields to update, separated by a comma. Example: "version,status,endpoint,username" |
Body |
{ // Object of type IntegrationDescriptor
serviceId: String,
applinkId: String, // The applink Id. If provided, the values should be copied over before it is used.
label: String,
displayUrl: String,
rpcUrl: String,
endpoint: String,
userKey: String, // userKey => String value of the UserKey
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Delete the descriptorType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Gets the elements of the queue.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Query param | ?limit=... | Integer. |
Query param | ?includeDone=... | boolean. |
Query param | ?includeLastResponse=... | boolean. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Delete one item.
Required permission: Confluence administrator
Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {messageId} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Process one item.
Required permission: Confluence administrator
Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {messageId} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Attempts to flush the queueType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Accept messages about the integration, to remove/reset/add links.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. the service that's integrating |
Query param | ?url=... |
String.
if the service is null, please provide the base URL of the application and we'll try to match. |
Returns | HTTP Response. a list of Answer |
@Internal Private resource. It will change often and it is not entirely documented.
Accept messages about the integration, to remove/reset/add links.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. the service that's integrating |
Query param | ?url=... |
String.
if the service is null, please provide the base URL of the application and we'll try to match. |
Query param | ?timeout=... | Integer. the timeout in milliseconds, optional, the default is 30s, the max is 180s. Since 2.6.2 / APIv8. |
Body |
the list of JiraQueueMessage
[ { // Object of type JiraQueueMessage
operation: String,
title: String,
templateId: Long,
}, ... ]
|
|
Returns | HTTP Response. a list of Answer |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Return templates for a given spaceKeyType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body |
{ // Object of type IssueTemplate
id: long, // Active Object generated ID
spaceKey: String,
title: String,
applinkId: String,
projectId: long,
issueTypeId: long,
relationship: String,
fields: String,
groupAll: boolean,
projectMetadata: String, // Stringify Json: {
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Body |
{ // Object of type IssueTemplate
id: long, // Active Object generated ID
spaceKey: String,
title: String,
applinkId: String,
projectId: long,
issueTypeId: long,
relationship: String,
fields: String,
groupAll: boolean,
projectMetadata: String, // Stringify Json: {
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Query param | ?offset=... | int. |
Returns | HTTP Response. |
Resources for our Jira Bulk Issue Creation.
Only for internal usage. Quite useless for API users, you would be better off directly using Jira's DC REST APIs:
https://docs.atlassian.com/software/jira/docs/api/REST/8.11.0/
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {projectKey} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {projectKey} | String. |
Path param | {issueTypeId} | long. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {projectKey} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Body |
{ // Object of type IssuesCreationRequestFromUI
issueTemplate: { // Object of type IssueTemplate
id: long, // Active Object generated ID
spaceKey: String,
title: String,
applinkId: String,
projectId: long,
issueTypeId: long,
relationship: String,
fields: String,
groupAll: boolean,
projectMetadata: String, // Stringify Json: {
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Fetches the status of Jira issues. Permissions are those of JiraType | Name | Description |
---|---|---|
Path param | {serviceId} | String. the applink ID |
Query param | ?issues=... | String. the list of issue keys, comma-separated |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {taskId} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Get the currently-running jobs, directly from Jira, for the current user.Type | Name | Description |
---|---|---|
Query param | ?applinkId=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Get the details of one job, from Jira, for the current user.Type | Name | Description |
---|---|---|
Path param | {jobId} | int. |
Query param | ?applinkId=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Abort a job, assuming the current user has permissions.Type | Name | Description |
---|---|---|
Path param | {jobId} | int. |
Query param | ?applinkId=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Clean up the details of a job, once the user has seen the results.Type | Name | Description |
---|---|---|
Path param | {jobId} | int. |
Query param | ?applinkId=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {taskId} | String. |
Path param | {id} | Long. |
Body |
{ // Object of type java.util.Map<java.lang.String,java.lang.Object>
}
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Aborts the task and stop its trackingType | Name | Description |
---|---|---|
Path param | {taskId} | String. |
Returns | HTTP Response. |
A resource for various needs that couldn't be addressed in other resources
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Returns the history of a requirement.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?reqs=... |
[ { // Object of type java.lang.String
value: [ , ... ],
coder: byte,
hash: int,
}, ... ]
|
Query param | ?expand=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@PublicAPI – Read our API policy
Search for requirements.Type | Name | Description |
---|---|---|
Path param | {spaceKey} |
String.
The space key in the URL path. It is only used for information purpose. If the other spaceKey is missing, and if the option "Isolate Spaces" is ticked in the administration, then the search is restricted to this space. Can be "*". |
Query param | ?q=... |
String.
the search query, in the Search Syntax format |
Query param | ?spaceKey=... |
String.
Comma-separated list, or "*" to ignore spaces. Restricts the search to this specific space. If null, and if the option "isolate spaces" is ticked, then it is defaulted to the current space. |
Query param | ?offset=... | Integer. Used for pagination |
Query param | ?limit=... | Integer. Used for pagination |
Query param | ?includeBaselined=... | boolean. |
Query param | ?includeArchived=... |
boolean.
Whether the archived requirements should be included. By default (false), only current (ACTIVE) requirements are displayed, unless there is a reason not to (such as a baselineCondition). |
Query param | ?baselineCondition=... | String. Restrict the search to these specific baselines. |
Query param | ?sort=... | String. The SQL ORDER BY clause, by default "KEY ASC, BASELINE DESC" |
Query param | ?order=... | String. Do not use. |
Returns | HTTP Response. a RequirementSearchResult that contains => the search result, the suggestion filter, permissions, and whether the plugin RYTest is active |
@Internal Private resource. It will change often and it is not entirely documented.
Returns the list of requirements on the current page.
This method exists to optimize the execution time of the macro: It allows the macro to have no access to the database.
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {pageId} | long. |
Query param | ?numberOfRequirements=... | Integer. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
This method used to be used until commit 399a93d5395ad116, we're just keeping it for 2 years:Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
A REST resource to help the UI of the traceability matrix.Type | Name | Description |
---|---|---|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Get a traceability matrix.. administrators only.@deprecated since 2.5.10 - See {@link TraceabilityResource}
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?limit=... | Integer. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Get a traceability matrix.. administrators only.@deprecated since 2.5.10 - See {@link TraceabilityResource}
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
For test purposesType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?query=... | String. the query string, for example "key~'REQ-10%'" |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Tells whether we use the RY-554's extended mode, which allows special characters in requirement keys.Type | Name | Description |
---|---|---|
Returns | HTTP Response. true/false as a string (with double-quotes, it's a JSON string. |
CRUD API to remember what the user has already onboarded. It's like settings, but attached to a user's profile.
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {settingsName} | String. |
Body | String. | |
Returns | Object. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Query param | ?sendeveryone=... | boolean. |
Returns | Object. |
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Deletes a message from the queue, after checking we own it.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {messageId} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Deletes a message from the queue, after checking we own it.Type | Name | Description |
---|---|---|
Path param | {serviceId} | String. |
Path param | {messageId} | int. |
Returns | HTTP Response. |
CRUD API for PropertyName management
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Returns a list of property names used in the subMenuType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. current spaceKey |
Query param | ?limit=... | Integer. max number of items in the list |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Creates a property name
It the property name already exists, returns a Bad Request.
Type | Name | Description |
---|---|---|
Body |
Property containing the information
{ // Object of type Property
type: { // Object of type PropertyType
}, // Type of the property, a property can be INLINE (created in a page)
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Updates property nameType | Name | Description |
---|---|---|
Path param | {propertyName} | String. |
Body |
Property containing the information
{ // Object of type Property
type: { // Object of type PropertyType
}, // Type of the property, a property can be INLINE (created in a page)
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {propertyName} | String. |
Returns | HTTP Response. |
CRUD API for settings.
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
List preloaded keysType | Name | Description |
---|---|---|
Returns | Object. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {settingsName} | String. |
Returns | Object. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {settingsName} | String. |
Body | String. | |
Returns | Object. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Body |
{ // Object of type java.util.Map<java.lang.String,java.lang.String>
}
|
|
Returns | HTTP Response. |
A resource for repairs, when there is a data discrepancy between Confluence and Jira and an admin has to
manually fix it.
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
This method is used for the "Fix broken Jira links" screen in the space reindex.Type | Name | Description |
---|---|---|
Query param | ?q=... | String. |
Query param | ?limit=... | Integer. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
This method is used for the "Fix broken Jira links" screen in the space reindex.Type | Name | Description |
---|---|---|
Query param | ?applink=... | String. |
Query param | ?issue=... | String. |
Query param | ?spaceKey=... | String. |
Query param | ?key=... | String. |
Query param | ?baseline=... | Integer. |
Query param | ?relationship=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
This method is used for the "Fix broken Jira links" screen in the space reindex.Type | Name | Description |
---|---|---|
Query param | ?applink=... | String. String |
Query param | ?issue=... | String. String, the old Jira issue key. |
Query param | ?newIssue=... | String. String, the new Jira issue key. |
Returns | HTTP Response. |
A resource for anything managed in the Rich Text Editor
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
@InternalAPI – Not intended for use by customers
Returns the next available key for each req.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body |
[ { // Object of type java.lang.String
value: [ , ... ],
coder: byte,
hash: int,
}, ... ]
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@InternalAPI – Read our API policy
Both search for requirements and provide suggestions for keys. This resource is only used in the RTE.Type | Name | Description |
---|---|---|
Path param | {spaceKey} |
String.
the space key in the URL path. If the option "Isolate Spaces" is ticked in the administration, then the search is restricted to this space. Can be "*". |
Query param | ?q=... |
String.
the text entered by the user. This is NOT using the "Search Syntax". We'll return the keys matching exactly this text first, then the keys starting with this text, then requirements containing this text. |
Query param | ?includeArchived=... |
boolean.
Whether the archived requirements should be included. By default (false), only current (ACTIVE) requirements are displayed, unless there is a reason not to (such as a baselineCondition). |
Query param | ?suggest=... |
Integer.
The number of suggestions that can be returned for keys. Default is 0. If > 0, it will take the requirements returned by the search for this space, add 1 until we find one that doesn't exist. It is quite expensive in terms of resources, so please do not use lightly. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Transform a RYReportMacro into static content.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the current space key, required |
Query param | ?query=... | String. the search query string, optional default value is null |
Query param | ?includeDeleted=... | boolean. Boolean, whether we should only return active requirements, optional by default it is false |
Query param | ?crossSpace=... | boolean. |
Query param | ?columns=... | String. Comma-separated list of columns to render, optional by default the result report will contain three columns: key, description, links |
Query param | ?sameSpace=... | boolean. A Boolean to determine if we search cross space or not |
Query param | ?ceoId=... | String. The content-id of the current page |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Transform a RYReportMacro into static content.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the current space key, required |
Query param | ?query=... | String. the search query string, optional, default value is null |
Query param | ?includeDeleted=... | boolean. Boolean, whether we should only return active requirements, optional, default value is false |
Query param | ?savedQueryId=... | String. the saved query ID, optional |
Query param | ?savedQuerySpaceKey=... | String. The space key of the savedQueryId, optional |
Query param | ?withJira=... | boolean. |
Query param | ?crossSpace=... | boolean. |
Query param | ?columnsJson=... | String. A Json representation of the matrix columns to render, required |
Query param | ?ceoId=... | String. The content-id of the current page |
Returns | HTTP Response. |
Access to traceability matrix.TraceabilityMatrixfor the detail of a traceability matrix
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Returns the current user's own matrixes. I want, in a near future, to return all visible queries of this user.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?limit=... | Integer. the limit, or -1 |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Reads a traceability matrix. If you have permissions.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Saves a traceability matrix for the first time. It will return with a generated ID.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body | String. | |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Updates a traceability matrixType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Body | String. | |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Deletes a traceability matrixType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {id} | int. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
A REST resource to help the UI of the traceability matrix.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Query param | ?q=... | String. |
Query param | ?limit=... | Integer. |
Query param | ?includeBaselined=... | boolean. |
Query param | ?includeArchived=... | boolean. |
Query param | ?withJira=... | boolean. |
Query param | ?crossSpace=... | boolean. |
Query param | ?matrixType=... | String. |
Body |
{ // Object of type TraceabilityResource.TraceabilityUIRenderRequest
traceabilityMatrixColumns: String,
offsetJson: String,
variables: { // Object of type java.util.Map<java.lang.String,java.lang.Object>
},
}
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
A REST resource to return the front-end data of a column.
It will deduplicate results.
It will take care of not loading the entire columns, just the ones "parent" of the requested one.
Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {columnNumber} | int. |
Query param | ?q=... | String. |
Query param | ?limit=... | Integer. |
Query param | ?includeBaselined=... | boolean. |
Query param | ?includeArchived=... | boolean. |
Query param | ?withJira=... | boolean. |
Query param | ?crossSpace=... | boolean. |
Query param | ?matrixType=... | String. |
Body |
{ // Object of type TraceabilityResource.TraceabilityUIRenderRequest
traceabilityMatrixColumns: String,
offsetJson: String,
variables: { // Object of type java.util.Map<java.lang.String,java.lang.Object>
},
}
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Get the list of custom fields in the Jira instance.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Path param | {applink} | String. |
Query param | ?fields=... | String. |
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
This method is going to be slow, or cache a lot of data, if there are a lot of requirements in the space.Type | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the space key |
Query param | ?refresh=... | boolean. |
Returns | HTTP Response. the list |
@Internal Private resource. It will change often and it is not entirely documented.
Create a requirement/several requirements with the details provided in ReplacementRequest, thenType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. the space key |
Body |
the details of the replacement
{ // Object of type ReplacementRequest
reqKey: String, // The requirement key to create
description: String, // The description
sourceCeoId: Long, // The source page, where all requirements with this key must be replaced
applyToAllSimilarOccurrences: boolean,
applyToAllSpace: boolean,
defineInline: boolean, // If defineInline, then sourceCeoId is present.
defineInlineAsALink: boolean, // If defineInlineAsALink, then sourceCeoId is present.
typeName: String, // The type
formatting: String, // The formatting. Only applies if the table is created.
pattern: String, // The pattern. Only applies if applyToAllSimilarOccurrences.
targetCeoId: Long, // The page where keys for this type are stored
}
|
|
Returns | HTTP Response. |
@Internal Private resource. It will change often and it is not entirely documented.
Not publicType | Name | Description |
---|---|---|
Path param | {spaceKey} | String. |
Body |
{ // Object of type TypeResourceCreationRequest
reqKey: String,
typeName: String,
ceoId: Long,
description: String,
formatting: String,
}
|
|
Returns | HTTP Response. |
Rest resource for macros uninstallation.
@Internal Private resource. It will change often and it is not entirely documented.
@Internal Private resource. It will change often and it is not entirely documented.
Uninstalls RY requirement macros from a page.Type | Name | Description |
---|---|---|
Path param | {pageId} | Long. |
Returns | HTTP Response. |