Meetings and booking

GET`/v1/meetings`

List scheduled meetings

Permission: calendar:read

Parameters

Name	Type	Description
`from`	`query · string`
`to`	`query · string`
`limit`	`query · integer`

Response `200`

Name	Type	Description
`data` required	`object[]`
`data[].id` required	`string`
`data[].url` required	`string`
`data[].title` required	`string`
`data[].visibility` required	`"private" \| "public"`
`data[].status` required	`"scheduled" \| "live" \| "ended"`
`data[].created_at` required	`string`
`data[].expires_at` required	`string`
`data[].starts_at` required	`string \| null`
`data[].duration_min` required	`integer \| null`
`data[].invitees` required	`string[]`
`data[].langs` required	`string[]`
`data[].livemode` required	`boolean`	false for objects created with a kt_test_ key (simulator).

Example

curl

curl "https://api.kanutus.com/v1/meetings" \
  -H "Authorization: Bearer $KANUTUS_API_KEY"

Node.js

const res = await fetch("https://api.kanutus.com/v1/meetings", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Python

import os, uuid, requests

r = requests.request(
    "GET",
    "https://api.kanutus.com/v1/meetings",
    headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}"},
)
print(r.status_code, r.json())

Try it

Runs from your browser against the real API. Use a kt_test_ key: nothing is charged. The key stays in this tab only.

API key from query to query limit query

GET /v1/meetings

Responses by status

200 Meetings by start time

200

{
  "data": [
    {
      "id": "kqz-mbdt-wpa",
      "url": "https://example.com",
      "title": "string",
      "visibility": "private",
      "status": "scheduled",
      "created_at": "string",
      "expires_at": "string",
      "starts_at": "string",
      "duration_min": 0,
      "invitees": [
        "string"
      ],
      "langs": [
        "string"
      ],
      "livemode": true
    }
  ]
}

400 Invalid request

400 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 400,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

401 Missing, invalid, expired or revoked credential

401 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 401,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

403 Missing permission, blocked or not allowed

403 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 403,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

429 Rate limit exceeded (see RateLimit-* and Retry-After headers)

429 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 429,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

POST`/v1/meetings`

Schedule a meeting (room with date, invitees and languages)

Permission: calendar:write

Parameters

Name	Type	Description
`idempotency-key` required	`header · string`	Unique key per create request; retries with the same key return the same result.

Request body

Name	Type	Description
`title` required	`string`	length 1–120
`starts_at` required	`string`
`duration_min`	`integer`	5…720 · default 30
`invitees`	`string[]`
`langs`	`string[]`	Languages of the participants, e.g. ["pt", "ja"].
`visibility`	`"private" \| "public"`	default "private"

Response `201`

Name	Type	Description
`id` required	`string`
`url` required	`string`
`title` required	`string`
`visibility` required	`"private" \| "public"`
`status` required	`"scheduled" \| "live" \| "ended"`
`created_at` required	`string`
`expires_at` required	`string`
`starts_at` required	`string \| null`
`duration_min` required	`integer \| null`
`invitees` required	`string[]`
`langs` required	`string[]`
`livemode` required	`boolean`	false for objects created with a kt_test_ key (simulator).

Example

curl

curl -X POST "https://api.kanutus.com/v1/meetings" \
  -H "Authorization: Bearer $KANUTUS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"title":"Revisão com Kenji","starts_at":"2026-10-12T13:00:00-03:00","duration_min":30,"invitees":[],"langs":[],"visibility":"private"}'

Node.js

const res = await fetch("https://api.kanutus.com/v1/meetings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"title":"Revisão com Kenji","starts_at":"2026-10-12T13:00:00-03:00","duration_min":30,"invitees":[],"langs":[],"visibility":"private"}),
});
console.log(res.status, await res.json());

Python

import os, uuid, requests

r = requests.request(
    "POST",
    "https://api.kanutus.com/v1/meetings",
    headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={"title":"Revisão com Kenji","starts_at":"2026-10-12T13:00:00-03:00","duration_min":30,"invitees":[],"langs":[],"visibility":"private"},
)
print(r.status_code, r.json())

Try it

Runs from your browser against the real API. Use a kt_test_ key: nothing is charged. The key stays in this tab only.

API key Request body (JSON)

POST /v1/meetings

Responses by status

201 Meeting scheduled; share url with invitees

201

{
  "id": "kqz-mbdt-wpa",
  "url": "https://example.com",
  "title": "string",
  "visibility": "private",
  "status": "scheduled",
  "created_at": "string",
  "expires_at": "string",
  "starts_at": "string",
  "duration_min": 0,
  "invitees": [
    "string"
  ],
  "langs": [
    "string"
  ],
  "livemode": true
}

400 Invalid request

400 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 400,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

401 Missing, invalid, expired or revoked credential

401 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 401,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

403 Missing permission, blocked or not allowed

403 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 403,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

409 Conflict (idempotency or state)

409 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 409,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

429 Rate limit exceeded (see RateLimit-* and Retry-After headers)

429 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 429,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

DELETE`/v1/meetings/{id}`

Cancel a scheduled meeting

Permission: calendar:write

Parameters

Name	Type	Description
`id` required	`path · string`

Response `200`

Name	Type	Description
`id` required	`string`
`url` required	`string`
`title` required	`string`
`visibility` required	`"private" \| "public"`
`status` required	`"scheduled" \| "live" \| "ended"`
`created_at` required	`string`
`expires_at` required	`string`
`starts_at` required	`string \| null`
`duration_min` required	`integer \| null`
`invitees` required	`string[]`
`langs` required	`string[]`
`livemode` required	`boolean`	false for objects created with a kt_test_ key (simulator).

Example

curl

curl -X DELETE "https://api.kanutus.com/v1/meetings/kqz-mbdt-wpa" \
  -H "Authorization: Bearer $KANUTUS_API_KEY"

Node.js

const res = await fetch("https://api.kanutus.com/v1/meetings/kqz-mbdt-wpa", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Python

import os, uuid, requests

r = requests.request(
    "DELETE",
    "https://api.kanutus.com/v1/meetings/kqz-mbdt-wpa",
    headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}"},
)
print(r.status_code, r.json())

Try it

Runs from your browser against the real API. Use a kt_test_ key: nothing is charged. The key stays in this tab only.

API key id path required

DELETE /v1/meetings/{id}

Responses by status

200 Canceled

200

{
  "id": "kqz-mbdt-wpa",
  "url": "https://example.com",
  "title": "string",
  "visibility": "private",
  "status": "scheduled",
  "created_at": "string",
  "expires_at": "string",
  "starts_at": "string",
  "duration_min": 0,
  "invitees": [
    "string"
  ],
  "langs": [
    "string"
  ],
  "livemode": true
}

400 Invalid request

400 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 400,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

401 Missing, invalid, expired or revoked credential

401 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 401,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

403 Missing permission, blocked or not allowed

403 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 403,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

404 Not found

404 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 404,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

429 Rate limit exceeded (see RateLimit-* and Retry-After headers)

429 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 429,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

GET`/v1/event-types`

List your booking links (event types)

Permission: calendar:read

Response `200`

Name	Type	Description
`data` required	`object[]`
`data[].id` required	`string`
`data[].title` required	`string`
`data[].duration_min` required	`integer`
`data[].page` required	`string`	Booking page slug (person or team)
`data[].slug` required	`string`
`data[].url` required	`string`
`data[].active` required	`boolean`

Example

curl

curl "https://api.kanutus.com/v1/event-types" \
  -H "Authorization: Bearer $KANUTUS_API_KEY"

Node.js

const res = await fetch("https://api.kanutus.com/v1/event-types", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Python

import os, uuid, requests

r = requests.request(
    "GET",
    "https://api.kanutus.com/v1/event-types",
    headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}"},
)
print(r.status_code, r.json())

Try it

Runs from your browser against the real API. Use a kt_test_ key: nothing is charged. The key stays in this tab only.

API key

GET /v1/event-types

Responses by status

200 Event types

200

{
  "data": [
    {
      "id": "string",
      "title": "string",
      "duration_min": 0,
      "page": "paulo",
      "slug": "30min",
      "url": "https://example.com",
      "active": true
    }
  ]
}

400 Invalid request

400 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 400,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

401 Missing, invalid, expired or revoked credential

401 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 401,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

403 Missing permission, blocked or not allowed

403 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 403,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

429 Rate limit exceeded (see RateLimit-* and Retry-After headers)

429 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 429,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

GET`/v1/event-types/{id}/slots`

Free times of a booking link

Permission: calendar:read

Parameters

Name	Type	Description
`id` required	`path · string`
`from`	`query · string`
`to`	`query · string`

Response `200`

Name	Type	Description
`tz` required	`string`	Host time zone
`duration_min` required	`integer`
`slots` required	`string[]`	Free start times (ISO 8601, UTC)
`full_days` required	`string[]`

Example

curl

curl "https://api.kanutus.com/v1/event-types/8f14e45f-ceea-4c8e-9b3a-2f1d5a7c3b10/slots" \
  -H "Authorization: Bearer $KANUTUS_API_KEY"

Node.js

const res = await fetch("https://api.kanutus.com/v1/event-types/8f14e45f-ceea-4c8e-9b3a-2f1d5a7c3b10/slots", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
  },
});
console.log(res.status, await res.json());

Python

import os, uuid, requests

r = requests.request(
    "GET",
    "https://api.kanutus.com/v1/event-types/8f14e45f-ceea-4c8e-9b3a-2f1d5a7c3b10/slots",
    headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}"},
)
print(r.status_code, r.json())

Try it

Runs from your browser against the real API. Use a kt_test_ key: nothing is charged. The key stays in this tab only.

API key id path required from query to query

GET /v1/event-types/{id}/slots

Responses by status

200 Free start times

200

{
  "tz": "string",
  "duration_min": 0,
  "slots": [
    "string"
  ],
  "full_days": [
    "string"
  ]
}

400 Invalid request

400 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 400,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

401 Missing, invalid, expired or revoked credential

401 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 401,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

403 Missing permission, blocked or not allowed

403 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 403,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

404 Not found

404 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 404,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

429 Rate limit exceeded (see RateLimit-* and Retry-After headers)

429 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 429,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

POST`/v1/bookings`

Book a time on a booking link (yours or someone else's)

Permission: calendar:write

Parameters

Name	Type	Description
`idempotency-key` required	`header · string`	Unique key per create request; retries with the same key return the same result.

Request body

Name	Type	Description
`event_type_id`	`string`
`page`	`string`	Booking page slug, when booking someone else's link
`event`	`string`	Event slug on that page
`start` required	`string`
`guest` required	`object`
`guest.name` required	`string`	length 1–80
`guest.email` required	`string`	length 0–254
`guest.speak` required	`string`
`guest.hear`	`string`
`guest.tz`	`string`	length 0–64 · default "UTC"
`guest.locale`	`string`	length 0–8 · default "en"
`answers`	`object`

Response `201`

Name	Type	Description
`id` required	`string`
`room_url` required	`string \| null`
`manage_url` required	`string \| null`
`start` required	`string`
`livemode` required	`boolean`

Example

curl

curl -X POST "https://api.kanutus.com/v1/bookings" \
  -H "Authorization: Bearer $KANUTUS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_type_id":"string","page":"string","event":"string","start":"2026-10-14T13:00:00Z","guest":{"name":"string","email":"ana@example.com","speak":"ja","hear":"string","tz":"UTC","locale":"en"},"answers":{}}'

Node.js

const res = await fetch("https://api.kanutus.com/v1/bookings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KANUTUS_API_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"event_type_id":"string","page":"string","event":"string","start":"2026-10-14T13:00:00Z","guest":{"name":"string","email":"ana@example.com","speak":"ja","hear":"string","tz":"UTC","locale":"en"},"answers":{}}),
});
console.log(res.status, await res.json());

Python

import os, uuid, requests

r = requests.request(
    "POST",
    "https://api.kanutus.com/v1/bookings",
    headers={"Authorization": f"Bearer {os.environ['KANUTUS_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
    json={"event_type_id":"string","page":"string","event":"string","start":"2026-10-14T13:00:00Z","guest":{"name":"string","email":"ana@example.com","speak":"ja","hear":"string","tz":"UTC","locale":"en"},"answers":{}},
)
print(r.status_code, r.json())

Try it

Runs from your browser against the real API. Use a kt_test_ key: nothing is charged. The key stays in this tab only.

API key Request body (JSON)

POST /v1/bookings

Responses by status

201 Booked; the room is created with the guest's language and invitations are emailed

201

{
  "id": "string",
  "room_url": "https://example.com",
  "manage_url": "https://example.com",
  "start": "string",
  "livemode": true
}

400 Invalid request

400 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 400,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

401 Missing, invalid, expired or revoked credential

401 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 401,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

403 Missing permission, blocked or not allowed

403 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 403,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

404 Not found

404 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 404,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

409 Conflict (idempotency or state)

409 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 409,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

429 Rate limit exceeded (see RateLimit-* and Retry-After headers)

429 application/problem+json

{
  "type": "https://docs.kanutus.com/errors",
  "title": "<code>",
  "status": 429,
  "code": "<code>",
  "message": "…",
  "request_id": "req_…"
}

See all error codes

Meetings and booking

GET/v1/meetings#

Parameters

Response 200

Example

Responses by status

POST/v1/meetings#

Parameters

Request body

Response 201

Example

Responses by status

DELETE/v1/meetings/{id}#

Parameters

Response 200

Example

Responses by status

GET/v1/event-types#

Response 200

Example

Responses by status

GET/v1/event-types/{id}/slots#

Parameters

Response 200

Example

Responses by status

POST/v1/bookings#

Parameters

Request body

Response 201

Example

Responses by status

GET`/v1/meetings`

Response `200`

POST`/v1/meetings`

Response `201`

DELETE`/v1/meetings/{id}`

Response `200`

GET`/v1/event-types`

Response `200`

GET`/v1/event-types/{id}/slots`

Response `200`

POST`/v1/bookings`

Response `201`