Skip to main content
POST
File one side's report on a booking

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

bookingId
string
required

The booking — one scheduled unit of service occupying supplier time.

Minimum string length: 1
Example:

"bk_01kv7q41n2hbqxwm03ymn7bxl9"

Body

application/json

Report data

reporterRole
enum<string>
required

Which side of the booking is filing this report.

Available options:
CLIENT,
SUPPLIER
Example:

"SUPPLIER"

attended
boolean
required

Whether the reporting side attended the booking. This is a self-report — the client confirms the client attended, the supplier confirms the supplier attended. Stored explicitly so "I did not attend" is a first-class answer.

Example:

true

reportType
enum<string>
default:ATTENDANCE

What the report is about. Defaults to ATTENDANCE, the only type today.

Available options:
ATTENDANCE
Example:

"ATTENDANCE"

note
string

Optional free-text detail, up to 1000 characters.

Maximum string length: 1000
Example:

"Arrived 10 minutes late but stayed for the full session."

Response

Identical report already on file (no-op)

data
object
required