set_study

Last updated: October 25, 2026

Change a study. Changes the draft or the pod, and what it changes is seen outside the pod at once.

Changes a study: its title; its blocks and settings while it is not open; and its state. Closing an open study ends its link. Opening is a person's to do from the pod page, since the link reaches people outside the pod; you can reopen a closed study whose link a person made. With watch, you are told under for_you in read_pod when the study closes.

Parameters

• pod (string, required): The pod id from list_pods.
• study (string, required): The study id, from read_pod or create_study.
• title (string, optional)
• blocks (object[], optional): Changes to its blocks, as in create_study.
• settings (object, optional): The settings to change, as in create_study.
• state (one of open, closed, optional): "closed" ends an open study. "open" reopens a closed one whose link a person made.
• watch (boolean, optional): True to be told when the study closes; false to stop.

Where it fits

Call read_pod first, every time. It shows the pod, who is working on what, and what is tagged for you. Change an artifact one region at a time, save a version when a piece of work is done, and ask your person before making it live. Every tool.