SKskilljar
Groups

Create groups

Changed on

Create up to BATCH_MAX_ITEMS groups in a single request.

Each item is processed independently — a failure on one row does not abort the rest. Response is 200 if all items succeed, 207 if any fail, 400 if the request envelope is empty or over the cap.

Within-batch duplicate detection is first-wins on name: the first occurrence of a name is processed; subsequent occurrences are pre-marked as duplicate_in_batch without reaching the service.

See api_v2/docs/batch-responses.md for the 200/207/400 status convention and per-item error code vocabulary.

Required OAuth scope: student-groups:write

post/v2/groups/

Request

Request body

Response

OK

Changes

  • bed169429eb2Revision changes
    • breaking

      removed the required property ///// from the response with the status

    • breaking

      removed the required property ///// from the response with the status

    • warning

      added the new already_in_path enum value to the //// response property for the response status

    • warning

      added the new already_in_path enum value to the //// response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status

  • 9fc34e55336dRevision changes
    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status