SequenceSteps

Reorder a sequence's steps

Reorders a sequence's steps to the given stepIds order. stepIds must be the COMPLETE ordered list of the sequence's current step ids. SEP validates both count and membership, so a partial list, an id from another sequence, or a duplicate id is rejected with 422 rather than applied as a partial reorder.

Returns the reordered steps as { "data": SequenceStep[] }, in the same order as the requested stepIds (re-read through the same path as GET /sequenceSteps, so template/hasAbVariants reflect current state; unlike the internal SEP response, this omits nothing).

To build the stepIds list, first fetch the sequence's current steps in order: GET /sequenceSteps?filter[sequence][id]={id} (steps are returned ordered by order).

OAuth callers with the user role can only reorder steps of sequences they own (403 INSUFFICIENT_PERMISSION otherwise); admin and manager roles can reorder any sequence in the workspace.

post/sequences/{id}/actions/reorderSteps

Request

  • Base URL: https://partner-api.nooks.in/v1
  • URL: https://partner-api.nooks.in/v1/sequences/{id}/actions/reorderSteps
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://oauth.nooks.in/oauth/authorize, token URL https://oauth.nooks.in/oauth/token, scopes: sequence-steps:write)

Path parameters

idstring uuid required

Unique identifier for the sequence

Request body

Example request

{
  "data": {
    "stepIds": [
      "aa0e8400-e29b-41d4-a716-446655440031",
      "aa0e8400-e29b-41d4-a716-446655440030"
    ]
  }
}

Response

Steps reordered

Example response

{
  "data": [
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440030",
      "name": "Intro email",
      "interval": 4320,
      "action": "auto_email",
      "note": "Initial outreach email",
      "sequence": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "template": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "_href": "/v1/sequences/550e8400-e29b-41d4-a716-446655440000"
      },
      "analytics": {
        "email": {
          "delivered": 412,
          "opened": 198,
          "clicked": 41,
          "replied": 23,
          "bounced": 7,
          "unsubscribed": 2
        },
        "calls": {
          "dialed": 380,
          "connected": 71,
          "meetings": 5
        },
        "linkedIn": {
          "connectionRequestsSent": 96,
          "connectionRequestsAccepted": 31,
          "messagesSent": 64,
          "repliesReceived": 12
        }
      },
      "createdAt": "2025-10-01T10:00:00.000Z",
      "updatedAt": "2025-10-01T10:00:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.