Skip to navigation
API ReferencePosts

Update

Change a post’s body, and an update’s health. Only its author may: through an API key, the person the key belongs to. A post a ticketing sync brought in (one with a source) is that system’s: changing it here is a 409 conflict; change it there, and the next sync brings it across. Needs launches:write.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

launchIdstringRequired
postIdstringRequired

Request

This endpoint expects an object.
bodystringRequired
Markdown, up to 20,000 characters.
healthenumOptional

An update’s new verdict; left out, unchanged. Ignored on a comment.

Allowed values:

Response

This endpoint returns an object.
idstring
launchIdstring
kindenum
Allowed values:
bodystring
Markdown.
createdAtdatetime
updatedAtdatetime
healthenumOptional

An update’s verdict; null on a comment.

Allowed values:
authorobjectOptional

Who wrote it; null when they have left, or for a weekly update carried over from before.

editedAtdatetimeOptional
When its author last changed it.
sourceenumOptional

The ticketing system a post came from, when a sync brought it in from the launch’s ticketing project (a status update from Linear or GitHub, or a comment from Jira or ClickUp); null for one written here. Asana’s status updates are not brought in: Taktoria’s read-only connection cannot read them. Such a post is changed in that system, not here: editing it is a 409 conflict, and the next sync brings the change across.

Allowed values:
sourceUrlstringOptional
The update's address in that system.
sourceAuthorstringOptional

Its author’s name in that system. author is the member with that author’s email, when there is one.

Errors

403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Validation Error
429
Too Many Requests Error