You can create/read/update/delete metadata value via UI or the following Rest API
Version 1.0
internal: removes defect project metadata entries from audit log
 Details
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | Request was processed and there are more details within the server log |
|
403 | User has no Admin permission |
|
experimental: should only be used in exceptional cases. Disables the metadata event sub system (auditlog, indexing)
 Details
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | Request was processed and there are more details within the server log |
|
403 | User has no Admin permission |
|
experimental: should only be used in exceptional cases. Enables the metadata event sub system (auditlog, indexing)
 Details
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | Request was processed and there are more details within the server log |
|
403 | User has no Admin permission |
|
get metadata values for a given object (e.g. version/component) as object array (not unlimited since 4.2)
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
includeHidden | query | no | will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values |
| >boolean |
---|
startAt | query | no | the index of the first metadata value to return (0-based) |
| >integer (int32) |
---|
maxResults | query | no | 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. |
| >integer (int32) |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
create / update metadata as object array
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
JiraMetadata | body | yes | the to change metadata object array |
| Array[ JiraMetadata ] |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
400 | the specified version/component can't be loaded |
|
403 | User has no permission to create / update metadata |
|
503 | Invalid license |
|
get the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
create / update one metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | 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 | User has no permission to create / update metadata |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
delete the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
400 | the specified version/component can't be loaded |
|
403 | User has no permission to create / update metadata |
|
404 | there is no metadata object with the given key |
|
503 | Invalid license |
|
get the specified metadata value
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** text/plain
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation |
|
experimental: the given (valid) project field will be updated
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
MetadataField | body | yes | the to change metadata field |
|
|
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
400 | the given json is invalid |
|
403 | User has no Jira Admin permission |
|
experimental: get all project fields
 Details
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
experimental: get all project fields with related screens (used within admin interface)
 Details
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
experimental: the specified project field will be deleted
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the field identifier |
| >string |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
403 | User has no Jira Admin permission |
|
500 | Error when deleting |
|
experimental: returns the project configuration for the specified project
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectKey | path | yes |
|
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | ProjectConfiguration |
experimental: applies the project screen to the specified project
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectKey | path | yes | the project key |
| >string |
---|
screenKey | path | yes | the screen key |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
403 | User has no Project Admin permission |
|
experimental: get the default customer screen
 Details
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
experimental: the specified user screen becomes the default customer screen
 Details
Name | Located in | Required | Description | Default | Schema |
---|
MetadataScreen | body | yes | the to change metadata screen |
|
|
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
400 | the given json is invalid |
|
403 | User has no Jira Admin permission |
|
experimental: the given (valid) project screen will be updated
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
MetadataScreen | body | yes | the to change metadata screen |
|
|
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
400 | the given json is invalid |
|
403 | User has no Jira Admin permission |
|
experimental: get all project screens
 Details
Name | Located in | Required | Description | Default | Schema |
---|
excludeFieldInformation | query | no | will return the screen without additional field information |
| >boolean |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
experimental: get the default project screen
 Details
Name | Located in | Required | Description | Default | Schema |
---|
excludeFieldInformation | query | no | will return the screen without additional field information |
| >boolean |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
experimental: the specified project screen becomes the default project screen
 Details
Name | Located in | Required | Description | Default | Schema |
---|
MetadataScreen | body | yes | the to change metadata screen |
|
|
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
400 | the given json is invalid |
|
403 | User has no Jira Admin permission |
|
experimental: the specified project screen will be deleted
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the screen identifier |
| >string |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
403 | User has no Jira Admin permission |
|
500 | Error when deleting |
|
experimental: get the default user screen
 Details
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
experimental: the specified user screen becomes the default user screen
 Details
Name | Located in | Required | Description | Default | Schema |
---|
MetadataScreen | body | yes | the to change metadata screen |
|
|
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
400 | the given json is invalid |
|
403 | User has no Jira Admin permission |
|
get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
includeHidden | query | no | will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values |
| >boolean |
---|
startAt | query | no | the index of the first metadata value to return (0-based) |
| >integer (int32) |
---|
maxResults | query | no | 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. |
| >integer (int32) |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
create / update metadata as object array
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
JiraMetadata | body | yes | the to change metadata object array |
| Array[ JiraMetadata ] |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
403 | User has no permission to create / update metadata |
|
503 | Invalid license |
|
get the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
create / update one metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata |
|
403 | User has no permission to create / update metadata |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
delete the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no permission to create / update metadata |
|
404 | there is no metadata object with the given key |
|
503 | Invalid license |
|
get the specified metadata value
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** text/plain
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation |
|
get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
includeHidden | query | no | will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values |
| >boolean |
---|
startAt | query | no | the index of the first metadata value to return (0-based) |
| >integer (int32) |
---|
maxResults | query | no | 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. |
| >integer (int32) |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
create / update metadata as object array
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
JiraMetadata | body | yes | the to change metadata object array |
| Array[ JiraMetadata ] |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
403 | User has no permission to create / update metadata |
|
503 | Invalid license |
|
get the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
create / update one metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata |
|
403 | User has no permission to create / update metadata |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
delete the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no permission to create / update metadata |
|
404 | there is no metadata object with the given key |
|
503 | Invalid license |
|
get the specified metadata value
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** text/plain
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation |
|
experimental: the given (valid) project screen will be updated
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
filter | body | yes | the to change filter |
|
|
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
400 | the given json is invalid |
|
experimental: get all filter for the current user
 Details
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no application use permission |
|
510 | No License provided |
|
experimental: the specified project screen will be deleted
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the filter identifier |
| >integer (int32) |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Message |
500 | Error when deleting |
|
experimental: starts the reindex for all projects
 Details
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | full reindex started, consult server logs for details |
|
400 | the projects can't be indexed |
|
403 | User has no Jira Admin permission |
|
experimental: reindex the specified project
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes |
|
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | the specified project has been indexed. |
|
400 | the project can't be indexed |
|
403 | User has no Project Admin or Jira Admin permission |
|
POST
experimental: search for projects with the specified metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
searchParams | body | yes | the users search params |
| SearchParams |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | returns the search results | SearchResult |
experimental: returns the customer screen (with it's metadata values for the specfied user
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the user identifier |
| >string |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
500 | the user defined by identifier is not the current user |
|
experimental: create / update the specified metadata as non hidden metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata |
|
403 | User (found by the user identifier) is not the calling user or the metadata is not part of the customer screen |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
experimental: returns the customer screen (with it's metadata values for the specfied user
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectKey | path | yes | the service desk project key |
| >string |
---|
identifier | path | yes | the user identifier |
| >string |
---|
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
500 | current user is not an agent for the specified project or the project can't be found |
|
experimental: create / update the specified metadata as non hidden metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
projectKey | path | yes | the service desk project key |
| >string |
---|
identifier | path | yes | the user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata |
|
403 | The calling user is not in the Agent role or the metadata is not part of the customer screen |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
includeHidden | query | no | will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values |
| >boolean |
---|
startAt | query | no | the index of the first metadata value to return (0-based) |
| >integer (int32) |
---|
maxResults | query | no | 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. |
| >integer (int32) |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
create / update metadata as object array
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
JiraMetadata | body | yes | the to change metadata object array |
| Array[ JiraMetadata ] |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
403 | User has no permission to create / update metadata |
|
503 | Invalid license |
|
get the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
create / update one metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | the given key doesn't match to the key of the JiraMetadata object or something went wrong while loading the saved metadata |
|
403 | User has no permission to create / update metadata |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
delete the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
403 | User has no permission to create / update metadata |
|
404 | there is no metadata object with the given key |
|
503 | Invalid license |
|
get the specified metadata value
 Details
Name | Located in | Required | Description | Default | Schema |
---|
identifier | path | yes | the project/group/user identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** text/plain
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation |
|
get metadata values for a given object (e.g. version/component) as object array (not unlimited since 4.2)
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
includeHidden | query | no | will include the hidden metadata values, if the user has the permission to edit (create/update) metadata values |
| >boolean |
---|
startAt | query | no | the index of the first metadata value to return (0-based) |
| >integer (int32) |
---|
maxResults | query | no | 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. |
| >integer (int32) |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
create / update metadata as object array
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
JiraMetadata | body | yes | the to change metadata object array |
| Array[ JiraMetadata ] |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | Array[ JiraMetadata ] |
400 | the specified version/component can't be loaded |
|
403 | User has no permission to create / update metadata |
|
503 | Invalid license |
|
get the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
create / update one metadata
 Details
**Content-Type: ** application/json
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
JiraMetadata | body | yes | the to change metadata |
| JiraMetadata |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation | JiraMetadata |
400 | 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 | User has no permission to create / update metadata |
|
500 | something went wrong while saving the metadata |
|
503 | Invalid license |
|
delete the specified metadata
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** application/json
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
400 | the specified version/component can't be loaded |
|
403 | User has no permission to create / update metadata |
|
404 | there is no metadata object with the given key |
|
503 | Invalid license |
|
get the specified metadata value
 Details
Name | Located in | Required | Description | Default | Schema |
---|
projectkey | path | yes | the project key |
| >string |
---|
identifier | path | yes | the version/component identifier |
| >string |
---|
key | path | yes | the user-defined key of the metadata |
| >string |
---|
**Content-Type: ** text/plain
Status Code | Reason | Response Model |
------------- | ------------- | ---------------- |
200 | successful operation |
|
name | type | required | description | example |
---|
key | string | required | the userdefined key of the metadata |
|
group | string | optional |
|
|
value | string | optional |
|
|
hidden | boolean | optional |
|
|
name | type | required | description | example |
---|
message | string | optional | status message for the call (e.g. ok) |
|
name | type | required | description | example |
---|
editPermission | boolean | optional | will be true to indicate that the user has edit permission |
|
selectionItems | array[ #/definitions/SelectionItem ] | optional | list of selectable items (e.g. Project, Component, Version) |
|
screen | string | optional | the selected project screen |
|
name | type | required | description | example |
---|
start | integer (int32) | optional | the user defined start (last start + limit) |
|
limit | integer (int32) | optional | the user defined limit (must be lower than 50 and higher than 25) |
|
returnAllFields | boolean | optional | default is false, so only the specified fields will be returned |
|
projectSearchValues | arraystring | optional | project (key, name) releated search params |
|
searchValues | object | optional | metadata releated search params |
|
name | type | required | description | example |
---|
project | object | optional | project related values (e.g. projectId, projectKey) |
|
metadata | object | optional | the metadata as key value pairs |
|
name | type | required | description | example |
---|
label | string | optional | the label (e.g. Project, Component, Version, 1.0) |
|
value | string | optional | the value (e.g. project, component, version, 1.0) |
|
projectKey | string | optional | the project key |
|
items | array[ #/definitions/SelectionItem ] | optional | list of selectable sub items (e.g. Version: 1.2, 1.3. 2.0) |
|