Bids

Convert accepted bid to project

post/bids/{id}/convert-to-project

Request

  • Base URL: https://app.buildworkpro.com/api/v1
  • URL: https://app.buildworkpro.com/api/v1/bids/{id}/convert-to-project
  • Auth: HTTP bearer

Path parameters

idinteger required

Headers

Idempotency-Keystring uuid

Idempotent retry key for mutating operations. The first request with a given key executes normally and BuildWorkPro caches the response. Replaying the same key with the same request body (method + path + JSON body, SHA-256 hashed) returns the cached response without re-executing the mutation. Replaying with a DIFFERENT body returns 409 idempotency_key_reused. The cache TTL is 24 hours; after expiry the key is treated as a new operation. Keys are tenant-scoped. Recommended: a fresh UUID v4 per logical operation.

Request body

mappingStrategy'phases' | 'tasks' | 'blank' | 'sections' required

How bid line items map onto the new project: one phase per line item ("phases"), one task per line item ("tasks"), no phases/tasks ("blank"), or one phase per section header with its lines as tasks ("sections"). The legacy web route's "template" strategy is not supported on v1.

templateIdinteger
lineItemPhaseMappingobject
namestring
startDatestring
expectedEndDatestring

Response

Project created

dataunknown

Changes

No recorded changes to this operation across all 1 revision of this API.