Projects

List projects

List all projects in the community. Paginated. Filter by status, type, and/or creation date range (created_after / created_before). Pass ?expand=script to include script.blocks on each item (adds extra DB queries per project).

get/v1/communities/{communityId}/projects

Request

  • Base URL: https://api.subo.ai
  • URL: https://api.subo.ai/v1/communities/{communityId}/projects
  • Auth: API key in header X-API-Key

Path parameters

communityIdstring required

Community ID (Discord guild snowflake, serialized as string)

Query parameters

status'active' | 'inactive'

Return only projects with this status.

type'convo' | 'poll'

Return only projects of this type.

created_afterstring date-time
Example:2025-01-01T00:00:00Z

Return only projects created at or after this ISO 8601 datetime (e.g. 2025-01-01T00:00:00Z). Assumed UTC if no timezone is specified.

created_beforestring date-time
Example:2025-12-31T23:59:59Z

Return only projects created at or before this ISO 8601 datetime (e.g. 2025-12-31T23:59:59Z). Assumed UTC if no timezone is specified.

pageinteger
per_pageinteger
expand'script'

Pass script to include script.blocks on every item in the response.

Response

Paginated list of projects

Changes

No recorded changes to this operation across all 1 revision of this API.