Submit or edit your review

Trust · saveOwnReview

One review per authenticated user, associated with an account they administer. Every edit removes public approval. Revision is null for first submission, otherwise the current revision. Avatars are optional JPEG/PNG/WebP, at most 512 KiB before base64 encoding.

POST/reviews/me

Base URL: https://api.businessmode.io/v1

Authentication

Developer bearer token

The requirement above comes from this operation's OpenAPI security declaration. See Authentication.

Parameters

No path, query, or header parameters are defined.

Request body

Required

`application/json`

object · SaveReviewRequest

No additional properties

Field Type Required Description / constraints

accountId string Yes Format: uuid · Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

avatar

anyOf

View nested schema

anyOf

anyOf · 2 alternatives

Alternative 1

object

No additional properties

Field	Type	Required	Description / constraints
`base64`	string	Yes	Pattern: ^[A-Za-z0-9+/]+={0,2}$ · Minimum length: 4 · Maximum length: 699052
`contentType`	string	Yes	Values: image/jpeg, image/png, image/webp

Alternative 2

null

body string Yes Minimum length: 20 · Maximum length: 3000

consentToPublish boolean Yes

headline string Yes Minimum length: 3 · Maximum length: 120

publicCompany

anyOf

Yes

View nested schema

anyOf

anyOf · 2 alternatives

Alternative 1

string

Minimum length: 1
Maximum length: 100

Alternative 2

null

publicName string Yes Minimum length: 1 · Maximum length: 80

publicRole

anyOf

Yes

View nested schema

anyOf

anyOf · 2 alternatives

Alternative 1

string

Minimum length: 1
Maximum length: 100

Alternative 2

null

rating integer Yes Minimum: 1 · Maximum: 5

revision

anyOf

Yes

View nested schema

anyOf

anyOf · 2 alternatives

Alternative 1

integer

Maximum: 9007199254740991
Exclusive minimum: 0

Alternative 2

null

Responses

For status codes, request IDs, and safe retry decisions, see Errors & recovery. Known-code descriptions below are operation-specific, not a complete global error enum.

`200` Successful response.

Content type: application/json

object · OwnedReviewResponse

No additional properties

Field Type Required Description / constraints

canModerate boolean Yes

review

anyOf

Yes

View nested schema

anyOf

anyOf · 2 alternatives

Alternative 1

object

No additional properties

Field	Type	Required	Description / constraints
`accountId`	string	Yes	Format: uuid · Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$
`avatarDataUrl`	string \| null	Yes
`body`	string	Yes	Minimum length: 20 · Maximum length: 3000
`consentToPublish`	boolean	Yes
`headline`	string	Yes	Minimum length: 3 · Maximum length: 120
`id`	string	Yes	Format: uuid · Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$
`publicCompany`	anyOf	Yes	View nested schema anyOf anyOf · 2 alternatives Alternative 1 string Minimum length: 1 Maximum length: 100 Alternative 2 null
`publicName`	string	Yes	Minimum length: 1 · Maximum length: 80
`publicRole`	anyOf	Yes	View nested schema anyOf anyOf · 2 alternatives Alternative 1 string Minimum length: 1 Maximum length: 100 Alternative 2 null
`rating`	integer	Yes	Minimum: 1 · Maximum: 5
`reason`	anyOf	Yes	View nested schema anyOf anyOf · 2 alternatives Alternative 1 string Values: spam, abuse, personal_information, unsafe_avatar, unrelated, consent, withdrawn Alternative 2 null
`revision`	integer	Yes	Maximum: 9007199254740991 · Exclusive minimum: 0
`status`	string	Yes	Values: pending, approved, rejected, unpublished
`updatedAt`	string	Yes	Format: date-time · Pattern: ^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$

Alternative 2

null

`400` Invalid request.

Content type: application/json

object · ErrorResponse

No additional properties

Field Type Required Description / constraints

error

object

Yes

No additional properties

View nested schema

object

No additional properties

Field	Type	Required	Description / constraints
`code`	string	Yes	Minimum length: 1
`message`	string	Yes	Minimum length: 1

`401` Authentication failed.

Content type: application/json

object · ErrorResponse

No additional properties

Field Type Required Description / constraints

error

object

Yes

No additional properties

View nested schema

object

No additional properties

Field	Type	Required	Description / constraints
`code`	string	Yes	Minimum length: 1
`message`	string	Yes	Minimum length: 1

`403` The authenticated human is not permitted to perform this operation.

Content type: application/json

object · ErrorResponse

No additional properties

Field Type Required Description / constraints

error

object

Yes

No additional properties

View nested schema

object

No additional properties

Field	Type	Required	Description / constraints
`code`	string	Yes	Minimum length: 1
`message`	string	Yes	Minimum length: 1

`409` The request conflicts with current resource state.

Content type: application/json

object · ErrorResponse

No additional properties

Field Type Required Description / constraints

error

object

Yes

No additional properties

View nested schema

object

No additional properties

Field	Type	Required	Description / constraints
`code`	string	Yes	Minimum length: 1
`message`	string	Yes	Minimum length: 1

`429` Too many requests. Honor Retry-After before retrying with the same logical Idempotency-Key, where required. Known error codes: rate_limit_exceeded.

Content type: application/json

object · ErrorResponse

No additional properties

Field Type Required Description / constraints

error

object

Yes

No additional properties

View nested schema

object

No additional properties

Field	Type	Required	Description / constraints
`code`	string	Yes	Minimum length: 1
`message`	string	Yes	Minimum length: 1

`500` An unexpected server error occurred.

Content type: application/json

object · ErrorResponse

No additional properties

Field Type Required Description / constraints

error

object

Yes

No additional properties

View nested schema

object

No additional properties

Field	Type	Required	Description / constraints
`code`	string	Yes	Minimum length: 1
`message`	string	Yes	Minimum length: 1

← All API operations

Company access

Manage customers

Company sales

Beyond manual work

Get started

Reference

Build

Company access

Explore the choices

Submit or edit your review

Authentication

Parameters

Request body

`application/json`

Responses

`200` Successful response.

`400` Invalid request.

`401` Authentication failed.

`403` The authenticated human is not permitted to perform this operation.

`409` The request conflicts with current resource state.

`429` Too many requests. Honor Retry-After before retrying with the same logical Idempotency-Key, where required. Known error codes: rate_limit_exceeded.

`500` An unexpected server error occurred.

Submit or edit your review

Authentication

Parameters

Request body

application/json

Responses

200 Successful response.

400 Invalid request.

401 Authentication failed.

403 The authenticated human is not permitted to perform this operation.

409 The request conflicts with current resource state.

429 Too many requests. Honor Retry-After before retrying with the same logical Idempotency-Key, where required. Known error codes: rate_limit_exceeded.

500 An unexpected server error occurred.

`application/json`

`200` Successful response.

`400` Invalid request.

`401` Authentication failed.

`403` The authenticated human is not permitted to perform this operation.

`409` The request conflicts with current resource state.

`429` Too many requests. Honor Retry-After before retrying with the same logical Idempotency-Key, where required. Known error codes: rate_limit_exceeded.

`500` An unexpected server error occurred.