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 a project

PUT
/api/v1/projects/{id}
curl --request PUT \
--url https://api.pitch2sale.com/api/v1/projects/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "description": "example", "status": "not_started", "start_date": "2026-04-15T12:00:00Z", "deadline": "2026-04-15T12:00:00Z", "billing_type": "fixed_rate", "estimated_hours": 1, "budget": 1, "currency": "example" }'
id
required
string
Media typeapplication/json
object
name
string
>= 1 characters <= 500 characters
description
Any of:
string
<= 5000 characters
status
string
Allowed values: not_started in_progress on_hold completed cancelled
start_date
Any of:
string format: date-time
deadline
Any of:
string format: date-time
billing_type
string
Allowed values: fixed_rate hourly task_based
estimated_hours
Any of:
number
budget
Any of:
number
currency
string
>= 1 characters <= 3 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"
}
]
}