Reorder activities within a group

Persists the full ordered membership of a group after a drag-to-reorder. Pass every item as it should appear; each row's `sortOrder` is set to its position. Scoped to the caller's own groups; gated by `user_schedule:read`.

Path parameters

groupIdstringRequired

Custom activity group identifier.

Request body

Content type: application/json · schema ReorderActivitiesInGroupBodyV1

itemsarray of objectRequired

min items 1

itemsobject

activityIdstringRequired

min length 1

activityTypestringRequired

min length 1

sortOrderintegerRequired

≥ 0

Response codes

200

Group order persisted.

400

Invalid request body.

401

Authentication required.

403

Permission denied (user_schedule:read).

404

Group not found.

500

Unexpected failure reordering the group.

PATCH /api/v1/activities/groups/{groupId}/items

cURL

curl -X PATCH "https://algapsa.com/api/v1/activities/groups/{groupId}/items" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    {
      "activityId": "x",
      "activityType": "x",
      "sortOrder": 0
    }
  ]
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/activities/groups/{groupId}/items", {
  method: "PATCH",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "items": [
      {
        "activityId": "x",
        "activityType": "x",
        "sortOrder": 0
      }
    ]
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Patch, "https://algapsa.com/api/v1/activities/groups/{groupId}/items");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""items"": [
    {
      ""activityId"": ""x"",
      ""activityType"": ""x"",
      ""sortOrder"": 0
    }
  ]
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();