Social calendar

The dated events daily media generation makes graphics for: the ones shared with every workspace, the workspace's own, and the design template each is drawn from.

List calendar events

GET

https://api.genuineai.app/api/v1

/admin/calendar-events

The events daily media generation picks from, earliest first. ce_source says where each came from: system events are shared with every workspace and can be hidden but not edited, feed events come from the workspace's own calendar subscription, and custom events were added here. Hidden events are listed too, flagged ce_hidden, so they can be restored.

List calendar events › query Parameters

cursor

string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$

from

string · date-time

limit

integer

offset

integer · min: 0

sort

string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

to

string · date-time

List calendar events › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List calendar events › Responses

Success

CalendarEvent[] · required

has_more

boolean · required

Whether more rows exist past this page.

next_cursor

string | null · required

Pass back as cursor for the next page. Null on the last page.

Add a calendar event

POST

https://api.genuineai.app/api/v1

/admin/calendar-events

Adds an event of the workspace's own. Pass ce_template to have its graphic drawn from that design template.

Add a calendar event › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Add a calendar event › Request Body

ce_summary

string · minLength: 1 · maxLength: 200 · required

ce_start

string · date-time · required

ce_description

string · maxLength: 4000

ce_location

string · maxLength: 300

ce_end

string · date-time

ce_template

string · uuid

Add a calendar event › Responses

Created

A dated event on the workspace's social calendar, with what the workspace decided about it.

CalendarEvent

ce_id

string · uuid

ce_summary

string

ce_description

string

ce_location

string

ce_start

string · date

ce_end

string · date

ce_source

string · enum

Enum values:

system

feed

custom

ce_hidden

boolean

ce_template

string · uuid

ce_template_name

string

POST/admin/calendar-events

curl https://api.genuineai.app/api/v1/admin/calendar-events \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-Id: <string>' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "ce_summary": "ce_summary",
  "ce_start": "2024-08-25T15:00:00Z",
  "ce_description": "ce_description",
  "ce_location": "ce_location",
  "ce_end": "2024-08-25T15:00:00Z",
  "ce_template": "00000000-0000-0000-0000-000000000000"
}'

Example Request Body

{
  "ce_summary": "ce_summary",
  "ce_start": "2024-08-25T15:00:00Z",
  "ce_description": "ce_description",
  "ce_location": "ce_location",
  "ce_end": "2024-08-25T15:00:00Z",
  "ce_template": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "ce_id": "00000000-0000-0000-0000-000000000000",
  "ce_summary": "ce_summary",
  "ce_description": "ce_description",
  "ce_location": "ce_location",
  "ce_start": "2024-08-25",
  "ce_end": "2024-08-25",
  "ce_source": "system",
  "ce_hidden": true,
  "ce_template": "00000000-0000-0000-0000-000000000000",
  "ce_template_name": "ce_template_name"
}

json

application/json

Delete a calendar event

DELETE

https://api.genuineai.app/api/v1

/admin/calendar-events/{id}

Deletes an event the workspace added. Shared and subscribed events are hidden instead.

Delete a calendar event › path Parameters

id

string · uuid · required

Delete a calendar event › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete a calendar event › Responses

Success. No content.

No data returned

Edit a calendar event

PATCH

https://api.genuineai.app/api/v1

/admin/calendar-events/{id}

ce_hidden and ce_template apply to any event. The title, dates, location and description can only be changed on an event the workspace added itself. A template assigned here replaces AI image generation for that event: the template's layout, fonts, colors and images stay as approved, and only its text is written.

Edit a calendar event › path Parameters

id

string · uuid · required

Edit a calendar event › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Edit a calendar event › Request Body optional

ce_summary

string · minLength: 1 · maxLength: 200

ce_start

string · date-time

ce_hidden

boolean

ce_description

string · maxLength: 4000

ce_location

string · maxLength: 300

ce_end

string · date-time

ce_template

string · uuid

Edit a calendar event › Responses

Success

A dated event on the workspace's social calendar, with what the workspace decided about it.

CalendarEvent

ce_id

string · uuid

ce_summary

string

ce_description

string

ce_location

string

ce_start

string · date

ce_end

string · date

ce_source

string · enum

Enum values:

system

feed

custom

ce_hidden

boolean

ce_template

string · uuid

ce_template_name

string

PATCH/admin/calendar-events/{id}

curl https://api.genuineai.app/api/v1/admin/calendar-events/:id \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-Id: <string>' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "ce_summary": "ce_summary",
  "ce_start": "2024-08-25T15:00:00Z",
  "ce_hidden": true,
  "ce_description": "ce_description",
  "ce_location": "ce_location",
  "ce_end": "2024-08-25T15:00:00Z",
  "ce_template": "00000000-0000-0000-0000-000000000000"
}'

Example Request Body

{
  "ce_summary": "ce_summary",
  "ce_start": "2024-08-25T15:00:00Z",
  "ce_hidden": true,
  "ce_description": "ce_description",
  "ce_location": "ce_location",
  "ce_end": "2024-08-25T15:00:00Z",
  "ce_template": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "ce_id": "00000000-0000-0000-0000-000000000000",
  "ce_summary": "ce_summary",
  "ce_description": "ce_description",
  "ce_location": "ce_location",
  "ce_start": "2024-08-25",
  "ce_end": "2024-08-25",
  "ce_source": "system",
  "ce_hidden": true,
  "ce_template": "00000000-0000-0000-0000-000000000000",
  "ce_template_name": "ce_template_name"
}

json

application/json

Social connections

List calendar events

GET

https://api.genuineai.app/api/v1

/admin/calendar-events

List calendar events › query Parameters

cursor

string · maxLength: 512 · pattern: ^[A-Za-z0-9_-]+$

from

string · date-time

limit

integer

offset

integer · min: 0

sort

string · minLength: 1 · maxLength: 64 · pattern: ^-?[a-z0-9_]+$

to

string · date-time

List calendar events › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

List calendar events › Responses

Success

CalendarEvent[] · required

has_more

boolean · required

Whether more rows exist past this page.

next_cursor

string | null · required

Pass back as cursor for the next page. Null on the last page.

Add a calendar event

POST

https://api.genuineai.app/api/v1

/admin/calendar-events

Adds an event of the workspace's own. Pass ce_template to have its graphic drawn from that design template.

Add a calendar event › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Add a calendar event › Request Body

ce_summary

string · minLength: 1 · maxLength: 200 · required

ce_start

string · date-time · required

ce_description

string · maxLength: 4000

ce_location

string · maxLength: 300

ce_end

string · date-time

ce_template

string · uuid

Add a calendar event › Responses

Created

A dated event on the workspace's social calendar, with what the workspace decided about it.

CalendarEvent

ce_id

string · uuid

ce_summary

string

ce_description

string

ce_location

string

ce_start

string · date

ce_end

string · date

ce_source

string · enum

Enum values:

system

feed

custom

ce_hidden

boolean

ce_template

string · uuid

ce_template_name

string

Delete a calendar event

DELETE

https://api.genuineai.app/api/v1

/admin/calendar-events/{id}

Deletes an event the workspace added. Shared and subscribed events are hidden instead.

Delete a calendar event › path Parameters

id

string · uuid · required

Delete a calendar event › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Delete a calendar event › Responses

Success. No content.

No data returned

Edit a calendar event

PATCH

https://api.genuineai.app/api/v1

/admin/calendar-events/{id}

Edit a calendar event › path Parameters

id

string · uuid · required

Edit a calendar event › Headers

X-Tenant-Id

string · uuid · required

The workspace this request acts in. Every row the API returns is isolated to it at the database layer by row-level security.

Edit a calendar event › Request Body optional

ce_summary

string · minLength: 1 · maxLength: 200

ce_start

string · date-time

ce_hidden

boolean

ce_description

string · maxLength: 4000

ce_location

string · maxLength: 300

ce_end

string · date-time

ce_template

string · uuid

Edit a calendar event › Responses

Success

A dated event on the workspace's social calendar, with what the workspace decided about it.

CalendarEvent

ce_id

string · uuid

ce_summary

string

ce_description

string

ce_location

string

ce_start

string · date

ce_end

string · date

ce_source

string · enum

Enum values:

system

feed

custom

ce_hidden

boolean

ce_template

string · uuid

ce_template_name

string