board-github

PUT /v1/board-github/links/{linkId}/items/{itemId}/field

Set or clear one field value on a GitHub Project item.

Све board-github крајње тачке

Сва документација за програмере →

Аутентификација

Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X PUT https://api.zinndigital.com/v1/board-github/links/{linkId}/items/{itemId}/field \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "field_node_id": <string> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

value: null clears the field, through a different GitHub mutation. Sending an empty string would set the field to the empty string, which a date field refuses and a text field renders as a permanent blank chip — a save that looks like it worked. Only TEXT, NUMBER, DATE, SINGLE_SELECT and ITERATION are writable; every other type is either computed by GitHub or set on the underlying issue. The writable flag on each field in the connection payload is computed server-side so the UI never keeps its own copy of that list.

Параметри

НазивТипОбавезноШта је ово
linkId (path)stringДаThe GitHub Projects connection.
itemId (path)stringДаThe item, by OUR id — not GitHub's node id, which is not a path-safe value.

Тело захтева

НазивТипОбавезноШта је ово
field_node_idstringДа—
valueobjectНеnull CLEARS the field, through a different GitHub mutation. An empty string would set the field to the empty string.

Одговор

НазивТипОбавезноШта је ово
idstringНе—
item_node_idstringНе—
item_typestring<ISSUE, PULL_REQUEST, DRAFT_ISSUE, REDACTED>Не—
content_numberintegerНе—
repositorystringНе—
titlestringНе—
bodystringНе—
urlstringНе—
statestringНе—
is_archivedbooleanНе—
field_valuesobjectНеKeyed by the field's node id, never its name. A project owner renaming a field would otherwise orphan every stored value at once, and the next sync would read it as "every…
github_updated_atstringНе—
local_updated_atstringНеWhen WE last changed this item. Set only by a local edit, never by a sync — a sync that stamped it would make every imported item look locally-edited and hand every subsequent…
card_idstringНе—

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422