Skip to content
Linra Omni Vendor Docs

Update your own vendor profile

PUT
/api/v1/profile
curl --request PUT \
  --url https://api-omni-vendors.linra.net/api/v1/profile \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example" }'

Updates your vendor’s display Name — the ONLY field this request body can carry. TaxRegistrationNumber/IsVatRegistered/VatVerifiedAt are excluded from the request shape entirely (not merely permission-gated closed) — vendor tax/VAT registration stays an internal-admin-only, manually-verified action with no self-service path on any plane. Requires the Account capability.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

Deliberately carries ONLY name — TaxRegistrationNumber/IsVatRegistered/VatVerifiedAt cannot be written through this API on any plane, at any capability level.

object
name
required
string
>= 1 characters
Examplegenerated
{
  "name": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

Your updated vendor profile.

Media typeapplication/json
object
state
required
string
payload
required
details
object
payload
required
object
id
string format: uuid
name
string
isActive
boolean
taxRegistrationNumber

Your own tax registration number, or null if unset. Read-only on this API — see UpdateVendorProfileRequest.

string
nullable
isVatRegistered

Whether you have a verified VAT/tax registration on file. Read-only.

boolean
vatVerifiedAt

UTC timestamp of Linra’s last manual verification of your registration, or null if never verified. Read-only.

string format: date-time
nullable
createdDate
string format: date-time
nullable
lastModifiedDate
string format: date-time
nullable
Example
{
  "state": "SUCCESS"
}

400

Section titled “400”

Request validation failed.

Media typeapplication/json
object
state
required
string
payload
details
object
Example
{
  "state": "NOT_FOUND_VENDOR_OFFER"
}

403

Section titled “403”

Your token doesn’t carry the capability this endpoint requires.

Media typeapplication/json
object
state
required
string
payload
details
object
Examples
ExamplemissingCapability
{
  "state": "FORBIDDEN_CAPABILITY_NOT_GRANTED",
  "payload": null,
  "details": {
    "requiredCapability": "Orders"
  }
}

429

Section titled “429”

Too many requests. Retry after the Retry-After header (seconds).

Media typeapplication/json
object
state
required
string
payload
details
object
Example
{
  "state": "NOT_FOUND_VENDOR_OFFER"
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.