Community Events API

The Community Events API covers the full lifecycle of community events: creating, managing, RSVPing, browsing, and exporting. All data is scoped to your tenant.

Base path: https://api.ainative.studio/api/v1/community-events

Authentication: All endpoints require Authorization: Bearer <your_api_key> unless noted otherwise.

---

Event CRUD

Create an event

POST /api/v1/community-events/

Create a new community event. The authenticated user becomes the event creator.

Request body

{
  "title": "AI Builders Meetup — May 2026",
  "description": "Monthly meetup for AI builders in San Francisco.",
  "start_time": "2026-05-20T18:00:00Z",
  "end_time": "2026-05-20T21:00:00Z",
  "location": "Hack the Lab, 123 Market St, San Francisco",
  "event_type": "in_person",
  "capacity": 80,
  "group_id": null
}

Field	Type	Required	Description
title	string	Yes	Event title
description	string	No	Event description
start_time	datetime (ISO 8601)	Yes	Event start time (UTC)
end_time	datetime (ISO 8601)	No	Event end time (UTC)
location	string	No	Physical address or meeting link
event_type	string	No	virtual, in_person, or hybrid
capacity	integer	No	Maximum number of attendees (null = unlimited)
group_id	string (UUID)	No	Attach event to a group

Response 201 Created

{
  "id": "abc12345-0000-0000-0000-000000000001",
  "title": "AI Builders Meetup — May 2026",
  "description": "Monthly meetup for AI builders in San Francisco.",
  "start_time": "2026-05-20T18:00:00Z",
  "end_time": "2026-05-20T21:00:00Z",
  "location": "Hack the Lab, 123 Market St, San Francisco",
  "event_type": "in_person",
  "capacity": 80,
  "status": "scheduled",
  "creator_id": "550e8400-e29b-41d4-a716-446655440000",
  "tenant_id": "tenant-uuid-here",
  "group_id": null,
  "created_at": "2026-04-25T14:00:00Z",
  "updated_at": "2026-04-25T14:00:00Z"
}

Errors

Code	Reason
400	Invalid dates, missing required fields, or user has no tenant

Example

curl -X POST https://api.ainative.studio/api/v1/community-events/ \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "AI Builders Meetup — May 2026",
    "start_time": "2026-05-20T18:00:00Z",
    "event_type": "in_person",
    "capacity": 80
  }'

import requests

resp = requests.post(
    "https://api.ainative.studio/api/v1/community-events/",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "title": "AI Builders Meetup — May 2026",
        "start_time": "2026-05-20T18:00:00Z",
        "event_type": "in_person",
        "capacity": 80,
    }
)
event = resp.json()
print(f"Created event: {event['id']}")

---

List events

GET /api/v1/community-events/

List community events with optional filtering and pagination.

Query parameters

Parameter	Type	Default	Description
filter_type	string	—	upcoming, past, or my_events
group_id	string (UUID)	—	Filter by group ID
limit	integer	50	Max results (1–100)
offset	integer	0	Pagination offset

Response 200 OK

{
  "total": 23,
  "offset": 0,
  "limit": 50,
  "has_more": false,
  "events": [
    {
      "id": "abc12345-0000-0000-0000-000000000001",
      "title": "AI Builders Meetup — May 2026",
      "start_time": "2026-05-20T18:00:00Z",
      "event_type": "in_person",
      "status": "scheduled",
      "capacity": 80
    }
  ]
}

---

Get event details

GET /api/v1/community-events/{event_id}

Get full details for a specific event.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Response 200 OK

Returns a full EventResponse object (same shape as the create response).

Errors

Code	Reason
404	Event not found or outside your tenant

---

Update an event

PATCH /api/v1/community-events/{event_id}

Update an existing event. Only the creator can update their event.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Request body

Send only the fields you want to update:

{
  "title": "AI Builders Meetup — May 2026 (Updated)",
  "capacity": 100
}

Response 200 OK

Returns the updated EventResponse object.

Errors

Code	Reason
403	Authenticated user is not the event creator
404	Event not found

---

Delete (cancel) an event

DELETE /api/v1/community-events/{event_id}

Cancel an event. Only the creator can delete their event. This marks the event as cancelled rather than permanently deleting it.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Response 204 No Content

Errors

Code	Reason
403	Authenticated user is not the event creator
404	Event not found

---

RSVP operations

RSVP to an event

POST /api/v1/community-events/{event_id}/rsvp

Create or update your RSVP for an event.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Request body

{
  "status": "going",
  "response_message": "Looking forward to it!"
}

Field	Type	Required	Description
status	string	Yes	going, interested, or not_going
response_message	string	No	Optional message to the organizer

Response 201 Created

{
  "id": "rsvp-uuid-here",
  "event_id": "abc12345-0000-0000-0000-000000000001",
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "going",
  "response_message": "Looking forward to it!",
  "created_at": "2026-04-25T14:30:00Z"
}

Errors

Code	Reason
400	Event is at capacity (for going status), or event is cancelled
404	Event not found

Example

curl -X POST https://api.ainative.studio/api/v1/community-events/abc12345-0000-0000-0000-000000000001/rsvp \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "going"}'

resp = requests.post(
    "https://api.ainative.studio/api/v1/community-events/abc12345-0000-0000-0000-000000000001/rsvp",
    headers={"Authorization": f"Bearer {api_key}"},
    json={"status": "going", "response_message": "Looking forward to it!"}
)

---

Update an RSVP

PATCH /api/v1/community-events/rsvps/{rsvp_id}

Change your RSVP status. Users can only update their own RSVPs.

Path parameters

Parameter	Type	Required	Description
rsvp_id	string (UUID)	Yes	RSVP ID

Request body

{
  "status": "not_going"
}

Response 200 OK

Returns the updated RSVPResponse object.

Errors

Code	Reason
400	Event is at capacity when changing to going
403	You do not own this RSVP
404	RSVP not found

---

Attendee and RSVP lists

Get event attendees

GET /api/v1/community-events/{event_id}/attendees

Get attendees for an event with optional RSVP status filter.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Query parameters

Parameter	Type	Default	Description
status_filter	string	—	Filter by RSVP status: going, interested, or not_going

Response 200 OK

{
  "total": 55,
  "going_count": 42,
  "interested_count": 10,
  "not_going_count": 3,
  "attendees": [
    {
      "user_id": "550e8400-e29b-41d4-a716-446655440000",
      "rsvp_id": "rsvp-uuid-here",
      "status": "going",
      "response_message": "Looking forward to it!",
      "rsvp_created_at": "2026-04-25T14:30:00Z"
    }
  ]
}

---

Get event RSVPs (paginated)

GET /api/v1/community-events/{event_id}/rsvps

Get RSVPs with pagination and optional status filtering.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Query parameters

Parameter	Type	Default	Description
status_filter	string	—	going, interested, or not_going
limit	integer	50	Max results (1–100)
offset	integer	0	Pagination offset

Response 200 OK

Same shape as the attendees response, with pagination metadata.

---

My events

Get my events

GET /api/v1/community-events/my-events

Get events the authenticated user has RSVP'd to.

Query parameters

Parameter	Type	Default	Description
upcoming_only	boolean	true	Only return future events
status_filter	string	—	Filter by RSVP status
limit	integer	20	Max results (1–100)
offset	integer	0	Pagination offset

Response 200 OK

{
  "total": 4,
  "offset": 0,
  "limit": 20,
  "has_more": false,
  "events": [
    {
      "id": "abc12345-0000-0000-0000-000000000001",
      "title": "AI Builders Meetup — May 2026",
      "start_time": "2026-05-20T18:00:00Z",
      "status": "scheduled"
    }
  ]
}

---

Event discovery

Browse upcoming events

GET /api/v1/community-events/browse

Discover upcoming events with filtering and sorting. Returns only events with status=scheduled and start_time >= now.

Query parameters

Parameter	Type	Default	Description
event_type	string	—	virtual, in_person, or hybrid
group_id	string (UUID)	—	Filter to a specific group
sort_by	string	start_time	Sort field: start_time or attendee_count
sort_order	string	asc	Sort direction: asc or desc
limit	integer	20	Max results (1–100)
offset	integer	0	Pagination offset

Response 200 OK

{
  "total": 18,
  "offset": 0,
  "limit": 20,
  "has_more": false,
  "events": [
    {
      "id": "abc12345-0000-0000-0000-000000000001",
      "title": "AI Builders Meetup — May 2026",
      "start_time": "2026-05-20T18:00:00Z",
      "event_type": "in_person",
      "location": "San Francisco"
    }
  ]
}

Example

# Browse in-person upcoming events, soonest first
curl "https://api.ainative.studio/api/v1/community-events/browse?event_type=in_person&sort_by=start_time&sort_order=asc" \
  -H "Authorization: Bearer $API_KEY"

resp = requests.get(
    "https://api.ainative.studio/api/v1/community-events/browse",
    headers={"Authorization": f"Bearer {api_key}"},
    params={
        "event_type": "in_person",
        "sort_by": "start_time",
        "sort_order": "asc",
        "limit": 20
    }
)
events = resp.json()["events"]

---

iCal export

Export event to iCal

GET /api/v1/community-events/{event_id}/export/ical

Export an event as an iCal (.ics) file, compatible with Google Calendar, Apple Calendar, and Outlook.

Path parameters

Parameter	Type	Required	Description
event_id	string (UUID)	Yes	Event ID

Response 200 OK

{
  "ical_content": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\n...",
  "filename": "AI_Builders_Meetup_May_2026_abc12345.ics"
}

Field	Type	Description
ical_content	string	iCal-formatted string content
filename	string	Suggested filename derived from the event title and ID

Example

resp = requests.get(
    f"https://api.ainative.studio/api/v1/community-events/{event_id}/export/ical",
    headers={"Authorization": f"Bearer {api_key}"}
)
data = resp.json()
with open(data["filename"], "w") as f:
    f.write(data["ical_content"])

---

Comments

Comments are stored in ZeroDB and can be attached to any content type (videos, articles, tutorials, etc.).

Post a comment

POST /api/v1/community/comments

Auth required. Post a comment on a content item. Content goes through optional moderation if enabled on your tenant.

Request body

{
  "content_type": "video",
  "content_id": 123,
  "comment": "Great tutorial! Very helpful."
}

Field	Type	Required	Description
content_type	string	Yes	Type of content: video, article, tutorial, etc.
content_id	integer	Yes	Numeric ID of the content item
comment	string	Yes	Comment text (1–5000 characters)

Response 200 OK

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": "650e8400-e29b-41d4-a716-446655440001",
  "user_name": "Alice Chen",
  "user_avatar": "https://cdn.ainative.studio/avatars/alice.jpg",
  "content_type": "video",
  "content_id": 123,
  "comment": "Great tutorial! Very helpful.",
  "created_at": "2026-04-25T14:45:00Z",
  "updated_at": null
}

Errors

Code	Reason
400	Comment rejected by content moderation

Get comments

GET /api/v1/community/comments/{content_type}/{content_id}

Public endpoint — no auth required. Get comments for a content item, sorted newest first.

Path parameters

Parameter	Type	Required	Description
content_type	string	Yes	Content type (e.g., video)
content_id	integer	Yes	Content item ID

Query parameters

Parameter	Type	Default	Description
limit	integer	50	Max comments to return (1–100)
offset	integer	0	Pagination offset

Response 200 OK

{
  "comments": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "650e8400-e29b-41d4-a716-446655440001",
      "user_name": "Alice Chen",
      "user_avatar": null,
      "content_type": "video",
      "content_id": 123,
      "comment": "Great tutorial! Very helpful.",
      "created_at": "2026-04-25T14:45:00Z",
      "updated_at": null
    }
  ],
  "total": 7,
  "limit": 50,
  "offset": 0
}

Delete a comment

DELETE /api/v1/community/comments/{comment_id}

Auth required. Delete a comment. Users can delete their own comments; admins can delete any comment.

Path parameters

Parameter	Type	Required	Description
comment_id	string (UUID)	Yes	Comment UUID

Response 200 OK

{
  "success": true,
  "message": "Comment 550e8400-e29b-41d4-a716-446655440000 deleted successfully"
}

Errors

Code	Reason
403	You do not own this comment and are not an admin
404	Comment not found