Servers Playground How we check Submit a server

Accredible MCP by usefulapi

Working · 2.5 s

io.usefulapi/accrediblev1.4.0 Domain verified

Read Accredible credentials, groups, designs, analytics, skills; issue one credential as a draft.

Education

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://accredible.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

accredible_get_credential

One credential in full: recipient, group, issue and expiry dates, published state, public URL, evidence items, references, custom attributes and skills. The id is the numeric credential id or the custom id your organization set. GET /v1/credentials/{id}.

idstring, required

Credential id (numeric) or the custom credential id (license_id).

Accredible MCP by usefulapi MCP server | mcptry

Tools (19)

accredible_get_credential

read-only

Argument	Type	Description
id*	string	Credential id (numeric) or the custom credential id (license_id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Credential id (numeric) or the custom credential id (license_id)."
    }
  }
}

accredible_get_credential_analytics

The analytics events of one credential (recipient views, shares, privacy changes, verification and so on) with timestamps. Read-only despite being a POST. POST /v1/credentials/analytics/{id}.

read-only

Argument	Type	Description
id*	string	Credential id (numeric) or the custom credential id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1,
      "description": "Credential id (numeric) or the custom credential id."
    }
  }
}

accredible_get_data_export

One data export: department, status and, once completed, the download links of its files. GET /v1/data_exports/{id}.

read-only

Argument	Type	Description
id*	integer	Data export id (accredible_list_data_exports).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Data export id (accredible_list_data_exports).",
      "exclusiveMinimum": 0
    }
  }
}

accredible_get_department

One department: name, description, URL, branding and meta_data. GET /v1/departments/{department_id}.

read-only

Argument	Type	Description
department_id*	integer	Department id (accredible_search_departments lists them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "department_id"
  ],
  "properties": {
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Department id (accredible_search_departments lists them).",
      "exclusiveMinimum": 0
    }
  }
}

accredible_get_design

One badge or certificate design with its settings. GET /v1/designs/{design_id}.

read-only

Argument	Type	Description
design_id*	integer	Design id (accredible_search_designs or a group's design_id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "design_id"
  ],
  "properties": {
    "design_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Design id (accredible_search_designs or a group's design_id).",
      "exclusiveMinimum": 0
    }
  }
}

accredible_get_group

One group in full: name, course name and description, learning outcomes, design ids, language, skills and dates. GET /v1/issuer/groups/{group_id}.

read-only

Argument	Type	Description
group_id*	integer	Group id (accredible_search_groups lists them).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "group_id"
  ],
  "properties": {
    "group_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Group id (accredible_search_groups lists them).",
      "exclusiveMinimum": 0
    }
  }
}

accredible_get_issuer

The Accredible issuer (organization) behind the API key: id, name, e-mail, remaining credential credits (certificate_left), language and URL. Good first call. GET /v1/issuer/details.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

accredible_get_team_member

One team member of the account: name, e-mail and permissions per department. Which members are visible depends on the key (an account-wide key sees all, a department key its own department). GET /v1/team_members/{id}.

read-only

Argument	Type	Description
id*	integer	Team member id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Team member id.",
      "exclusiveMinimum": 0
    }
  }
}

accredible_issue_credential

WRITE: creates ONE credential (badge or certificate) for ONE recipient in an existing group. By default it is created UNPUBLISHED (a draft: no e-mail is sent and no credit is used); publish it later in the Accredible Dashboard. With publish=true the credential is published immediately: Accredible then SENDS AN E-MAIL to the recipient (as configured in the group's e-mail settings) and uses one credential credit of the account; an account without credits keeps it unpublished. A sandbox-mode setting in the Dashboard overrides publish. Not idempotent: calling twice creates two credentials (set credential_id to your own unique id to be able to find it again). No evidence, references, bulk issuing, edits or deletes. POST /v1/credentials.

destructive

Argument	Type	Description
name	string	Credential/course name; required only when the group has no course name.
private	boolean	Make the credential private: visible only to the recipient after signing in to credential.net.
publish	boolean	Default false: create an unpublished draft (no e-mail). true: publish now, which e-mails the recipient and uses one credit.
complete	boolean	Whether the achievement is complete (default true); false marks it in progress.
group_id*	integer	The group the credential belongs to (accredible_search_groups); it supplies the design and course texts.

accredible_list_analytics

Account-wide credential analytics events (views, shares, downloads and similar), optionally for a date range, group or department. Paged (default 100 per page). GET /v1/analytics.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
end_date	string	Only events before this date (YYYY-MM-DD).
group_id	integer	Only events of credentials in this group.
page_size	integer	Results per page (default 100).
start_date	string	Only events after this date (YYYY-MM-DD).
department_id	integer	Only events of credentials in this department.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "end_date": {
      "type": "string",
      "description": "Only events before this date (YYYY-MM-DD)."
    },
    "group_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only events of credentials in this group.",
      "exclusiveMinimum": 0
    },
    "page_size": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Results per page (default 100)."
    },
    "start_date": {
      "type": "string",
      "description": "Only events after this date (YYYY-MM-DD)."
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only events of credentials in this department.",
      "exclusiveMinimum": 0
    }
  }
}

accredible_list_data_exports

Data exports of the departments the key can access: department, status (scheduled, processing, completed, errored) and download links of completed files. Exports are created in the Accredible Dashboard. GET /v1/data_exports.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

accredible_list_skill_frameworks

The skills frameworks (O*NET, ESCO, NACE or your own) enabled for a department, each with its published versions. Needs a plan that includes skills frameworks (otherwise HTTP 403 plan_not_entitled). Paged, max 10 per page. GET /v1/skill_frameworks.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
page_size	integer	Results per page, 1-10 (default 5).
department_id*	integer	Department to list frameworks for (required, also for department keys).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "department_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "page_size": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Results per page, 1-10 (default 5)."
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Department to list frameworks for (required, also for department keys).",
      "exclusiveMinimum": 0
    }
  }
}

accredible_search_attribute_keys

List the custom attribute keys (placeholders such as a grade or date that credential designs and e-mails merge in); useful to know which custom_attributes a credential can carry. Paged: pass meta.next_page as page. POST /v1/attribute_keys/search (a read-only search).

read-only

Argument	Type	Description
kind	string	Attribute kind.
name	string	Attribute key name.
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
page_size	integer	Results per page, 1-100 (default 50).
department_id	integer	Only keys of this department.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "enum": [
        "text",
        "date",
        "email",
        "image"
      ],
      "type": "string",
      "description": "Attribute kind."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Attribute key name."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 50)."
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only keys of this department.",
      "exclusiveMinimum": 0
    }
  }
}

accredible_search_collections

List collections (sets of groups shown together). Filters: ids, name (substring), public. Paged: pass meta.next_page as page. POST /v1/collections/search (a read-only search).

read-only

Argument	Type	Description
ids	array	Only these collection ids (UUIDs).
name	string	Part of the collection name.
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
public	boolean	true = only public collections, false = only non-public.
sort_by	string	Sort field.
page_size	integer	Results per page, 1-100 (default 50).
sort_order	string	Sort direction (default asc).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Only these collection ids (UUIDs)."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Part of the collection name."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "public": {
      "type": "boolean",
      "description": "true = only public collections, false = only non-public."
    },
    "sort_by": {
      "enum": [
        "name",
        "groups_count",
        "public"
      ],
      "type": "string",
      "description": "Sort field."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 50)."
    },
    "sort_order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction (default asc)."
    }
  }
}

accredible_search_credentials

Search issued credentials (badges and certificates) with filters that combine with AND, newest first by default. Returns id, uuid, encoded_id, recipient name/e-mail, group, issued_on, expired_on, published state (approve), whether the recipient opened or engaged, and meta. Paging: size + offset (first 10 000 results) OR cursor: when the reply has next_cursor pass it as cursor for the next page (cursor and offset cannot be combined). POST /v2/credentials/search (a read-only search).

read-only

Argument	Type	Description
size	integer	Results per page, 1-100 (default 50).
uuid	string	Credential UUID.
cursor	string	The next_cursor of the previous reply. Not with offset.
offset	integer	Records to skip (offset paging, max 9950). Not with cursor.
sort_by	string	Sort field (default: the API's order).
group_id	integer	Only credentials of this group (accredible_search_groups lists group ids).
published	boolean	true = only published credentials, false = only unpublished drafts; omit for both.

accredible_search_departments

List departments (independent organization units with their own designs, groups and branding). An account-wide key sees all, a department key only its own. Paged: pass meta.next_page as page. POST /v1/departments/search (a read-only search).

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
meta_data	object	Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.
page_size	integer	Results per page, 1-100 (default 50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "meta_data": {
      "type": "object",
      "description": "Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 50)."
    }
  }
}

accredible_search_designs

List badge and certificate designs, optionally by kind or meta_data. POST /v1/designs/search (a read-only search).

read-only

Argument	Type	Description
kind	string	Design kind, for example badge or certificate.
meta_data	object	Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1,
      "description": "Design kind, for example badge or certificate."
    },
    "meta_data": {
      "type": "object",
      "description": "Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  }
}

accredible_search_groups

Search groups (an achievement such as a course or qualification that credentials belong to). Filters combine with AND; name and course_name match partially. Returns id, name, course name and description, design ids, language and dates. Paged: pass meta.next_page as page. POST /v1/issuer/groups/search (a read-only search).

read-only

Argument	Type	Description
ids	array	Only these group ids.
name	string	Part of the group name.
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
meta_data	object	Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.
page_size	integer	Results per page, 1-100 (default 50).
course_name	string	Part of the course name.
department_id	integer	Only groups of this department (must be accessible to the key).
updated_after	string	Only groups updated after this date (YYYY-MM-DD).

accredible_search_skills

Search the skills of one published skills-framework version by name or the publisher's identifier (partial, case-insensitive, at least 2 characters). Paged, max 50 per page. GET /v1/skill_frameworks/{id}/versions/{version_id}/skills.

read-only

Argument	Type	Description
page	integer	Page number, 1-based (default 1). Use meta.next_page from the previous reply.
query*	string	Text to search for (min 2 characters).
page_size	integer	Results per page, 1-50 (default 50).
version_id*	integer	Version id from the framework's versions array.
framework_id*	integer	Skill framework id (accredible_list_skill_frameworks).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "framework_id",
    "version_id",
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "query": {
      "type": "string",
      "maxLength": 255,
      "minLength": 2,
      "description": "Text to search for (min 2 characters)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Results per page, 1-50 (default 50)."
    },
    "version_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Version id from the framework's versions array.",
      "exclusiveMinimum": 0
    },
    "framework_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Skill framework id (accredible_list_skill_frameworks).",
      "exclusiveMinimum": 0
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "group_id",
    "recipient_name",
    "recipient_email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Credential/course name; required only when the group has no course name."
    },
    "private": {
      "type": "boolean",
      "description": "Make the credential private: visible only to the recipient after signing in to credential.net."
    },
    "publish": {
      "type": "boolean",
      "description": "Default false: create an unpublished draft (no e-mail). true: publish now, which e-mails the recipient and uses one credit."
    },
    "complete": {
      "type": "boolean",
      "description": "Whether the achievement is complete (default true); false marks it in progress."
    },
    "group_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The group the credential belongs to (accredible_search_groups); it supplies the design and course texts.",
      "exclusiveMinimum": 0
    },
    "issued_on": {
      "type": "string",
      "description": "Issue date YYYY-MM-DD (default today)."
    },
    "meta_data": {
      "type": "object",
      "description": "Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "expired_on": {
      "type": "string",
      "description": "Expiry date YYYY-MM-DD (default none)."
    },
    "description": {
      "type": "string",
      "maxLength": 5000,
      "minLength": 1,
      "description": "Credential/course description; required only when the group has no course description."
    },
    "recipient_id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Your own id for the recipient (maps recipients to credentials across e-mail changes)."
    },
    "credential_id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Your own unique id for this credential (license_id); Accredible assigns one if omitted."
    },
    "recipient_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "The recipient's full name as printed on the credential."
    },
    "recipient_email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 320,
      "description": "The recipient's e-mail address (exactly one recipient)."
    },
    "custom_attributes": {
      "type": "object",
      "description": "Custom attribute values merged into the design, e.g. {\"Location\": \"London\"} (keys must exist: accredible_search_attribute_keys).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 1000
      }
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 50)."
    },
    "uuid": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Credential UUID."
    },
    "cursor": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1,
      "description": "The next_cursor of the previous reply. Not with offset."
    },
    "offset": {
      "type": "integer",
      "maximum": 9950,
      "minimum": 0,
      "description": "Records to skip (offset paging, max 9950). Not with cursor."
    },
    "sort_by": {
      "enum": [
        "id",
        "recipient_name",
        "group.name",
        "issued_on",
        "expired_on"
      ],
      "type": "string",
      "description": "Sort field (default: the API's order)."
    },
    "group_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only credentials of this group (accredible_search_groups lists group ids).",
      "exclusiveMinimum": 0
    },
    "published": {
      "type": "boolean",
      "description": "true = only published credentials, false = only unpublished drafts; omit for both."
    },
    "license_id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "The custom credential id your organization set when issuing."
    },
    "sort_order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction (default desc when sort_by is set)."
    },
    "issued_after": {
      "type": "string",
      "description": "Issued on or after this date (YYYY-MM-DD)."
    },
    "recipient_id": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "The recipient id your organization set when issuing."
    },
    "created_after": {
      "type": "string",
      "description": "Created on or after this date (YYYY-MM-DD)."
    },
    "expires_after": {
      "type": "string",
      "description": "Expires on or after this date (YYYY-MM-DD)."
    },
    "issued_before": {
      "type": "string",
      "description": "Issued on or before this date (YYYY-MM-DD)."
    },
    "updated_after": {
      "type": "string",
      "description": "Updated on or after this date (YYYY-MM-DD)."
    },
    "expires_before": {
      "type": "string",
      "description": "Expires on or before this date (YYYY-MM-DD)."
    },
    "recipient_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Exact recipient name."
    },
    "recipient_email": {
      "type": "string",
      "maxLength": 320,
      "minLength": 3,
      "description": "Exact recipient e-mail address."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Only these group ids."
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Part of the group name."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 1,
      "description": "Page number, 1-based (default 1). Use meta.next_page from the previous reply."
    },
    "meta_data": {
      "type": "object",
      "description": "Key/value strings you attached to the object's meta_data when you created it; matches objects carrying these pairs.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page, 1-100 (default 50)."
    },
    "course_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Part of the course name."
    },
    "department_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only groups of this department (must be accessible to the key).",
      "exclusiveMinimum": 0
    },
    "updated_after": {
      "type": "string",
      "description": "Only groups updated after this date (YYYY-MM-DD)."
    },
    "collection_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Only groups linked to any of these collection UUIDs."
    },
    "updated_before": {
      "type": "string",
      "description": "Only groups updated before this date (YYYY-MM-DD)."
    }
  }
}