Preview new plans

post

https://{tenant}.onechurchsoftware.com/api/plans/preview

Compute the plans that POST /api/plans would create with the given options, without creating anything. Option "none" returns undated plans, "copy" repeats the times of the plan given in copy, and "custom" builds the first plan from times; later plans follow the service type's frequency starting from start. Pass the returned list back to the create endpoint as preview, optionally setting template on individual entries.

Required permission: Full Write Service Plans

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The options for the new plans

type

object | null

The service type of the new plans.

count

int32

The number of plans to create.

copy

int32 | null

The id of the plan whose times are repeated, when the option is "copy".

option

string | null

How the plans' times are determined: "none" creates undated plans, "copy" repeats the times of the plan given in copy, and "custom" builds the first plan from times. Required when previewing.

start

date-time | null

The date of the first plan. Later plans follow the service type's frequency. Required unless the option is "none".

times

array of objects | null

The service and rehearsal times of the first plan, when the option is "custom".

times

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

200OK