Skip to content
Pitch2SaleDevelopers
Open the app
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

Update the organization's branding

PUT
/api/v1/org/branding
curl --request PUT \
--url https://api.pitch2sale.com/api/v1/org/branding \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "logo_url": "https://example.com", "company_name": "example", "company_address": "example", "company_phone": "example", "company_email": "hello@example.com", "company_website": "https://example.com", "tax_id": "example", "primary_color": "example", "accent_color": "example", "font_family": "sans-serif", "invoice_template": "classic", "footer_text": "example", "bank_detail": "example", "bank_details": [ { "_id": "example", "label": "", "content": "example", "is_default": false } ], "terms_and_conditions": "example", "digital_signature_url": "https://example.com" }'
Media typeapplication/json
object
logo_url
Any of:
string format: uri
<= 2048 characters
company_name
string
<= 200 characters
company_address
string
<= 1000 characters
company_phone
Any of:
string
<= 30 characters
company_email
Any of:
string format: email
<= 255 characters
company_website
Any of:
string format: uri
<= 500 characters
tax_id
Any of:
string
<= 50 characters
primary_color
string
/^#[0-9a-fA-F]{6}$/
accent_color
string
/^#[0-9a-fA-F]{6}$/
font_family
string
Allowed values: sans-serif serif mono
invoice_template
string
Allowed values: classic modern minimal professional creative bold elegant compact split branded orange
footer_text
Any of:
string
<= 5000 characters
bank_detail
Any of:
string
<= 2000 characters
bank_details
Array<object>
<= 20 items
object
_id
string
label
string
"" <= 120 characters
content
required
string
<= 2000 characters
is_default
boolean
terms_and_conditions
Any of:
string
<= 10000 characters
digital_signature_url
Any of:
string format: uri
<= 2048 characters

OK

Validation failed

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}