Reorder an app's pinned funnels

PUT/apps/{id}/funnels/pinned

Puts the app's pinned funnels in the given order and returns them in that order. Needs a role that can change funnels.

funnel_ids must hold every pinned funnel of the app once and no other funnel. When a funnel was pinned or unpinned since the list was read, the request fails with a 409, so a stale order does not undo that change.

Authorization

bearerAuth

AuthorizationBearer <token>

User access token issued at sign-in. Sent as Authorization: Bearer <access-token> unless cookies are used to send tokens. The /auth/refresh and /auth/signout endpoints expect the session's refresh token in the same header format instead.

In: header

Path Parameters

id*string

App's UUID.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

funnel_ids*array<>

The app's pinned funnel ids in their new order.

Response Body

`application/json`

curl -X PUT "https://example.com/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/funnels/pinned" \  -H "Content-Type: application/json" \  -d '{    "funnel_ids": [      "3f0b6c1e-6a2d-4c8e-9a51-2d7e4b9f1c05",      "7a2e9d4b-1c3f-4b6a-8e5d-0f9c2b7a4e61"    ]  }'

{  "results": [    {      "id": "3f0b6c1e-6a2d-4c8e-9a51-2d7e4b9f1c05",      "app_id": "2b7ddad4-40a6-42a7-9e21-a90577e08263",      "name": "Checkout",      "steps": [        {          "event_name": "view_cart"        },        {          "event_name": "start_checkout"        },        {          "event_name": "purchase"        }      ],      "conversion_window_seconds": 3600,      "pinned": true,      "pin_order": 0,      "created_by": "9c1f2a7e-3b4d-4e5f-8a6b-7c8d9e0f1a2b",      "created_by_email": "dev@example.com",      "created_at": "2026-09-10T10:00:00Z",      "updated_at": "2026-09-12T08:30:00Z"    }  ]}