API Reference
  1. One Church Software API
  2. Service Plans

Update position need

put
https://{tenant}.onechurchsoftware.com/api/plans//needs/quantity

Set how many volunteers are needed for a position on one of the plan's teams. Identify the need by its group and position (plus time, on teams split by service time), or directly by need. A quantity of 0 removes the need. The response's refresh flag indicates whether the plan's team structure changed.

Required permission: Full Write Service Plans

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required
≥ 1

The id of the plan

Body Params

The need and its new quantity

int32

How many volunteers are needed. 0 removes the need.

int32

The id of the team (group) the need belongs to. Required unless need is provided.

int32

The id of the serving position the need is for. Required unless need is provided.

int32 | null

The id of the plan time the need applies to, on teams that are split by service time.

int32 | null

The id of an existing need to update directly. When provided, group, position, and time are ignored.

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.

Updated about 2 months ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json

Updated about 2 months ago

Did this page help you?