Info |
---|
Base path for the Rest API: Jira_Base_Url/rest/metadata/1.0 e.g. get the first 20 metadata for project JM (as project-admin): https://jira.atlassian.internal/rest/metadata/1.0/project/JM?includeHidden=true&startAt=0&maxResults=20 |
Swagger open api macro |
---|
{
"swagger" : "2.0",
"info" : {
"description" : "You can create/read/update/delete metadata value via UI or the following Rest API",
"version" : "1.0",
"title" : "Metadata for Jira Rest API",
"contact" : {
"name" : "evolu software GmbH",
"url" : "http://evolu.software/"
}
},
"host" : "your_jira_base_url",
"basePath" : "/rest/metadata/1.0",
"tags" : [ {
"name" : "admin",
"description" : "Metadata admin services"
}, {
"name" : "component",
"description" : "project component metadata resource"
}, {
"name" : "configurationfield",
"description" : "metadata field configuration resource"
}, {
"name" : "configurationproject",
"description" : "project configuration metadata resource"
}, {
"name" : "configurationscreen",
"description" : "metadata screen configuration resource"
}, {
"name" : "group",
"description" : "group metadata resource"
}, {
"name" : "project",
"description" : "project metadata resource"
}, {
"name" : "projects",
"description" : "project overview metadata resource"
}, {
"name" : "servicedesk",
"description" : "service desk related metadata screen resource"
}, {
"name" : "user",
"description" : "user metadata resource"
}, {
"name" : "version",
"description" : "project version metadata resource"
} ],
"schemes" : [ "http", "https" ],
"paths" : {
"/admin/cleanupProjectAuditLog" : {
"get" : {
"tags" : [ "admin" ],
"summary" : "internal: removes defect project metadata entries from audit log",
"description" : "",
"operationId" : "auditlogProblems",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "Request was processed and there are more details within the server log"
},
"403" : {
"description" : "User has no Admin permission"
}
}
}
},
"/admin/disableMetadataEventSubSystem" : {
"get" : {
"tags" : [ "admin" ],
"summary" : "experimental: should only be used in exceptional cases. Disables the metadata event sub system (auditlog, indexing)",
"description" : "",
"operationId" : "disableMetadataEventSubSystem",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "Request was processed and there are more details within the server log"
},
"403" : {
"description" : "User has no Admin permission"
}
}
}
},
"/admin/enableMetadataEventSubSystem" : {
"get" : {
"tags" : [ "admin" ],
"summary" : "experimental: should only be used in exceptional cases. Enables the metadata event sub system (auditlog, indexing)",
"description" : "",
"operationId" : "enableMetadataEventSubSystem",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "Request was processed and there are more details within the server log"
},
"403" : {
"description" : "User has no Admin permission"
}
}
}
},
"/component/{projectkey}/{identifier}" : {
"get" : {
"tags" : [ "component" ],
"summary" : "get metadata values for a given object (e.g. version/component) as object array (not unlimited since 4.2)",
"description" : "",
"operationId" : "getAllMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "includeHidden",
"in" : "query",
"description" : "will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values",
"required" : false,
"type" : "boolean",
"default" : false
}, {
"name" : "startAt",
"in" : "query",
"description" : "the index of the first metadata value to return (0-based)",
"required" : false,
"type" : "integer",
"default" : 0,
"format" : "int32"
}, {
"name" : "maxResults",
"in" : "query",
"description" : "the maximum number of metadata values to return (defaults to 100 (if startAt >= 1)). The maximum allowable value is dictated to 500. If you specify a value that is higher than this number, your search results will be truncated.",
"required" : false,
"type" : "integer",
"default" : 100,
"format" : "int32"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
}
},
"put" : {
"tags" : [ "component" ],
"summary" : "create / update metadata as object array",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata object array",
"required" : true,
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
},
"400" : {
"description" : "the specified version/component can't be loaded"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/component/{projectkey}/{identifier}/{key}" : {
"get" : {
"tags" : [ "component" ],
"summary" : "get the specified metadata",
"description" : "",
"operationId" : "getMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
},
"put" : {
"tags" : [ "component" ],
"summary" : "create / update one metadata",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object, the specified version/component can't be loaded or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
},
"delete" : {
"tags" : [ "component" ],
"summary" : "delete the specified metadata",
"description" : "",
"operationId" : "deleteMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"400" : {
"description" : "the specified version/component can't be loaded"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"404" : {
"description" : "there is no metadata object with the given key"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/component/{projectkey}/{identifier}/{key}/value" : {
"get" : {
"tags" : [ "component" ],
"summary" : "get the specified metadata value",
"description" : "",
"operationId" : "getMetadataValue",
"produces" : [ "text/plain" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "string"
}
}
}
}
},
"/configuration/field/project" : {
"put" : {
"tags" : [ "configurationfield" ],
"summary" : "experimental: the given (valid) project field will be updated",
"description" : "",
"operationId" : "updateFieldProject",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"in" : "body",
"name" : "MetadataField",
"description" : "the to change metadata field",
"required" : true,
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"400" : {
"description" : "the given json is invalid"
},
"403" : {
"description" : "User has no Jira Admin permission"
}
}
}
},
"/configuration/field/project/all" : {
"get" : {
"tags" : [ "configurationfield" ],
"summary" : "experimental: get all project fields",
"description" : "",
"operationId" : "getFieldProjects",
"responses" : {
"403" : {
"description" : "User has no application use permission"
}
}
}
},
"/configuration/field/project/allEnriched" : {
"get" : {
"tags" : [ "configurationfield" ],
"summary" : "experimental: get all project fields with related screens (used within admin interface)",
"description" : "",
"operationId" : "getEnrichtedFieldProjects",
"responses" : {
"403" : {
"description" : "User has no application use permission"
}
}
}
},
"/configuration/field/project/{identifier}" : {
"delete" : {
"tags" : [ "configurationfield" ],
"summary" : "experimental: the specified project field will be deleted",
"description" : "",
"operationId" : "deleteFieldProject",
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the field identifier",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"403" : {
"description" : "User has no Jira Admin permission"
},
"500" : {
"description" : "Error when deleting"
}
}
}
},
"/configuration/project/{projectKey}" : {
"get" : {
"tags" : [ "configurationproject" ],
"summary" : "experimental: returns the project configuration for the specified project",
"description" : "",
"operationId" : "getProjectConfiguration",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectKey",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/ProjectConfiguration"
}
}
}
}
},
"/configuration/project/{projectKey}/screen/{screenKey}" : {
"get" : {
"tags" : [ "configurationproject" ],
"summary" : "experimental: applies the project screen to the specified project",
"description" : "",
"operationId" : "setProjectScreen",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectKey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "screenKey",
"in" : "path",
"description" : "the screen key",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"403" : {
"description" : "User has no Project Admin permission"
}
}
}
},
"/configuration/screen/customer/default" : {
"get" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: get the default customer screen",
"description" : "",
"operationId" : "getCustomerScreenDefault",
"responses" : {
"403" : {
"description" : "User has no application use permission"
}
}
},
"put" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: the specified user screen becomes the default customer screen",
"description" : "",
"operationId" : "updateCustomerScreenDefault",
"parameters" : [ {
"in" : "body",
"name" : "MetadataScreen",
"description" : "the to change metadata screen",
"required" : true,
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"400" : {
"description" : "the given json is invalid"
},
"403" : {
"description" : "User has no Jira Admin permission"
}
}
}
},
"/configuration/screen/project" : {
"put" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: the given (valid) project screen will be updated",
"description" : "",
"operationId" : "updateProjectScreen",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"in" : "body",
"name" : "MetadataScreen",
"description" : "the to change metadata screen",
"required" : true,
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"400" : {
"description" : "the given json is invalid"
},
"403" : {
"description" : "User has no Jira Admin permission"
}
}
}
},
"/configuration/screen/project/all" : {
"get" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: get all project screens",
"description" : "",
"operationId" : "getProjectScreens",
"parameters" : [ {
"name" : "excludeFieldInformation",
"in" : "query",
"description" : "will return the screen without additional field information",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "User has no application use permission"
}
}
}
},
"/configuration/screen/project/default" : {
"get" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: get the default project screen",
"description" : "",
"operationId" : "getProjectScreenDefault",
"parameters" : [ {
"name" : "excludeFieldInformation",
"in" : "query",
"description" : "will return the screen without additional field information",
"required" : false,
"type" : "boolean",
"default" : false
} ],
"responses" : {
"403" : {
"description" : "User has no application use permission"
}
}
},
"put" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: the specified project screen becomes the default project screen",
"description" : "",
"operationId" : "updateProjectScreenDefault",
"parameters" : [ {
"in" : "body",
"name" : "MetadataScreen",
"description" : "the to change metadata screen",
"required" : true,
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"400" : {
"description" : "the given json is invalid"
},
"403" : {
"description" : "User has no Jira Admin permission"
}
}
}
},
"/configuration/screen/project/{identifier}" : {
"delete" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: the specified project screen will be deleted",
"description" : "",
"operationId" : "deleteProjectScreen",
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the screen identifier",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"403" : {
"description" : "User has no Jira Admin permission"
},
"500" : {
"description" : "Error when deleting"
}
}
}
},
"/configuration/screen/user/default" : {
"get" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: get the default user screen",
"description" : "",
"operationId" : "getUserScreenDefault",
"responses" : {
"403" : {
"description" : "User has no application use permission"
}
}
},
"put" : {
"tags" : [ "configurationscreen" ],
"summary" : "experimental: the specified user screen becomes the default user screen",
"description" : "",
"operationId" : "updateUserScreenDefault",
"parameters" : [ {
"in" : "body",
"name" : "MetadataScreen",
"description" : "the to change metadata screen",
"required" : true,
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"400" : {
"description" : "the given json is invalid"
},
"403" : {
"description" : "User has no Jira Admin permission"
}
}
}
},
"/group/{identifier}" : {
"get" : {
"tags" : [ "group" ],
"summary" : "get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)",
"description" : "",
"operationId" : "getAllMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "includeHidden",
"in" : "query",
"description" : "will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values",
"required" : false,
"type" : "boolean",
"default" : false
}, {
"name" : "startAt",
"in" : "query",
"description" : "the index of the first metadata value to return (0-based)",
"required" : false,
"type" : "integer",
"default" : 0,
"format" : "int32"
}, {
"name" : "maxResults",
"in" : "query",
"description" : "the maximum number of metadata values to return (defaults to 100 (if startAt >= 1)). The maximum allowable value is dictated to 500. If you specify a value that is higher than this number, your search results will be truncated.",
"required" : false,
"type" : "integer",
"default" : 100,
"format" : "int32"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
}
},
"put" : {
"tags" : [ "group" ],
"summary" : "create / update metadata as object array",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata object array",
"required" : true,
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/group/{identifier}/{key}" : {
"get" : {
"tags" : [ "group" ],
"summary" : "get the specified metadata",
"description" : "",
"operationId" : "getMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
},
"put" : {
"tags" : [ "group" ],
"summary" : "create / update one metadata",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
},
"delete" : {
"tags" : [ "group" ],
"summary" : "delete the specified metadata",
"description" : "",
"operationId" : "deleteMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "User has no permission to create / update metadata"
},
"404" : {
"description" : "there is no metadata object with the given key"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/group/{identifier}/{key}/value" : {
"get" : {
"tags" : [ "group" ],
"summary" : "get the specified metadata value",
"description" : "",
"operationId" : "getMetadataValue",
"produces" : [ "text/plain" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "string"
}
}
}
}
},
"/project/{identifier}" : {
"get" : {
"tags" : [ "project" ],
"summary" : "get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)",
"description" : "",
"operationId" : "getAllMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "includeHidden",
"in" : "query",
"description" : "will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values",
"required" : false,
"type" : "boolean",
"default" : false
}, {
"name" : "startAt",
"in" : "query",
"description" : "the index of the first metadata value to return (0-based)",
"required" : false,
"type" : "integer",
"default" : 0,
"format" : "int32"
}, {
"name" : "maxResults",
"in" : "query",
"description" : "the maximum number of metadata values to return (defaults to 100 (if startAt >= 1)). The maximum allowable value is dictated to 500. If you specify a value that is higher than this number, your search results will be truncated.",
"required" : false,
"type" : "integer",
"default" : 100,
"format" : "int32"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
}
},
"put" : {
"tags" : [ "project" ],
"summary" : "create / update metadata as object array",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata object array",
"required" : true,
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/project/{identifier}/{key}" : {
"get" : {
"tags" : [ "project" ],
"summary" : "get the specified metadata",
"description" : "",
"operationId" : "getMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
},
"put" : {
"tags" : [ "project" ],
"summary" : "create / update one metadata",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
},
"delete" : {
"tags" : [ "project" ],
"summary" : "delete the specified metadata",
"description" : "",
"operationId" : "deleteMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "User has no permission to create / update metadata"
},
"404" : {
"description" : "there is no metadata object with the given key"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/project/{identifier}/{key}/value" : {
"get" : {
"tags" : [ "project" ],
"summary" : "get the specified metadata value",
"description" : "",
"operationId" : "getMetadataValue",
"produces" : [ "text/plain" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "string"
}
}
}
}
},
"/projects/filter" : {
"put" : {
"tags" : [ "projects" ],
"summary" : "experimental: the given (valid) project screen will be updated",
"description" : "",
"operationId" : "updateFilter",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"in" : "body",
"name" : "filter",
"description" : "the to change filter",
"required" : true,
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"400" : {
"description" : "the given json is invalid"
}
}
}
},
"/projects/filter/all" : {
"get" : {
"tags" : [ "projects" ],
"summary" : "experimental: get all filter for the current user",
"description" : "",
"operationId" : "getAllFilter",
"responses" : {
"403" : {
"description" : "User has no application use permission"
},
"510" : {
"description" : "No License provided"
}
}
}
},
"/projects/filter/{identifier}" : {
"delete" : {
"tags" : [ "projects" ],
"summary" : "experimental: the specified project screen will be deleted",
"description" : "",
"operationId" : "deleteFilter",
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the filter identifier",
"required" : true,
"type" : "integer",
"format" : "int32"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/Message"
}
},
"500" : {
"description" : "Error when deleting"
}
}
}
},
"/projects/fullReindex" : {
"get" : {
"tags" : [ "projects" ],
"summary" : "experimental: starts the reindex for all projects",
"description" : "",
"operationId" : "fullReindex",
"produces" : [ "application/json" ],
"responses" : {
"200" : {
"description" : "full reindex started, consult server logs for details"
},
"400" : {
"description" : "the projects can't be indexed"
},
"403" : {
"description" : "User has no Jira Admin permission"
}
}
}
},
"/projects/index/{identifier}" : {
"get" : {
"tags" : [ "projects" ],
"summary" : "experimental: reindex the specified project",
"description" : "",
"operationId" : "indexProject",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "the specified project has been indexed."
},
"400" : {
"description" : "the project can't be indexed"
},
"403" : {
"description" : "User has no Project Admin or Jira Admin permission"
}
}
}
},
"/projects/search" : {
"post" : {
"tags" : [ "projects" ],
"summary" : "experimental: search for projects with the specified metadata",
"description" : "",
"operationId" : "search",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"in" : "body",
"name" : "searchParams",
"description" : "the users search params",
"required" : true,
"schema" : {
"$ref" : "#/definitions/SearchParams"
}
} ],
"responses" : {
"200" : {
"description" : "returns the search results",
"schema" : {
"$ref" : "#/definitions/SearchResult"
}
}
}
}
},
"/servicedesk/customer/profile/{identifier}" : {
"get" : {
"tags" : [ "servicedesk" ],
"summary" : "experimental: returns the customer screen (with it's metadata values for the specfied user",
"description" : "",
"operationId" : "getCustomerScreen",
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the user identifier",
"required" : true,
"type" : "string"
} ],
"responses" : {
"500" : {
"description" : "the user defined by identifier is not the current user"
}
}
}
},
"/servicedesk/customer/profile/{identifier}/{key}" : {
"put" : {
"tags" : [ "servicedesk" ],
"summary" : "experimental: create / update the specified metadata as non hidden metadata",
"description" : "",
"operationId" : "updateCustomer",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "User (found by the user identifier) is not the calling user or the metadata is not part of the customer screen"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/servicedesk/{projectKey}/agent/customer/profile/{identifier}" : {
"get" : {
"tags" : [ "servicedesk" ],
"summary" : "experimental: returns the customer screen (with it's metadata values for the specfied user",
"description" : "",
"operationId" : "getCustomerScreenAsAgent",
"parameters" : [ {
"name" : "projectKey",
"in" : "path",
"description" : "the service desk project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the user identifier",
"required" : true,
"type" : "string"
} ],
"responses" : {
"500" : {
"description" : "current user is not an agent for the specified project or the project can't be found"
}
}
}
},
"/servicedesk/{projectKey}/agent/customer/profile/{identifier}/{key}" : {
"put" : {
"tags" : [ "servicedesk" ],
"summary" : "experimental: create / update the specified metadata as non hidden metadata",
"description" : "",
"operationId" : "updateCustomerAsAgent",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectKey",
"in" : "path",
"description" : "the service desk project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "The calling user is not in the Agent role or the metadata is not part of the customer screen"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/user/{identifier}" : {
"get" : {
"tags" : [ "user" ],
"summary" : "get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)",
"description" : "",
"operationId" : "getAllMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "includeHidden",
"in" : "query",
"description" : "will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values",
"required" : false,
"type" : "boolean",
"default" : false
}, {
"name" : "startAt",
"in" : "query",
"description" : "the index of the first metadata value to return (0-based)",
"required" : false,
"type" : "integer",
"default" : 0,
"format" : "int32"
}, {
"name" : "maxResults",
"in" : "query",
"description" : "the maximum number of metadata values to return (defaults to 100 (if startAt >= 1)). The maximum allowable value is dictated to 500. If you specify a value that is higher than this number, your search results will be truncated.",
"required" : false,
"type" : "integer",
"default" : 100,
"format" : "int32"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
}
},
"put" : {
"tags" : [ "user" ],
"summary" : "create / update metadata as object array",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata object array",
"required" : true,
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/user/{identifier}/{key}" : {
"get" : {
"tags" : [ "user" ],
"summary" : "get the specified metadata",
"description" : "",
"operationId" : "getMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
},
"put" : {
"tags" : [ "user" ],
"summary" : "create / update one metadata",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
},
"delete" : {
"tags" : [ "user" ],
"summary" : "delete the specified metadata",
"description" : "",
"operationId" : "deleteMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"403" : {
"description" : "User has no permission to create / update metadata"
},
"404" : {
"description" : "there is no metadata object with the given key"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/user/{identifier}/{key}/value" : {
"get" : {
"tags" : [ "user" ],
"summary" : "get the specified metadata value",
"description" : "",
"operationId" : "getMetadataValue",
"produces" : [ "text/plain" ],
"parameters" : [ {
"name" : "identifier",
"in" : "path",
"description" : "the project/group/user identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "string"
}
}
}
}
},
"/version/{projectkey}/{identifier}" : {
"get" : {
"tags" : [ "version" ],
"summary" : "get metadata values for a given object (e.g. version/component) as object array (not unlimited since 4.2)",
"description" : "",
"operationId" : "getAllMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "includeHidden",
"in" : "query",
"description" : "will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values",
"required" : false,
"type" : "boolean",
"default" : false
}, {
"name" : "startAt",
"in" : "query",
"description" : "the index of the first metadata value to return (0-based)",
"required" : false,
"type" : "integer",
"default" : 0,
"format" : "int32"
}, {
"name" : "maxResults",
"in" : "query",
"description" : "the maximum number of metadata values to return (defaults to 100 (if startAt >= 1)). The maximum allowable value is dictated to 500. If you specify a value that is higher than this number, your search results will be truncated.",
"required" : false,
"type" : "integer",
"default" : 100,
"format" : "int32"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
}
},
"put" : {
"tags" : [ "version" ],
"summary" : "create / update metadata as object array",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata object array",
"required" : true,
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
},
"400" : {
"description" : "the specified version/component can't be loaded"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/version/{projectkey}/{identifier}/{key}" : {
"get" : {
"tags" : [ "version" ],
"summary" : "get the specified metadata",
"description" : "",
"operationId" : "getMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
}
}
},
"put" : {
"tags" : [ "version" ],
"summary" : "create / update one metadata",
"description" : "",
"operationId" : "updateMetadata",
"consumes" : [ "application/json" ],
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
}, {
"in" : "body",
"name" : "JiraMetadata",
"description" : "the to change metadata",
"required" : true,
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"$ref" : "#/definitions/JiraMetadata"
}
},
"400" : {
"description" : "the given key doesn't match to the key of the JiraMetadata object, the specified version/component can't be loaded or something went wrong while loading the saved metadata"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"500" : {
"description" : "something went wrong while saving the metadata"
},
"503" : {
"description" : "Invalid license"
}
}
},
"delete" : {
"tags" : [ "version" ],
"summary" : "delete the specified metadata",
"description" : "",
"operationId" : "deleteMetadata",
"produces" : [ "application/json" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"400" : {
"description" : "the specified version/component can't be loaded"
},
"403" : {
"description" : "User has no permission to create / update metadata"
},
"404" : {
"description" : "there is no metadata object with the given key"
},
"503" : {
"description" : "Invalid license"
}
}
}
},
"/version/{projectkey}/{identifier}/{key}/value" : {
"get" : {
"tags" : [ "version" ],
"summary" : "get the specified metadata value",
"description" : "",
"operationId" : "getMetadataValue",
"produces" : [ "text/plain" ],
"parameters" : [ {
"name" : "projectkey",
"in" : "path",
"description" : "the project key",
"required" : true,
"type" : "string"
}, {
"name" : "identifier",
"in" : "path",
"description" : "the version/component identifier",
"required" : true,
"type" : "string"
}, {
"name" : "key",
"in" : "path",
"description" : "the user-defined key of the metadata",
"required" : true,
"type" : "string"
} ],
"responses" : {
"200" : {
"description" : "successful operation",
"schema" : {
"type" : "string"
}
}
}
}
}
},
"definitions" : {
"JiraMetadata" : {
"type" : "object",
"required" : [ "key" ],
"properties" : {
"key" : {
"type" : "string",
"description" : "the userdefined key of the metadata"
},
"group" : {
"type" : "string"
},
"value" : {
"type" : "string"
},
"hidden" : {
"type" : "boolean",
"default" : false
}
},
"xml" : {
"name" : "JiraMetadata"
}
},
"Message" : {
"type" : "object",
"properties" : {
"message" : {
"type" : "string",
"default" : "ok"
}
},
"xml" : {
"name" : "Message"
}
},
"Project" : {
"type" : "object",
"properties" : {
"project" : {
"type" : "object",
"additionalProperties" : {
"type" : "object"
}
},
"metadata" : {
"type" : "object",
"additionalProperties" : {
"type" : "string"
}
}
},
"xml" : {
"name" : "Project"
}
},
"ProjectConfiguration" : {
"type" : "object",
"properties" : {
"editPermission" : {
"type" : "boolean",
"default" : false
},
"selectionItems" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/SelectionItem"
}
},
"screen" : {
"type" : "string"
}
},
"xml" : {
"name" : "ProjectConfiguration"
}
},
"SearchParams" : {
"type" : "object",
"properties" : {
"start" : {
"type" : "integer",
"format" : "int32"
},
"limit" : {
"type" : "integer",
"format" : "int32",
"description" : "the userdefined limit (must be lower than 50 and higher than 25)"
},
"returnAllFields" : {
"type" : "boolean",
"default" : false
},
"projectSearchValues" : {
"type" : "array",
"xml" : {
"name" : "project"
},
"items" : {
"type" : "string"
}
},
"searchValues" : {
"type" : "object",
"xml" : {
"name" : "fields"
},
"additionalProperties" : {
"type" : "array",
"items" : {
"type" : "string"
}
}
}
},
"xml" : {
"name" : "SearchParams"
}
},
"SearchResult" : {
"type" : "object",
"properties" : {
"searchParams" : {
"$ref" : "#/definitions/SearchParams"
},
"moreResultsAvailable" : {
"type" : "boolean",
"default" : false
},
"results" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/Project"
}
}
},
"xml" : {
"name" : "SearchResult"
}
},
"SelectionItem" : {
"type" : "object",
"properties" : {
"label" : {
"type" : "string"
},
"value" : {
"type" : "string"
},
"projectKey" : {
"type" : "string"
},
"items" : {
"type" : "array",
"items" : {
"$ref" : "#/definitions/SelectionItem"
}
}
},
"xml" : {
"name" : "SelectionItem"
}
}
}
} |