Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

How Can I Post to Atlassian Teams field via API?

Ryan
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
April 15, 2026

Hello!

I'm on a free account, but want to know if there are special requirements to be able to post to update the Atlassian Teams field? Right now, when I use an API I'm getting an error when I try to post to that field.

What do I need on my account in order to change/update the Atlassian Team field on issues via API?

Thank you!

3 answers

2 votes
Ajay _view26_
Community Champion
April 15, 2026

Hi @Ryan 

Hi Ryan! The Atlassian Teams field is a custom field of type com.atlassian.teams:rm-teams-custom-field-team, and you can update it via the standard Jira REST API — no special plan is required for API access, but the Teams field must first be enabled for your site and project.

Here's how to update it:

  1. Find your Team's ID: Go to the team's profile page and copy the UUID from the URL after /team/ (e.g., 36885b3c-1bf0-4f85-a357-c5b858c31de4).
  2. Find your custom field ID: The Teams field is typically customfield_10001, but check your instance via GET /rest/api/3/field.
  3. Update the issue
PUT /rest/api/3/issue/{issueKey}
Body: { "fields": { "customfield_10001": { "id": "YOUR-TEAM-UUID" } } }

 

2 votes
Trudy Claspill
Community Champion
April 15, 2026

Hello @Ryan 

Welcome to the Atlassian community.

To help you debug your issue we need more information.

The Team field in an issue can be updated via the REST API

What API endpoint are you using? Please provide a link to the documents you are referencing for this endpoint. You might find this documentation helpful.

https://developer.atlassian.com/platform/teams/components/team-field-in-jira-rest-api/

What error are you getting?

What parameters and payload are you providing when you call the endpoint?

0 votes
Arkadiusz Wroblewski
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Champions.
April 15, 2026

Hello @Ryan 

That what @Trudy Claspill  and @Ajay _view26_ saying. 

There's no special account requirement, but the field must be enabled and you need the correct customfield_xxxxx plus the team UUID in the payload.

Without you posting here specific Failure, we can't answer what's going wrong.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
TAGS
AUG Leaders

Atlassian Community Events