Get project field for organization

GET

/orgs/{org}/projectsV2/{project_number}/fields/{field_id}

Get a specific field for an organization-owned project.

API method documentation

Parameters

Path Parameters

project_number

required

integer

The project’s number.

field_id

required

integer

The unique identifier of the field.

org

required

string

The organization name. The name is not case sensitive.

Responses

200

Response

Media type application/json

Projects v2 Field

A field inside a projects v2 project

object

id

required

The unique identifier of the field.

integer

issue_field_id

The ID of the issue field.

integer

node_id

The node ID of the field.

string

project_url

required

The API URL of the project that contains the field.

string

name

required

The name of the field.

string

data_type

required

The field’s data type.

string

Allowed values: assignees linked_pull_requests reviewers labels milestone repository title text single_select number date iteration issue_type parent_issue sub_issues_progress

options

The options available for single select fields.

Array<object>

Projects v2 Single Select Option

An option for a single select field

object

id

required

The unique identifier of the option.

string

name

required

The display name of the option, in raw text and HTML formats.

object

raw

required

string

html

required

string

description

required

The description of the option, in raw text and HTML formats.

object

raw

required

string

html

required

string

color

required

The color associated with the option.

string

configuration

Configuration for iteration fields.

object

start_day

The day of the week when the iteration starts.

integer

duration

The duration of the iteration in days.

integer

iterations

Array<object>

Projects v2 Iteration Setting

An iteration setting for an iteration field

object

id

required

The unique identifier of the iteration setting.

string

start_date

required

The start date of the iteration.

string format: date

duration

required

The duration of the iteration in days.

integer

title

required

The iteration title, in raw text and HTML formats.

object

raw

required

string

html

required

string

completed

required

Whether the iteration has been completed.

boolean

created_at

required

The time when the field was created.

string format: date-time

updated_at

required

The time when the field was last updated.

string format: date-time

Examples

Example default

{
  "id": 12345,
  "node_id": "PVTF_lADOABCD1234567890",
  "name": "Priority",
  "data_type": "single_select",
  "project_url": "https://api.github.com/projects/67890",
  "options": [
    {
      "id": "option_1",
      "name": {
        "html": "Low",
        "raw": "Low"
      },
      "color": "GREEN",
      "description": {
        "html": "Low priority items",
        "raw": "Low priority items"
      }
    },
    {
      "id": "option_2",
      "name": {
        "html": "Medium",
        "raw": "Medium"
      },
      "color": "YELLOW",
      "description": {
        "html": "Medium priority items",
        "raw": "Medium priority items"
      }
    },
    {
      "id": "option_3",
      "name": {
        "html": "High",
        "raw": "High"
      },
      "color": "RED",
      "description": {
        "html": "High priority items",
        "raw": "High priority items"
      }
    }
  ],
  "created_at": "2022-04-28T12:00:00Z",
  "updated_at": "2022-04-28T12:00:00Z"
}

Headers

Link

string

Example

<https://api.github.com/resource?page=2>; rel="next", <https://api.github.com/resource?page=5>; rel="last"

304

Not modified

401

Requires authentication

Media type application/json

Basic Error

Basic Error

object

message

string

documentation_url

string

url

string

status

string

Example ^generated

{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

403

Forbidden

Media type application/json

Basic Error

Basic Error

object

message

string

documentation_url

string

url

string

status

string

Example ^generated

{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}