{"openapi":"3.1.0","info":{"title":"POST /api/v1/projects/bulk","version":"1.0.0","description":"Bulk create projects"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/projects/bulk":{"post":{"tags":["projects"],"summary":"Bulk create projects","description":"Create up to 100 projects in one request with per-row customer resolution. Rows may pass customer_name instead of customer_id — an exact case-insensitive match auto-resolves; ambiguous or unmatched names fail only that row (CUSTOMER_AMBIGUOUS / CUSTOMER_NOT_FOUND with candidate customers) unless create_missing_customers is true, in which case unmatched customers are created inline.","operationId":"bulk_create_projects_api_v1_projects_bulk_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectBulkCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_ProjectBulkCreateResponse_"}}}},"400":{"description":"Bad Request - Invalid input","content":{"application/json":{"example":{"detail":"Invalid request parameters"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ProjectBulkCreateRequest":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/ProjectBulkCreateRow"},"type":"array","maxItems":100,"minItems":1,"title":"Rows"},"create_missing_customers":{"type":"boolean","title":"Create Missing Customers","description":"When true, rows whose customer_name matches no existing customer create that customer inline instead of failing.","default":false}},"type":"object","required":["rows"],"title":"ProjectBulkCreateRequest","description":"Request schema for bulk project creation (1–100 rows)."},"ProjectBulkCreateResponse":{"properties":{"total_requested":{"type":"integer","title":"Total Requested"},"total_created":{"type":"integer","title":"Total Created"},"total_failed":{"type":"integer","title":"Total Failed"},"results":{"items":{"$ref":"#/components/schemas/ProjectBulkRowResult"},"type":"array","title":"Results"}},"type":"object","required":["total_requested","total_created","total_failed","results"],"title":"ProjectBulkCreateResponse","description":"Aggregated bulk-create outcome with per-row results."},"ProjectBulkCreateRow":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name","description":"Project name."},"code":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Code","description":"Optional code."},"sku":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Sku","description":"Optional short catalog/site code."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Optional description."},"status":{"type":"string","title":"Status","description":"One of: active, completed, on_hold.","default":"active"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id","description":"Customer UUID; takes precedence over customer_name."},"customer_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Customer Name","description":"Customer name, matched case-insensitively (exact match) against the business's customers when customer_id is not given."},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date","description":"Optional project start date."},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date","description":"Optional project end date."}},"type":"object","required":["name"],"title":"ProjectBulkCreateRow","description":"One project in a bulk-create request.\n\nA row may reference its customer either by ``customer_id`` or by\n``customer_name`` (resolved case-insensitively against the business's\nactive customers). Neither is required — projects can be unassigned."},"ProjectBulkCustomerCandidate":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},"type":"object","required":["id"],"title":"ProjectBulkCustomerCandidate","description":"A customer suggested for an unresolved or ambiguous row."},"ProjectBulkRowError":{"properties":{"code":{"type":"string","title":"Code","description":"CUSTOMER_NOT_FOUND, CUSTOMER_AMBIGUOUS, or CREATE_FAILED."},"message":{"type":"string","title":"Message"},"candidates":{"items":{"$ref":"#/components/schemas/ProjectBulkCustomerCandidate"},"type":"array","title":"Candidates"}},"type":"object","required":["code","message"],"title":"ProjectBulkRowError","description":"Why one bulk row failed; the rest of the batch is unaffected."},"ProjectBulkRowResult":{"properties":{"index":{"type":"integer","title":"Index"},"name":{"type":"string","title":"Name"},"success":{"type":"boolean","title":"Success"},"project":{"anyOf":[{"$ref":"#/components/schemas/ProjectResponse"},{"type":"null"}]},"error":{"anyOf":[{"$ref":"#/components/schemas/ProjectBulkRowError"},{"type":"null"}]}},"type":"object","required":["index","name","success"],"title":"ProjectBulkRowResult","description":"Outcome for one row of a bulk create, in input order."},"ProjectResponse":{"properties":{"id":{"type":"string","title":"Id"},"business_id":{"type":"string","title":"Business Id"},"name":{"type":"string","title":"Name"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","business_id","name","status","is_active","created_at","updated_at"],"title":"ProjectResponse","description":"Response schema for a project."},"SuccessEnvelope_ProjectBulkCreateResponse_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"data":{"anyOf":[{"$ref":"#/components/schemas/ProjectBulkCreateResponse"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"SuccessEnvelope[ProjectBulkCreateResponse]"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}