Kodkila Developers

GET/eventsList events (public)
POST/eventsCreate an event (multipart; first image = cover)
PATCH/events/{id}Update an event (owner only)
DELETE/events/{id}Delete an event (owner only, soft)
GET/events/{id}/attendeesRSVP counts (going, interested) and yours; the event's owner also gets the names
POST/events/{id}/invitesInvite profiles of the event's channel: { profile_ids: string[] } (max 50; the host, or anyone going). Each person is invited once.
PUT/events/{id}/rsvpReply to an event: { status: "going" | "interested" }
DELETE/events/{id}/rsvpTake back your reply to an event
POST/events/{id}/viewRecord a view (deduped per profile / 24h)
GET/events/{idOrSlug}One event by id or slug (public)
GET/events/categoriesEvent categories
GET/events/myMy events (includes drafts)
GET/events/trendingTrending events (engagement-ranked, public)

List events (public)

GET/events

Public: no sign-in needed.

Parameters

Name	Type	Description
user_profile_id	string, query
page	string, query
limit	string, query
q	string, query
city	string, query
category	string, query
tags	string, query
from	string, query
to	string, query
is_free	string, query
price_min	string, query
price_max	string, query
sort	string, query
include_past	string, query
featured	string, query
active_profile_id	string, query
x-ref	string, header

Response

200. The payload in data is not described in the spec yet.

Create an event (multipart; first image = cover)

POST/events

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
x-ref	string, header

Request body application/json

Field	Type	Description
titlerequired	string	At least 3 characters, at most 255 characters. Example: "Sunburn Arena ft. Alan Walker"
start_atrequired	string	ISO-8601 with offset. Required. Stored verbatim. Example: "2026-11-02T18:30:00+05:30"
end_at	string	Example: "2026-11-03T00:00:00+05:30"
summary	string	At most 255 characters.
description	string
timezone	string	At most 255 characters. Example: "Asia/Kolkata"
duration_text	string	At most 255 characters. Example: "4 hours"
all_day	string	Example: "false"
venue_name	string	At most 255 characters.
address	string
city	string	At most 255 characters.
state	string	At most 255 characters.
country	string	At most 255 characters.
latitude	string	Example: "28.4595"
longitude	string	Example: "77.0266"
is_online	string	Example: "false"
online_url	string
category_id	string	category uuid
tags	object	CSV "a,b" or JSON array
price_from	string	Example: "1499"
price_to	string	Example: "4999"
currency	string	At most 255 characters. Example: "INR"
capacity	string	Example: "5000"
age_limit	string	At most 255 characters.
organizer_name	string	At most 255 characters.
highlights	object	JSON array of strings
status	string	One of: "draft", "published".
active_profile_id	string	authoring profile uuid

Response

201. The payload in data is not described in the spec yet.

Update an event (owner only)

PATCH/events/{id}

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
idrequired	string, path

Request body application/json

Field	Type	Description
title	string	At least 3 characters, at most 255 characters.
start_at	string
end_at	string
summary	string	At most 255 characters.
description	string
timezone	string	At most 255 characters.
duration_text	string	At most 255 characters.
all_day	string
venue_name	string	At most 255 characters.
address	string
city	string	At most 255 characters.
state	string	At most 255 characters.
country	string	At most 255 characters.
latitude	string
longitude	string
is_online	string
online_url	string
category_id	string
tags	object
price_from	string
price_to	string
currency	string	At most 255 characters.
capacity	string
age_limit	string	At most 255 characters.
organizer_name	string	At most 255 characters.
highlights	object
status	string	One of: "draft", "published", "cancelled", "postponed".
active_profile_id	string

Response

200. The payload in data is not described in the spec yet.

Delete an event (owner only, soft)

DELETE/events/{id}

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
idrequired	string, path

Response

200. The payload in data is not described in the spec yet.

RSVP counts (going, interested) and yours; the event's owner also gets the names

GET/events/{id}/attendees

Public: no sign-in needed.

Parameters

Name	Type	Description
idrequired	string, path
active_profile_idrequired	string, query

Response

200. The payload in data is not described in the spec yet.

Invite profiles of the event's channel: { profile_ids: string[] } (max 50; the host, or anyone going). Each person is invited once.

POST/events/{id}/invites

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
idrequired	string, path
active_profile_idrequired	string, query

Response

201. The payload in data is not described in the spec yet.

Reply to an event: { status: "going" | "interested" }

PUT/events/{id}/rsvp

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
idrequired	string, path
active_profile_idrequired	string, query

Response

200. The payload in data is not described in the spec yet.

Take back your reply to an event

DELETE/events/{id}/rsvp

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
idrequired	string, path
active_profile_idrequired	string, query

Response

200. The payload in data is not described in the spec yet.

Record a view (deduped per profile / 24h)

POST/events/{id}/view

Public: no sign-in needed.

Parameters

Name	Type	Description
idrequired	string, path
active_profile_idrequired	string, query

Response

200. The payload in data is not described in the spec yet.

One event by id or slug (public)

GET/events/{idOrSlug}

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
idOrSlugrequired	string, path
x-ref	string, header
active_profile_idrequired	string, query

Response

200. The payload in data is not described in the spec yet.

Event categories

GET/events/categories

Public: no sign-in needed.

Parameters

Name	Type	Description
x-ref	string, header

Response

200. The payload in data is not described in the spec yet.

My events (includes drafts)

GET/events/my

Needs a signed-in user (Bearer token or access_token cookie).

Parameters

Name	Type	Description
statusrequired	string, query
pagerequired	string, query
limitrequired	string, query
active_profile_idrequired	string, query

Response

200. The payload in data is not described in the spec yet.

GET/events/trending

Public: no sign-in needed.

Parameters

Name	Type	Description
user_profile_id	string, query
page	string, query
limit	string, query
q	string, query
city	string, query
category	string, query
tags	string, query
from	string, query
to	string, query
is_free	string, query
price_min	string, query
price_max	string, query
sort	string, query
include_past	string, query
featured	string, query
active_profile_id	string, query
x-ref	string, header

Response

200. The payload in data is not described in the spec yet.

Events

List events (public)

Parameters

Response

Create an event (multipart; first image = cover)

Parameters

Request body application/json

Response

Update an event (owner only)

Parameters

Request body application/json

Response

Delete an event (owner only, soft)

Parameters

Response

RSVP counts (going, interested) and yours; the event's owner also gets the names

Parameters

Response

Invite profiles of the event's channel: { profile_ids: string[] } (max 50; the host, or anyone going). Each person is invited once.

Parameters

Response

Reply to an event: { status: "going" | "interested" }

Parameters

Response

Take back your reply to an event

Parameters

Response

Record a view (deduped per profile / 24h)

Parameters

Response

One event by id or slug (public)

Parameters

Response

Event categories

Parameters

Response

My events (includes drafts)

Parameters

Response

Trending events (engagement-ranked, public)

Parameters

Response