GET /rest/api/2/app/field/{fieldIdOrKey}/context/configuration

Returns a paginated list of configurations for a custom field of a type created by a Forge app.

The result can be filtered by one of these criteria:

Otherwise, all configurations are returned.

Permissions required: Administer Jira global permission. Jira permissions are not required for the Forge app that provided the custom field type.

Servers

Path parameters

Name Type Required Description
fieldIdOrKey String Yes

The ID or key of the custom field, for example customfield_10000.

Query parameters

Name Type Required Description
id[] Array No

The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: id=10000&id=10001. Can't be provided with fieldContextId, issueId, projectKeyOrId, or issueTypeId.

startAt Integer No

The index of the first item to return in a page of results (page offset).

Default value: 0

maxResults Integer No

The maximum number of items to return per page.

Default value: 100

fieldContextId[] Array No

The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: fieldContextId=10000&fieldContextId=10001. Can't be provided with id, issueId, projectKeyOrId, or issueTypeId.

projectKeyOrId String No

The ID or key of the project to filter results by. Must be provided with issueTypeId. Can't be provided with issueId.

issueId Integer No

The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with projectKeyOrId, or issueTypeId.

issueTypeId String No

The ID of the issue type to filter results by. Must be provided with projectKeyOrId. Can't be provided with issueId.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.