Skip to main content
PUT
/
v1
/
platform
/
businesses
/
{business_id}
/
vendors
/
{vendor_id}
Update vendor
curl --request PUT \
  --url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/vendors/{vendor_id}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "<string>",
  "individual_name": "<string>",
  "company_name": "<string>",
  "email": "[email protected]",
  "mobile_phone": "<string>",
  "office_phone": "<string>",
  "address_string": "<string>",
  "memo": "<string>",
  "transaction_tags": [
    "<unknown>"
  ],
  "vendor_number": "<string>",
  "document": {
    "file": "<string>",
    "document_type": "vendor_document",
    "upload_source": "<string>",
    "metadata": "<unknown>",
    "tags": "<unknown>"
  }
}
'
{
  "type": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "mobile_phone": "<string>",
  "office_phone": "<string>",
  "address_string": "<string>",
  "memo": "<string>",
  "status": "<string>",
  "transaction_tags": [
    "<unknown>"
  ],
  "documents": [
    {
      "url": "<string>",
      "expires_in": 123,
      "document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "file_name": "<string>",
      "file_size": 123,
      "mime_type": "<string>"
    }
  ],
  "external_id": "<string>",
  "individual_name": "<string>",
  "company_name": "<string>",
  "email": "[email protected]"
}

Authorizations

​
Authorization
string
header
required

Partner-level JWT token (unscoped). Token payload includes partner_id. Business access is validated via partner ownership. Format: Bearer <your-jwt-token>

Use this for: Multi-business operations where the business_id is specified in the URL and partner has access to multiple businesses.

Path Parameters

​
business_id
string
required
​
vendor_id
string<uuid>
required

A UUID string identifying this vendor.

Body

Input serializer for updating a vendor

​
external_id
string

Updated external identifier (must remain unique)

​
individual_name
string

Updated vendor individual name

​
company_name
string

Updated registered company name

​
email
string<email>

Updated primary email address

​
mobile_phone
string

Updated mobile phone number (E.164 format)

​
office_phone
string

Updated office phone number (E.164 format)

​
address_string
string

Updated vendor mailing address

​
memo
string

Updated internal notes or description

​
transaction_tags
any[]

Updated tags for categorization

​
vendor_number
string

Updated vendor number (must be unique)

​
document
object

Optional document upload

Response

Serializer for vendor objects returned by the vendors list endpoint

​
type
string
required

Resource type (always 'VendorData')

​
id
string<uuid>
required

Unique vendor identifier

​
mobile_phone
string
required

Mobile phone number (E.164 format, e.g., +44 7700 900123)

​
office_phone
string
required

Office phone number (E.164 format, e.g., +44 20 7946 0958)

​
address_string
string
required

Full formatted address (read-only, auto-generated)

​
memo
string
required

Internal notes or description for this vendor

​
status
string
required

Vendor status (ACTIVE, INACTIVE, ARCHIVED, BLOCKED)

​
transaction_tags
any[]
required

List of tags for categorization

​
documents
object[]
required

All documents linked to this vendor with presigned URLs

​
external_id
string

Your unique identifier for this vendor (used for idempotency)

Maximum string length: 255
​
individual_name
string

Vendor individual name (for sole traders/freelancers)

Maximum string length: 255
​
company_name
string

Registered company name (for limited companies)

Maximum string length: 255
​
email
string<email>

Primary email address for vendor communications

Maximum string length: 254