---
title: "Stop, pause, resume, retry or send now for many contacts"
method: POST
path: "/sequences/{sequence_id}/contacts/bulk-journey/"
tags: ["sequences"]
---

# Stop, pause, resume, retry or send now for many contacts

`POST /sequences/{sequence_id}/contacts/bulk-journey/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/sequences/{sequence_id}/contacts/bulk-journey/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The Audience tab's bulk actions, over the contacts a person ticked: listed ids, or scope='all' for every contact the given filters match, less any excluded_ids. Each contact is judged on its own and one the action cannot apply to is skipped rather than failing the batch, because a selection is rarely uniform: 'changed' reports how many actually took it. 'resume' covers both waking a paused contact and undoing a reply stop; neither ever restarts a contact at step 1, and either finishes a wait the contact was in. 'send_now' makes a waiting contact's next step due now instead of when its wait ends; pacing, the daily cap and approvals still apply.

## Path parameters

- `sequence_id` string, uuid, required

## Request body

- BulkJourneyContactsSchema: One journey action applied to a selection of contacts. The selection is exactly what the person ticked: some rows, or the header checkbox, which is every contact the filter matches less any unticked since. A scope='ids' request still has to name at least one contact.
  - `action` 'stop' | 'pause' | 'resume' | 'retry' | 'send_now', required
  - `created_from` string, date-time, nullable: Only remove contacts added on or after this instant. The grid's date range, which a scope='all' removal has to honour or it reaches past what the person was looking at.
  - `created_to` string, date-time, nullable
  - `enrolment_ids` string[]
  - `exclude` boolean: Read 'statuses' and 'stop_reasons' as 'everything but', matching the Contacts tab's one Include/Exclude toggle.
  - `excluded_ids` string[]: With scope='all', contacts to leave out: the rows unticked after ticking the header checkbox.
  - `group` 'in_progress' | 'needs_approval' | 'paused' | 'done' | 'blocked': The Audience tab's tab a contact sits under; every contact is under one. The tabs used to be counts that overlapped (a bounced contact was both "reachable" and "blocked", so the counts added up past the roster) and opened a list of names over the roster they repeated (Natsuki, 2026-10-02). They partition the roster now and filter it in place, so a tab's count is exactly the rows it shows, and each row's own status chip names the state that put it there. Derived at read time from the status, the stop reason, the contact's current-step task and whether an address reaches them, never stored.
  - `scope` 'ids' | 'all'
  - `search` string, nullable
  - `sort` 'created_desc' | 'created_asc' | 'status' | 'status_desc' | 'next_due': The orders the Audience tab can list a sequence's contacts in.
  - `statuses` EnrolmentStatus[], nullable
  - `stop_reasons` StopReason[], nullable

## Response `200`

Successful Response

- BulkJourneyContactsResponseSchema
  - `changed` integer, required: How many contacts actually took the action. A selection is rarely uniform, so rows the action cannot apply to are skipped, not failed.
  - `in_other_sequence` integer: Of the skipped, the failed contacts a retry left failed because another live sequence has taken them since. They stay on the step that broke, for a retry once that sequence is done with them.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)