Sign in
project

Create Sandbox Project From Features

Create one sandbox project from several confirmed features (Door 1).

The multi-feature twin of /sandbox/from-feature: derives one shared county from every feature's marker before inserting the project, then enqueues a single seed for all of them. Unknown feature_id → 404; a NULL/malformed marker → 422; features spanning more than one county → 422 (a project is scoped to one county under RLS, so the paste must be split). status flips to ready and the layers arrive via SSE.

features is the paste flow. upload is the file-import flow, whose row values come from the server's held inspect result rather than this request.

post/api/v1/project/sandbox/from-features

Headers

Idempotency-Keystring nullable

Request body

county_fipsstring nullable
spine'matched_only' | 'all_rows'
knowledge_skill_workspace_idstring uuid nullable

Response

Successful Response

project_idstring uuid required
status'pending' | 'ready' | 'failed' | 'archived' required

Lifecycle status for a project.

Replaces the boolean is_created whose name implied "was created" (always True once inserted) but semantically meant "is ready for the dashboard to show." Promoting to an enum lets new states (FAILED, ARCHIVED) join without contorting the boolean.

  • PENDING: row inserted, sandbox resources not yet materialized
  • READY: resources in place; visible on dashboard
  • FAILED: build raised mid-flight (sandbox saga rollback uses hard-delete instead, so this state is reserved for future async build paths that can't roll back atomically)
  • ARCHIVED: user-archived; hidden by default
county_fipsstring required

Changes

Changed in 4 of the 30 revisions of this API.35

  • bb508e93517431See the full diff
    • ▲

      the request property /// became required

      request-property-became-required

    • ▲

      request property /// list-of-types was narrowed by removing types null from media type application/json

      request-property-list-of-types-narrowed

    • ▲

      added the pattern ^\d{5}$ to the request property ///

      request-property-pattern-added

    • ○

      added the new optional request property

      new-optional-request-property

  • 8beaac28e1951See the full diff
    • ○

      added the new optional request property ///

      new-optional-request-property

  • 4c1b045ef2af1See the full diff
    • ○

      added the new optional header request parameter Idempotency-Key

      new-optional-request-parameter

  • ba2b8d9621612See the full diff
    • ○

      added the new optional request property ///

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog