Atlassian Issue Custom Field Contexts API

The Issue Custom Field Contexts API from Atlassian — 10 operation(s) for issue custom field contexts.

Documentation GitHub OpenAPI

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/api/3/field/{fieldId}/context List the contexts of a custom field · Atlassian Get Custom Field Contexts #

Ask an LLM

“Which contexts are configured for a particular custom field?”

“Can I list only the global contexts that apply to all projects?”

Tell an agent

List the contexts for custom field {fieldId}.

Show only the global contexts of field {fieldId} ({isGlobalContext}).

POST /rest/api/3/field/{fieldId}/context Create a context for a custom field · Atlassian Create Custom Field Context #

Ask an LLM

“How do I scope a custom field to certain projects and issue types?”

“What happens if I create a field context without any project IDs?”

Tell an agent

Create a context named {name} for custom field {fieldId}.

Add context {name} to field {fieldId} for projects {projectIds} and issue types {issueTypeIds}.

GET /rest/api/3/field/{fieldId}/context/defaultValue Get a custom field's default values per context · Atlassian Get Custom Field Contexts Default Values #

Ask an LLM

“What default value does a custom field fill in for each context?”

“Can I see the default for just one context of a field?”

Tell an agent

Show the default values for custom field {fieldId}.

Get the default value of field {fieldId} in context {contextId}.

PUT /rest/api/3/field/{fieldId}/context/defaultValue Set default values for custom field contexts · Atlassian Set Custom Field Contexts Default Values #

Ask an LLM

“How do I set the default value a custom field gets in new issues?”

“Can I set a date field's default for one of its contexts?”

Tell an agent

Set the defaults for custom field {fieldId} to {defaultValues}.

Update the context default values on field {fieldId} using {defaultValues}.

GET /rest/api/3/field/{fieldId}/context/issuetypemapping List issue types mapped to a field's contexts · Atlassian Get Issue Types For Custom Field Context #

Ask an LLM

“Which issue types does each context of a custom field cover?”

“What issue types are attached to a single field context?”

Tell an agent

Show the issue type mappings for contexts of field {fieldId}.

List issue types attached to context {contextId} of field {fieldId}.

POST /rest/api/3/field/{fieldId}/context/mapping Find which field context applies to project/type pairs · Atlassian Get Custom Field Contexts For Projects And Issue Types #

Ask an LLM

“Which context of a custom field applies to a given project and issue type combination?”

“Can I look up the effective field context for several project and issue type pairs at once?”

Tell an agent

Find the context of field {fieldId} that applies to {mappings}.

Resolve the effective field {fieldId} context for these project and issue type pairs: {mappings}.

GET /rest/api/3/field/{fieldId}/context/projectmapping List projects mapped to a field's contexts · Atlassian Get Project Mappings For Custom Field Context #

Ask an LLM

“Which projects use each context of a custom field?”

“What projects is a particular field context assigned to?”

Tell an agent

Show the project mappings for contexts of field {fieldId}.

List projects assigned to context {contextId} of field {fieldId}.

DELETE /rest/api/3/field/{fieldId}/context/{contextId} Delete a custom field context · Atlassian Delete Custom Field Context #

Ask an LLM

“How do I delete a context from a custom field?”

“Who is permitted to remove a custom field context?”

Tell an agent destructive · confirm first

Delete context {contextId} from custom field {fieldId}.

Remove the {contextId} context entirely from field {fieldId}.

PUT /rest/api/3/field/{fieldId}/context/{contextId} Rename or redescribe a field context · Atlassian Update Custom Field Context #

Ask an LLM

“How do I rename an existing custom field context?”

“What is the length limit on a field context's description?”

Tell an agent

Rename context {contextId} of field {fieldId} to {name}.

Change the description of field {fieldId} context {contextId} to {description}.

PUT /rest/api/3/field/{fieldId}/context/{contextId}/issuetype Add issue types to a field context · Atlassian Add Issue Types To Context #

Ask an LLM

“How do I make a custom field context apply to more issue types?”

“What happens when I add issue types to a context that covered all types?”

Tell an agent

Add issue types {issueTypeIds} to context {contextId} of field {fieldId}.

Append {issueTypeIds} to the issue types of field {fieldId} context {contextId}.

POST /rest/api/3/field/{fieldId}/context/{contextId}/issuetype/remove Remove issue types from a field context · Atlassian Remove Issue Types From Context #

Ask an LLM

“How do I stop a custom field context from applying to some issue types?”

“What does a field context cover once I remove all of its issue types?”

Tell an agent

Remove issue types {issueTypeIds} from context {contextId} of field {fieldId}.

Drop {issueTypeIds} from the issue types of field {fieldId} context {contextId}.

PUT /rest/api/3/field/{fieldId}/context/{contextId}/project Assign a field context to projects · Atlassian Assign Custom Field Context To Projects #

Ask an LLM

“How do I apply a custom field context to specific projects?”

“Why would assigning projects to a field context fail?”

Tell an agent

Assign context {contextId} of field {fieldId} to projects {projectIds}.

Attach projects {projectIds} to field {fieldId} context {contextId}.

POST /rest/api/3/field/{fieldId}/context/{contextId}/project/remove Remove a field context from projects · Atlassian Remove Custom Field Context From Projects #

Ask an LLM

“How do I detach a custom field context from some projects?”

“Does removing every project make a field context apply globally?”

Tell an agent

Remove context {contextId} of field {fieldId} from projects {projectIds}.

Detach projects {projectIds} from field {fieldId} context {contextId}.

Atlassian Issue Custom Field Contexts API

Operations 13

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification