Skip to main content
POST

Authorizations

Authorization
string
header
required

OAuth 2.0 client credentials. The access token from POST /oauth/token is sent as a bearer token. Request only the scopes you need.

zivio-tenant-id
string
header
required

Your Zivio organisation identifier. The regional API endpoints serve every Zivio organisation, so each request must identify yours.

Body

application/json
project
object
required

Input schema for creating and updating a project. Only fields listed here are accepted — unrecognised fields are silently ignored. Read-only fields visible in the response (e.g. supplier_id, state, awarded_at) cannot be set via the API. supplier_id is set internally when a project is hired and cannot be assigned directly. The V4 API only permits write operations on projects in draft or pending state.

Response

Project created

id
integer
title
string
description
string
state
enum<string>
Available options:
draft,
pending,
new,
halted,
in_progress,
work_completed,
cancelled,
closed,
superseded,
bafo
Example:

"draft"

additional_notes
string
skill_category
object | null
skill_subcategory
object | null
skill_category_tier3
object | null
skills
object[]
talent_pool_id
integer
type
string
posting_type
string
bids_count
integer
submission_deadline
string
submission_deadline_time_zone
string
ccy
string
fee_methodology
enum<string>
Available options:
markup,
supplier_absorbed,
tiered_markup,
supplier_absorbed_itemized,
markup_itemized
Example:

"markup"

fee_schedule_id
integer
award_type
enum<string>
Available options:
direct_award,
competition
Example:

"direct_award"

risk_level_id
integer
is_template
boolean
Example:

true

quality_score_allocation_percentage
string
cost_score_allocation_percentage
string
award_suppliers
string[]
approved
boolean
Example:

true

submitted_at
string
approved_at
string
hired_at
string
start_date
string
due_on
string
original_due_on
string
ended_at
string
closed_at
string
auto_close_at
string
halted_comment
string
cancellation_reason_id
integer
cancellation_other_reason
string
cancelled_by
object | null
cancelled_at
string
completed_by
object | null
closed_by
object | null
visibility
string
bafo_submission_deadline
string
bid_round
integer
original_project_id
integer
location
object
target_cost
object
budget
object
original_budget
object
rate
object
original_rate
object
fee
string
markup
string
estimated_savings
object
projected_recognized_savings
object
payment_terms_in_days
integer
client_payment_terms_in_days
integer
permit_supplier_defined_milestones
string
supplier_defined_milestones
string
client_defined_milestones_mandatory
string
invoices_cis
string
cis_end_user_client
string
is_child
boolean
Example:

true

is_parent
boolean
Example:

true

custom_fields
object

Key-value pairs of custom field data

badges
string[]
project_screening_questions
string
client
object | null
administrator
object | null
client_org
object | null
cost_centers
object[]
milestones
object[]
supplier
object | null
created_at
string
updated_at
string
project_matches_count
integer
project_line_items
object[]
award_criteria_groups
object[]