kythene.v1.KytheneService

SetActionState

SetActionState moves an action along by naming a target state - the aggregate of start / stop / resolve / reopen / close.

post/kythene.v1.KytheneService/SetActionState

Request

  • Base URL: https://kythene.com (the document declares no server; this is the origin it was published from)
  • URL: https://kythene.com/kythene.v1.KytheneService/SetActionState
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

actionstring

action is the action's id.

statestring

state is the target: "in_progress" - you have started. Yours to say, as the assignee. "pending" - not now (from in_progress), or REOPEN a resolved action. Either party may reopen: disagreeing with "done" is the whole reason resolved exists. "resolved" - you think it is finished. Reversible on purpose. "closed" - finished, do not touch it. Terminal, and it needs a resolution. To carry on afterwards, raise a new action with this one as its parent_action.

resolutionstring

resolution is REQUIRED when closing: done | wont_do | cancelled. It is stored rather than guessed from who closed it.

spacestring

space optionally selects which of your spaces to act in.

Response

Success

Example response

{
  "action": {
    "createdAt": "2023-01-15T01:30:15.01Z",
    "updatedAt": "2023-01-15T01:30:15.01Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.