Record the member’s acceptance of a legal document at its in-force version

POST

/v1/me/acceptances

curl --request POST \
  --url https://api.vimine.network/v1/me/acceptances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "kind": "example", "version": "example", "sha256": "example" }'

• Vimine API

Records one proof row (channel api, your app named): an account-layer document (platform_terms accepted, platform_privacy acknowledged, network_consent consented) or this association’s privacy_notice acknowledged. version (and sha256 when published) must name the in-force text your app showed — else 422 <kind>_outdated. Recording the same version twice is harmless: every row is proof. Honours Idempotency-Key.

Authorizations

• BearerToken
  legal:accept

Request Body^required

Media typeapplication/json

object

kind

required

Platform_terms | platform_privacy | network_consent | privacy_notice

string

version

required

One of:

string

string

integer

integer

sha256

string

Example^generated

{
  "kind": "example",
  "version": "example",
  "sha256": "example"
}

Responses

200

Recorded

Media typeapplication/json

object

recorded

required

boolean

kind

required

string

action

required

string

version

required

string

at

required

string format: date-time

Example^generated

{
  "recorded": true,
  "kind": "example",
  "action": "example",
  "version": "example",
  "at": "2026-04-15T12:00:00Z"
}

400

Invalid request

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

401

Missing or invalid credentials

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Not allowed

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Nothing published for this kind (not_found)

422

Unknown kind, missing version, or a version that is not in force (<kind>_outdated)

429

Rate limited

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Internal error

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

string

request_id

string

errors

Array<object>

object

field

string

code

string

message

string

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}