You can create/read/update/delete metadata value via UI or the following Rest API
Version 1.0

APIs

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

/admin/cleanupProjectAuditLog

GET

internal: removes defect project metadata entries from audit log

Details

Request

Parameters

Response

**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

/admin/copyAssigneeMetadata

GET

limited use-cases: admins can copy assignee metadata values to issue fields

Details

Request

Parameters

Name	Located in	Required	Schema
metadataKey	query	no	>string
fieldId	query	no	>string
jql	query	no	>string
max	query	no	>integer (int32)

Response

**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

/admin/copyProjectMetadata

GET

limited use-cases: admins can copy project metadata values to issue fields

Details

Request

Parameters

Name	Located in	Required	Schema
metadataKey	query	no	>string
fieldId	query	no	>string
jql	query	no	>string
max	query	no	>integer (int32)

Response

**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

/admin/copyReporterMetadata

GET

limited use-cases: admins can copy reporter metadata values to issue fields

Details

Request

Parameters

Name	Located in	Required	Schema
metadataKey	query	no	>string
fieldId	query	no	>string
jql	query	no	>string
max	query	no	>integer (int32)

Response

**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

/admin/disableMetadataEventSubSystem

GET

experimental: should only be used in exceptional cases. Disables the metadata event sub system (auditlog, indexing)

Details

Request

Parameters

Response

**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

/admin/enableMetadataEventSubSystem

GET

experimental: should only be used in exceptional cases. Enables the metadata event sub system (auditlog, indexing)

Details

Request

Parameters

Response

**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

/component/{projectkey}/{identifier}

GET

get metadata values for a given object (e.g. version/component) as object array (not unlimited since 4.2)

Details

Request

Parameters

Name	Located in	Required	Description	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)

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Array[ JiraMetadata ]

PUT

create / update metadata as object array

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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 ]

Response

**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

/component/{projectkey}/{identifier}/{key}

GET

get the specified metadata

Details

Request

Parameters

Name	Located in	Required	Description	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

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	JiraMetadata

PUT

create / update one metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

delete the specified metadata

Details

Request

Parameters

Name	Located in	Required	Description	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

Response

**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

/component/{projectkey}/{identifier}/{key}/value

GET

get the specified metadata value

Details

Request

Parameters

Name	Located in	Required	Description	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

Response

**Content-Type: ** text/plain

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation

/configuration/field/project

PUT

experimental: the given (valid) project field will be updated

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataField	body	yes	the to change metadata field

Response

**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

DELETE

experimental: the specified project field will be deleted

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataField	body	yes	the to delete metadata field

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
403	User has no Jira Admin permission
500	Error while deleting

/configuration/field/project/all

GET

experimental: get all project fields

Details

Request

Parameters

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/field/project/allEnriched

GET

experimental: get all project fields with related screens (used within admin interface)

Details

Request

Parameters

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/field/user

PUT

experimental: the given (valid) user field will be updated

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataField	body	yes	the to change metadata field

Response

**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

DELETE

experimental: the specified user field will be deleted

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataField	body	yes	the to delete metadata field

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
403	User has no Jira Admin permission
500	Error while deleting

/configuration/field/user/all

GET

experimental: get all user fields

Details

Request

Parameters

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/field/user/allEnriched

GET

experimental: get all project fields with related screens (used within admin interface)

Details

Request

Parameters

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/project/{projectKey}

GET

experimental: returns the project configuration for the specified project

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
projectKey	path	yes			>string

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	ProjectConfiguration

/configuration/project/{projectKey}/screen/{screenKey}

GET

experimental: applies the project screen to the specified project

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
projectKey	path	yes	the project key		>string
screenKey	path	yes	the screen key		>string

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
403	User has no Project Admin permission

/configuration/screen/enrichedproject

PUT

experimental: the given (valid) project screen will be updated and unknown project fields will be created

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataScreen	body	yes	the to change metadata screen with additional field information

Response

**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

/configuration/screen/project

PUT

experimental: the given (valid) project screen will be updated

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataScreen	body	yes	the to change metadata screen

Response

**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

/configuration/screen/project/all

GET

experimental: get all project screens

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
excludeFieldInformation	query	no	will return the screen without additional field information		>boolean

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/screen/project/default

GET

experimental: get the default project screen

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
excludeFieldInformation	query	no	will return the screen without additional field information		>boolean

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

PUT

experimental: the specified project screen becomes the default project screen

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataScreen	body	yes	the to change metadata screen

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
400	the given json is invalid
403	User has no Jira Admin permission

/configuration/screen/project/{identifier}

DELETE

experimental: the specified project screen will be deleted

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
identifier	path	yes	the screen identifier		>string

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
403	User has no Jira Admin permission
500	Error when deleting

/configuration/screen/user

PUT

experimental: the given (valid) user screen will be updated

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
MetadataScreen	body	yes	the to change metadata screen

Response

**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

/configuration/screen/user/all

GET

experimental: get all user screens

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
excludeFieldInformation	query	no	will return the screen without additional field information		>boolean

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/screen/user/default

GET

experimental: get the default user screen

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
excludeFieldInformation	query	no	will return the screen without additional field information		>boolean

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/configuration/screen/user/profile

GET

experimental: get the default user profile screen

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
excludeFieldInformation	query	no	will return the screen without additional field information		>boolean

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission

/group/{identifier}

GET

get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)

Details

Request

Parameters

Name	Located in	Required	Description	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)

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Array[ JiraMetadata ]

PUT

create / update metadata as object array

Details

Request

**Content-Type: ** application/json

Parameters

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 ]

Response

**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

/group/{identifier}/{key}

GET

get the specified metadata

Details

Request

Parameters

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

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	JiraMetadata

PUT

create / update one metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

delete the specified metadata

Details

Request

Parameters

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

Response

**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

/group/{identifier}/{key}/value

GET

get the specified metadata value

Details

Request

Parameters

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

Response

**Content-Type: ** text/plain

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation

/project/{identifier}

GET

get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)

Details

Request

Parameters

Name	Located in	Required	Description	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)

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Array[ JiraMetadata ]

PUT

create / update metadata as object array

Details

Request

**Content-Type: ** application/json

Parameters

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 ]

Response

**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

/project/{identifier}/{key}

GET

get the specified metadata

Details

Request

Parameters

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

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	JiraMetadata

PUT

create / update one metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

delete the specified metadata

Details

Request

Parameters

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

Response

**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

/project/{identifier}/{key}/value

GET

get the specified metadata value

Details

Request

Parameters

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

Response

**Content-Type: ** text/plain

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation

/projects/filter

PUT

experimental: the given (valid) project screen will be updated

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
filter	body	yes	the to change filter

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
400	the given json is invalid

/projects/filter/all

GET

experimental: get all filter for the current user

Details

Request

Parameters

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission
510	No License provided

/projects/filter/{identifier}

DELETE

experimental: the specified project screen will be deleted

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
identifier	path	yes	the filter identifier		>integer (int32)

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
500	Error when deleting

/projects/fullReindex

GET

experimental: starts the reindex for all projects

Details

Request

Parameters

Response

**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

/projects/index/{identifier}

GET

experimental: reindex the specified project

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
identifier	path	yes			>string

Response

**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

/projects/search

POST

experimental: search for projects with the specified metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
searchParams	body	yes	the users search params		SearchParams

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	returns the search results	SearchResult

/servicedesk/customer/profile/{identifier}

GET

experimental: returns the customer screen (with it's metadata values for the specfied user

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
identifier	path	yes	the user identifier		>string

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
500	the user defined by identifier is not the current user

/servicedesk/customer/profile/{identifier}/{key}

PUT

experimental: create / update the specified metadata as non hidden metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

/servicedesk/{projectKey}/agent/ascustomer/profile/{identifier}

GET

experimental: returns the customer screen (with it's metadata values for the specified user, like the call was done by the customer

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
projectKey	path	yes	the service desk project key		>string
identifier	path	yes	the user identifier		>string

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
500	current user is not an agent for the specified project or the project can't be found

/servicedesk/{projectKey}/agent/customer/profile/{identifier}

GET

experimental: returns the customer screen (with it's metadata values for the specified user

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
projectKey	path	yes	the service desk project key		>string
identifier	path	yes	the user identifier		>string

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
500	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

experimental: create / update the specified metadata as non hidden metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

/user/{identifier}

GET

get metadata values for a given object (e.g. project/group/user) as object array (not unlimited since 4.2)

Details

Request

Parameters

Name	Located in	Required	Description	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)

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Array[ JiraMetadata ]

PUT

create / update metadata as object array

Details

Request

**Content-Type: ** application/json

Parameters

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 ]

Response

**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

/user/{identifier}/{key}

GET

get the specified metadata

Details

Request

Parameters

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

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	JiraMetadata

PUT

create / update one metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

delete the specified metadata

Details

Request

Parameters

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

Response

**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

/user/{identifier}/{key}/value

GET

get the specified metadata value

Details

Request

Parameters

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

Response

**Content-Type: ** text/plain

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation

/users/filter

PUT

experimental: the given (valid) filter will be updated

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
filter	body	yes	the to change filter

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
400	the given json is invalid

/users/filter/all

GET

experimental: get all filter for the current user

Details

Request

Parameters

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
403	User has no application use permission
510	No License provided

/users/filter/{identifier}

DELETE

experimental: the specified filter will be deleted

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
identifier	path	yes	the filter identifier		>integer (int32)

Response

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Message
500	Error when deleting

/users/fullReindex

GET

experimental: starts the reindex for all user

Details

Request

Parameters

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	full reindex started, consult server logs for details
400	all user can't be indexed
403	User has no Jira Admin permission

/users/index/{userName}

GET

experimental: reindex the specified user

Details

Request

Parameters

Name	Located in	Required	Description	Default	Schema
userName	path	yes			>string

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	the specified user has been indexed.
400	the user can't be indexed
403	User has no User Admin or Jira Admin permission

/users/search

POST

experimental: search for user with the specified metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	Default	Schema
searchParams	body	yes	the users search params		SearchParams

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	returns the search results	SearchResult

/version/{projectkey}/{identifier}

GET

get metadata values for a given object (e.g. version/component) as object array (not unlimited since 4.2)

Details

Request

Parameters

Name	Located in	Required	Description	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)

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	Array[ JiraMetadata ]

PUT

create / update metadata as object array

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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 ]

Response

**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

/version/{projectkey}/{identifier}/{key}

GET

get the specified metadata

Details

Request

Parameters

Name	Located in	Required	Description	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

Response

**Content-Type: ** application/json

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation	JiraMetadata

PUT

create / update one metadata

Details

Request

**Content-Type: ** application/json

Parameters

Name	Located in	Required	Description	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

Response

**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

delete the specified metadata

Details

Request

Parameters

Name	Located in	Required	Description	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

Response

**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

/version/{projectkey}/{identifier}/{key}/value

GET

get the specified metadata value

Details

Request

Parameters

Name	Located in	Required	Description	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

Response

**Content-Type: ** text/plain

Status Code	Reason	Response Model
-------------	-------------	----------------
200	successful operation

Json-Objects

JiraMetadata

name	type	required	description
key	string	required	the userdefined key of the metadata
group	string	optional
value	string	optional
hidden	boolean	optional

Message

name	type	required	description	example
message	string	optional	status message for the call (e.g. ok)

ProjectConfiguration

name	type	required	description
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

SearchParams

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)	25
returnAllFields	boolean	optional	default is false, so only the specified fields will be returned
project	arraystring	optional	project (key, name) releated search params
fields	object	optional	metadata releated search params

SearchResult

name	type	required	description
searchParams	#/definitions/SearchParams	optional	the used search params
moreResultsAvailable	boolean	optional	indicates that even more values could be returned
results	array[ #/definitions/SearchResultProjectItem ]	optional	the search result

SearchResultProjectItem

name	type	required	description	example
project	object	optional	project related values (e.g. projectId, projectKey)
metadata	object	optional	the metadata as key value pairs

SearchResultUserItem

name	type	required	description	example
user	object	optional	user related values (e.g. userId, username)
metadata	object	optional	the metadata as key value pairs

SelectionItem

name	type	required	description
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)

Rest API - Metadata for Jira 5.2 pre-rendered

APIs

/admin/cleanupProjectAuditLog

GET

Request

Parameters

Response

/admin/copyAssigneeMetadata

GET

Request

Parameters

Response

/admin/copyProjectMetadata

GET

Request

Parameters

Response

/admin/copyReporterMetadata

GET

Request

Parameters

Response

/admin/disableMetadataEventSubSystem

GET

Request

Parameters

Response

/admin/enableMetadataEventSubSystem

GET

Request

Parameters

Response

/component/{projectkey}/{identifier}

GET

Request

Parameters

Response

PUT

Request

Parameters

Response

/component/{projectkey}/{identifier}/{key}

GET

Request

Parameters

Response

PUT

Request

Parameters

Response

DELETE

Request

Parameters

Response

/component/{projectkey}/{identifier}/{key}/value

GET

Request

Parameters

Response

/configuration/field/project

PUT

Request

Parameters

Response

DELETE

Request

Parameters

Response

/configuration/field/project/all

GET

Request

Parameters

Response

/configuration/field/project/allEnriched

GET

Request

Parameters

Response

/configuration/field/user

PUT