Skip to main content
DELETE
/
v1
/
groups
/
{id}
Delete a group
curl --request DELETE \
  --url https://api.scrip.dev/v1/groups/{id} \
  --header 'X-API-Key: <api-key>'
{
  "created_at": "2024-01-15T10:30:00Z",
  "deleted_at": "2023-11-07T05:31:56Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Sales Team",
  "status": "ACTIVE",
  "updated_at": "2024-01-15T10:30:00Z"
}
Archives a group. This is a soft delete: the group’s status changes to ARCHIVED, and it is excluded from list results by default. Pass include_archived=true on the list endpoint to see archived groups. Archived groups retain their data but cannot be modified. Balances, members, and state are preserved for auditing.
For usage patterns and examples, see the Groups guide.

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header.

Path Parameters

​
id
string<uuid>
required

Group ID

Response

Group archived

​
created_at
string<date-time>

When this group was created

Example:

"2024-01-15T10:30:00Z"

​
deleted_at
string<date-time>

When the group was archived (present only if archived)

​
id
string<uuid>

Unique identifier for this group

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string

Display name of the group

Example:

"Sales Team"

​
status
string

Lifecycle status: ACTIVE or ARCHIVED

Example:

"ACTIVE"

​
updated_at
string<date-time>

When this group was last updated

Example:

"2024-01-15T10:30:00Z"