Skip to content
calternal docs

Log a past Event

POST
/api/v1/calendar/events/{id}/log-this
curl --request POST \
  --url https://example.com/api/v1/calendar/events/example/log-this \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "end": null, "start": null }'

Requires a signed-in User. It adds a link to the past Event in the Daily note for its local date. It returns 201 when it creates a Log entry, 200 when the entry already exists, or 409 when the Event is not in the past. Route: /api/v1/calendar/events/{id}/log-this. Inputs: id. Do not automatically replay this operation after an uncertain result.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Cached Event ID or expanded occurrence ID

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
end

Optional local HH:MM override for an Event’s end.

string | null
start

Optional local HH:MM override for an Event’s start.

string | null

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
object
created
required
boolean
entry
required
object
date
required
string
end
string | null
id
required
string
start
required
string
timezone
string | null
title
required
string
Examplegenerated
{
  "created": true,
  "entry": {
    "date": "example",
    "end": "example",
    "id": "example",
    "start": "example",
    "timezone": "example",
    "title": "example"
  }
}

201

Section titled “201”
Media typeapplication/json
object
created
required
boolean
entry
required
object
date
required
string
end
string | null
id
required
string
start
required
string
timezone
string | null
title
required
string
Examplegenerated
{
  "created": true,
  "entry": {
    "date": "example",
    "end": "example",
    "id": "example",
    "start": "example",
    "timezone": "example",
    "title": "example"
  }
}

404

Section titled “404”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}

409

Section titled “409”
Media typeapplication/json

The standard API error response: { "error": { ... } }.

object
error
required

Error details.

object
code
required

Stable machine-readable code.

string
Allowed values: bad_request unauthorized forbidden not_found conflict name_conflict_case name_too_long push_endpoint_rejected too_many_requests internal service_unavailable
details
One of:

Optional field or operation details.

object
key
additional properties
string
message
required

Safe text for logs or a user-facing error message.

string
Example
{
  "error": {
    "code": "bad_request"
  }
}