Developers API reference Version 1 · generated from the code openapi.json
Routes

buttons

Edit a navigation button

PATCH /api/v1/buttons/{button_id}

Change the label of a button, its target, or both. A target is given as on creation, with link and reference.

Required scope: write

Path parameters

  • button_id integer · required

    Id of the navigation button.

Request body application/json

  • label string or null · optional

    New label.

  • link string or null · optional

    New kind of target, as on creation. Left out: the button keeps the kind it has.

  • reference string or null · optional

    Reference of the new target step.

Response

200 Button

  • id integer

    Id of the button.

  • label string

    What the button says.

  • target_step_id integer or null

    Id of the step it leads to; null when it ends the flow, or when its target was deleted.

  • target_reference string

    Reference of the step it leads to, kept after that step is deleted; empty when it ends the flow.

  • ends_procedure boolean

    Whether it ends the flow.

  • target_missing boolean

    Whether it points at a step that was deleted. A draft cannot be published while one remains.

Errors

  • 401

    No valid credential.

  • 403

    The credential lacks the required scope, or the account may not do this.

  • 404

    Nothing with that id, or nothing the account may open.

  • 409

    The current state of the content forbids the request.

  • 422

    A value is missing or malformed.

  • 429

    Too many requests; Retry-After gives the seconds to wait.

planner_banner_ad_pt