Doing Endpoints

The Doing module manages service planning, volunteer scheduling, task management, and automations. It provides tools for creating service plans with times and positions, assigning volunteers, managing blockout dates, building service order items, connecting to external content providers, and configuring automated workflows with conditions and actions.

Base path: /doing

Plans

Base path: /doing/plans

Method	Path	Auth	Permission	Description
GET	/	JWT	—	List all plans for the church
GET	/:id	JWT	—	Get a plan by ID
GET	/ids?ids=	JWT	—	Get multiple plans by comma-separated IDs
GET	/types/:planTypeId	JWT	—	Get plans by plan type
GET	/textRange?startDate=&endDate=&ministryId=&planTypeId=	JWT	texting.send + ministry edit	Preview the serving overview Text Volunteers send: { totalMembers, eligibleCount, optedOutCount, noPhoneCount, capped } for the volunteers assigned in the range (one per person, opted-out and missing numbers skipped, shared numbers deduplicated, capped at 200)
GET	/presenter	JWT	—	Get plans for the next 7 days (presenter view)
GET	/confirmationWorkflows?ministryId=	JWT	Ministry edit	Active serving assignment confirmation workflows (workflowType = "assignmentConfirmation") a plan can select: [{ id, name }]
GET	/public/current/:planTypeId	Public	—	Get the current plan for a plan type
GET	/public/signup/:churchId	Public	—	Plans open for self-signup, soonest first, each with its self-signup positions (sorted by categoryName, then name, plus filledCount of Accepted/Unconfirmed assignments) and times. No volunteer names. When the church setting volunteerSignupNextOnly is "true", only the first plan of each plan type is returned. Each plan includes a computed signupDeadline (ISO instant, or null): signupDeadlineHours before the plan's earliest service-type time (any timed entry if there is no service time; 9:00 in the church's time zone on serviceDate if the plan has no times)
GET	/signup/:planId/volunteers	JWT	—	[{ positionId, names }] for the plan's self-signup positions (display names of Accepted/Unconfirmed assignees). Returns [] unless the plan's showVolunteerNames is on
POST	/	JWT	—	Create or update plans (accepts single object or array). Set confirmationWorkflowId to opt the plan into a serving confirmation workflow, or null to opt out for future requests. Send signupDeadlineHours: null to clear a deadline; omitting the field keeps the saved value
POST	/copy/:id	JWT	Ministry edit	Copy a plan including positions, times, assignments, and service order items. Body includes ministryId, serviceDate, copyMode ("none", "positions", "all") and copyServiceOrder (boolean). Without targetPlanId a new plan is created, and notes, signupDeadlineHours, showVolunteerNames, and autoReplaceOnDecline carry over from the source plan unless the body supplies them. With targetPlanId, the copy fills that existing plan instead (the caller must be able to edit it). B1Admin's Repeat weekly option calls this once per week, each time copying from the plan created the week before
POST	/textRange	JWT	texting.send + ministry edit	Text every volunteer assigned in a date range through the church's texting provider. Body: { startDate, endDate, ministryId, planTypeId?, message } (message up to 1600 characters; merge fields resolved per recipient). Returns the preview counts plus recipientCount, successCount, failCount, and error (no_provider or insufficient_credits) when sending stops early
POST	/:id/issueRequests	JWT	Plan edit	Issue the plan's new Unconfirmed, not-yet-notified assignments through its confirmation workflow: marks each notified and starts one workflow card per assignment. Empty body; returns { issued }. Fails unless the plan is published (not prepared), has an active confirmationWorkflowId with at least one step, and its response deadline hasn't passed
POST	/autofill/:id	JWT	—	Auto-fill volunteer assignments for a plan. Body: { teams: [{ positionId, personIds }] }
DELETE	/:id	JWT	—	Delete a plan and all related times, assignments, positions, and plan items

Example: Copy a Plan

POST /doing/plans/copy/abc-123
Authorization: Bearer <token>

{
  "serviceDate": "2026-03-01T10:00:00.000Z",
  "copyMode": "all",
  "copyServiceOrder": true
}

{
  "id": "def-456",
  "churchId": "church-1",
  "serviceDate": "2026-03-01T10:00:00.000Z"
}

Plan Types

Base path: /doing/planTypes

Extends CRUD base class (GET /, GET /:id, POST /, DELETE /:id — no permission checks).

Method	Path	Auth	Permission	Description
GET	/	JWT	—	List all plan types
GET	/:id	JWT	—	Get a plan type by ID
GET	/ids?ids=	JWT	—	Get multiple plan types by comma-separated IDs
GET	/ministryId/:ministryId	JWT	—	Get plan types for a ministry
POST	/	JWT	—	Create or update plan types
DELETE	/:id	JWT	—	Delete a plan type

Plan Items

Base path: /doing/planItems

Manages service order items (headers, sections, songs, etc.) organized in a parent-child tree structure.

Method	Path	Auth	Permission	Description
GET	/:id	JWT	—	Get a plan item by ID
GET	/ids?ids=	JWT	—	Get multiple plan items by comma-separated IDs
GET	/plan/:planId	JWT	—	Get all plan items for a plan (returns tree structure)
GET	/presenter/:churchId/:planId	Public	—	Get plan items for presenter view (returns tree structure)
POST	/	JWT	—	Create or update plan items
POST	/sort	JWT	—	Update sort order for a plan item (re-sorts siblings)
DELETE	/:id	JWT	—	Delete a plan item

Plan Feed

Base path: /doing/planFeed

Provides plan item feeds for the presenter. If no plan items exist, auto-populates from the Lessons.church venue feed using the plan's contentId.

Method	Path	Auth	Permission	Description
GET	/presenter/:churchId/:planId	Public	—	Get plan feed for presenter (auto-populates from venue feed if empty)

Positions

Base path: /doing/positions

Extends CRUD base class (GET /:id, POST /, DELETE /:id — no permission checks).

Method	Path	Auth	Permission	Description
GET	/:id	JWT	—	Get a position by ID
GET	/ids?ids=	JWT	—	Get multiple positions by comma-separated IDs
GET	/plan/ids?planIds=	JWT	—	Get positions for multiple plans by comma-separated plan IDs
GET	/plan/:planId	JWT	—	Get all positions for a plan
POST	/	JWT	—	Create or update positions
DELETE	/:id	JWT	—	Delete a position

Times

Base path: /doing/times

Method	Path	Auth	Permission	Description
GET	/all	JWT	—	List all times for the church
GET	/:id	JWT	—	Get a time by ID
GET	/plans?planIds=	JWT	—	Get times for multiple plans by comma-separated plan IDs
GET	/plan/:planId	JWT	—	Get all times for a plan
POST	/	JWT	—	Create or update times
DELETE	/:id	JWT	—	Delete a time

Assignments

Base path: /doing/assignments

Method	Path	Auth	Permission	Description
GET	/my	JWT	—	Get assignments for the current user
GET	/my/upcoming	JWT	—	Up to 20 of the current user's assignments on plans dated from yesterday on (penciled-in, or prepared, plans are skipped), soonest first: { assignmentId, status, positionName, planId, planName, serviceDate }. Backs the serving preview on the member home page
GET	/:id	JWT	—	Get an assignment by ID
GET	/plan/ids?planIds=	JWT	—	Get assignments for multiple plans by comma-separated plan IDs
GET	/plan/:planId	JWT	—	Get all assignments for a plan
POST	/	JWT	—	Create or update assignments (defaults status to "Unconfirmed")
POST	/accept/:id	JWT	—	Accept an assignment (must be the assigned person)
POST	/decline/:id	JWT	—	Decline an assignment (must be the assigned person)
POST	/signup	JWT	—	Self-signup for a position. Body: { positionId }. The position must allow self-signup and have room; creates an Accepted assignment. Rejected with "Signup deadline has passed" once the plan's signup deadline (counted back from its first service time, as above) has passed
DELETE	/signup/:id	JWT	—	Remove your own self-signup. Rejected with "Removal deadline has passed" after the plan's signup deadline
DELETE	/:id	JWT	—	Delete an assignment

Example: Accept an Assignment

POST /doing/assignments/accept/assign-123
Authorization: Bearer <token>

{
  "id": "assign-123",
  "personId": "person-456",
  "positionId": "pos-789",
  "planId": "plan-abc",
  "status": "Accepted"
}

Blockout Dates

Base path: /doing/blockoutDates

Extends CRUD base class (GET /:id, DELETE /:id — no permission checks).

Method	Path	Auth	Permission	Description
GET	/:id	JWT	—	Get a blockout date by ID
GET	/ids?ids=	JWT	—	Get multiple blockout dates by comma-separated IDs
GET	/my	JWT	—	Get blockout dates for the current user
GET	/upcoming	JWT	—	Get all upcoming blockout dates for the church
POST	/	JWT	—	Create or update blockout dates (defaults personId to current user if not provided)
DELETE	/:id	JWT	—	Delete a blockout date

Tasks

Base path: /doing/tasks

Method	Path	Auth	Permission	Description
GET	/	JWT	—	Get open tasks for the current user
GET	/:id	JWT	—	Get a task by ID
GET	/:id/contact	JWT	Can view the card	Contact info for the person a workflow card is about: { personId, displayName, mobilePhone, email }. Lets an assigned caller without People access reach the person
GET	/closed	JWT	—	Get closed tasks for the current user
GET	/timeline?taskIds=	JWT	—	Get timeline data for tasks by comma-separated task IDs
GET	/directoryUpdate/:personId	JWT	—	Get directory update task for a person
POST	/	JWT	—	Create or update tasks. Add ?type=directoryUpdate to handle directory update tasks (auto-uploads photos)
POST	/:id/conversation	JWT	tasks.edit or card assignee	Attach the notes conversation to a card. Body: { conversationId }. The first conversation attached wins; later calls return the card unchanged
POST	/loadForGroups	JWT	—	Load tasks for specific groups. Body: { groupIds: [], status: "Open" }

Automations

Base path: /doing/automations

Method	Path	Auth	Permission	Description
GET	/	JWT	—	List all automations for the church
GET	/:id	JWT	—	Get an automation by ID
GET	/check	Public	—	Trigger a check of all automations
POST	/	JWT	—	Create or update automations
DELETE	/:id	JWT	—	Delete an automation

Actions

Base path: /doing/actions

Actions define what happens when an automation is triggered.

Method	Path	Auth	Permission	Description
GET	/:id	JWT	—	Get an action by ID
GET	/automation/:id	JWT	—	Get all actions for an automation
POST	/	JWT	—	Create or update actions
DELETE	/:id	JWT	—	Delete an action

Conditions

Base path: /doing/conditions

Conditions define the criteria that trigger an automation.

Method	Path	Auth	Permission	Description
GET	/:id	JWT	—	Get a condition by ID
GET	/automation/:id	JWT	—	Get all conditions for an automation
POST	/	JWT	—	Create or update conditions
DELETE	/:id	JWT	—	Delete a condition

Conjunctions

Base path: /doing/conjunctions

Conjunctions link multiple conditions together in an automation (AND/OR logic).

Method	Path	Auth	Permission	Description
GET	/:id	JWT	—	Get a conjunction by ID
GET	/automation/:id	JWT	—	Get all conjunctions for an automation
POST	/	JWT	—	Create or update conjunctions
DELETE	/:id	JWT	—	Delete a conjunction

Content Provider Auths

Base path: /doing/contentProviderAuths

Extends CRUD base class (GET /, GET /:id, POST /, DELETE /:id — no permission checks).

Manages OAuth authentication records for external content providers (e.g., presentation software integrations).

Method	Path	Auth	Permission	Description
GET	/	JWT	—	List all content provider auths
GET	/:id	JWT	—	Get a content provider auth by ID
GET	/ids?ids=	JWT	—	Get multiple content provider auths by comma-separated IDs
GET	/ministry/:ministryId	JWT	—	Get all content provider auths for a ministry
GET	/ministry/:ministryId/:providerId	JWT	—	Get auth record for a specific ministry and provider
POST	/	JWT	—	Create or update content provider auths
DELETE	/:id	JWT	—	Delete a content provider auth

Provider Proxy

Base path: /doing/providerProxy

Proxies requests to external content providers (e.g., ProPresenter, EasyWorship). Handles token refresh automatically when tokens expire.

Method	Path	Auth	Permission	Description
POST	/browse	JWT	—	Browse content provider files. Body: { ministryId, providerId, path }
POST	/getPresentations	JWT	—	Get presentations from a content provider. Body: { ministryId, providerId, path }
POST	/getPlaylist	JWT	—	Get a playlist from a content provider. Body: { ministryId, providerId, path, resolution }
POST	/getInstructions	JWT	—	Get instructions for a content item. Body: { ministryId, providerId, path }
POST	/getExpandedInstructions	JWT	—	Get expanded instructions for a content item. Body: { ministryId, providerId, path }

Related Pages

• Membership Endpoints — People, groups, roles, and permissions
• Attendance Endpoints — Service and visit tracking
• Module Structure — Code organization patterns