> ## Documentation Index > Fetch the complete documentation index at: https://docs.pnbr.io/llms.txt > Use this file to discover all available pages before exploring further. # List workspace extractions > Read a workspace's extraction runs and their findings. **Operation ID:** `http.graph.workspaces.extractions` ```http theme={null} GET /v1/orgs/{org}/projects/{project}/graph/workspaces/{ws}/extractions ``` ## OpenAPI ````yaml openapi.json GET /v1/orgs/{org}/projects/{project}/graph/workspaces/{ws}/extractions openapi: 3.1.0 info: title: Penumbra API version: v1 description: >- HTTP reference for Files, search, extraction, reviews, Graph, Shapes and sharing. servers: - url: https://api.pnbr.io description: Penumbra API security: [] paths: /v1/orgs/{org}/projects/{project}/graph/workspaces/{ws}/extractions: get: tags: - Review workspaces summary: List workspace extractions description: |- Read a workspace's extraction runs and their findings. Product guidance: [Workspace](/concepts/workspace). operationId: http.graph.workspaces.extractions parameters: - name: org in: path required: true schema: type: string - name: project in: path required: true schema: type: string - name: ws in: path required: true schema: type: string - name: view in: query required: false description: review or findings to read one run; omit for the status of the runs. schema: type: string - name: run_id in: query required: false description: The extraction run. schema: type: string - name: after in: query required: false description: 'For findings: continue after this position.' schema: type: string - name: limit in: query required: false description: 'For findings: how many, 1 to 500.' schema: type: string responses: 2XX: description: Success. content: application/json: schema: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response security: - bearerAuth: [] components: schemas: http_graph_workspaces_extractions_response: type: object properties: data: anyOf: - type: object properties: workspace: type: object properties: id: type: string creation_origin: type: string name: type: string description: anyOf: - type: string - type: 'null' status: type: string enum: - open - submitted - applied - closed revision: type: integer minimum: -9007199254740991 maximum: 9007199254740991 item_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 shape: anyOf: - type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} - type: 'null' bindings: type: array items: type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} bridge_set: anyOf: - type: object properties: digest: type: string declaration_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - digest - declaration_count additionalProperties: {} - type: 'null' created_at: type: string updated_at: type: string applied_at: anyOf: - type: string - type: 'null' replaced_by: type: string required: - id - creation_origin - name - description - status - revision - item_count - shape - bindings - bridge_set - created_at - updated_at - applied_at additionalProperties: {} schema: type: string const: penumbra.graph-extraction-status version: type: number const: 1 run_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ workspace_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ expected_revision: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 staging: type: string const: all_accepted source_count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 status: type: string enum: - queued - running - awaiting_staging - staged - conflict - failed - cancelled execution_state: anyOf: - type: string - type: 'null' adoption_state: anyOf: - type: string - type: 'null' adopted_revision: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' staged_item_count: type: integer minimum: 0 maximum: 9007199254740991 accepted_count: type: integer minimum: 0 maximum: 9007199254740991 needs_evidence_count: type: integer minimum: 0 maximum: 9007199254740991 rejected_count: type: integer minimum: 0 maximum: 9007199254740991 repair_count: type: integer minimum: 0 maximum: 9007199254740991 over_limit_count: type: integer minimum: 0 maximum: 9007199254740991 error_code: anyOf: - type: string - type: 'null' progress: anyOf: - type: object properties: cursor: type: integer minimum: 0 maximum: 9007199254740991 step: anyOf: - type: string enum: - draft - review - record - synthesis - reconcile - support - resuming - stopping - type: 'null' parts: type: object properties: done: type: integer minimum: 0 maximum: 9007199254740991 total: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' required: - done - total additionalProperties: false live: type: object properties: entities: type: integer minimum: 0 maximum: 9007199254740991 relationships: type: integer minimum: 0 maximum: 9007199254740991 required: - entities - relationships additionalProperties: false by_type: type: array items: type: object properties: kind: type: string enum: - entity - relationship type_id: type: string type_name: type: string minLength: 1 maxLength: 256 live: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - kind - type_id - type_name - live additionalProperties: false not_accepted: type: object properties: needs_evidence: type: integer minimum: 0 maximum: 9007199254740991 rejected: type: integer minimum: 0 maximum: 9007199254740991 required: - needs_evidence - rejected additionalProperties: false stop_requested: type: boolean required: - cursor - step - parts - live - by_type - not_accepted - stop_requested additionalProperties: false - type: 'null' queue: anyOf: - type: object properties: position: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 active_limit: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - position - active_limit additionalProperties: false - type: 'null' stopped_early: type: boolean review_not_run: type: boolean incomplete: default: null anyOf: - type: object properties: parts_delivered: type: integer minimum: 0 maximum: 9007199254740991 parts_total: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 reconciled: type: boolean failure_code: anyOf: - type: string - type: 'null' files_not_fully_read: anyOf: - maxItems: 256 type: array items: type: object properties: file_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ partly_read: type: boolean required: - file_id - partly_read additionalProperties: false - type: 'null' required: - parts_delivered - parts_total - reconciled - failure_code - files_not_fully_read additionalProperties: false - type: 'null' created_at: type: string completed_at: anyOf: - type: string - type: 'null' level: anyOf: - type: string enum: - fast - standard - deep - type: 'null' outcome: description: >- How the run ended, present only once it has ended: succeeded, partial (it delivered only what finished), failed or no_effect (it was stopped before it delivered anything). type: string enum: - succeeded - partial - failed - no_effect reason: description: For a failed run, its own failure code. type: string required: - workspace - schema - version - run_id - workspace_id - expected_revision - staging - source_count - status - execution_state - adoption_state - adopted_revision - staged_item_count - accepted_count - needs_evidence_count - rejected_count - repair_count - over_limit_count - error_code - progress - stopped_early - review_not_run - incomplete - created_at - completed_at - level additionalProperties: false - type: object properties: workspace: type: object properties: id: type: string creation_origin: type: string name: type: string description: anyOf: - type: string - type: 'null' status: type: string enum: - open - submitted - applied - closed revision: type: integer minimum: -9007199254740991 maximum: 9007199254740991 item_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 shape: anyOf: - type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} - type: 'null' bindings: type: array items: type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} bridge_set: anyOf: - type: object properties: digest: type: string declaration_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - digest - declaration_count additionalProperties: {} - type: 'null' created_at: type: string updated_at: type: string applied_at: anyOf: - type: string - type: 'null' replaced_by: type: string required: - id - creation_origin - name - description - status - revision - item_count - shape - bindings - bridge_set - created_at - updated_at - applied_at additionalProperties: {} schema: type: string const: penumbra.graph-extraction-status-list version: type: number const: 1 workspace_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ runs: type: array items: type: object properties: schema: type: string const: penumbra.graph-extraction-status version: type: number const: 1 run_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ workspace_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ expected_revision: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 staging: type: string const: all_accepted source_count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 status: type: string enum: - queued - running - awaiting_staging - staged - conflict - failed - cancelled execution_state: anyOf: - type: string - type: 'null' adoption_state: anyOf: - type: string - type: 'null' adopted_revision: anyOf: - type: integer exclusiveMinimum: 0 maximum: 9007199254740991 - type: 'null' staged_item_count: type: integer minimum: 0 maximum: 9007199254740991 accepted_count: type: integer minimum: 0 maximum: 9007199254740991 needs_evidence_count: type: integer minimum: 0 maximum: 9007199254740991 rejected_count: type: integer minimum: 0 maximum: 9007199254740991 repair_count: type: integer minimum: 0 maximum: 9007199254740991 over_limit_count: type: integer minimum: 0 maximum: 9007199254740991 error_code: anyOf: - type: string - type: 'null' progress: anyOf: - type: object properties: cursor: type: integer minimum: 0 maximum: 9007199254740991 step: anyOf: - type: string enum: - draft - review - record - synthesis - reconcile - support - resuming - stopping - type: 'null' parts: type: object properties: done: type: integer minimum: 0 maximum: 9007199254740991 total: anyOf: - type: integer minimum: 0 maximum: 9007199254740991 - type: 'null' required: - done - total additionalProperties: false live: type: object properties: entities: type: integer minimum: 0 maximum: 9007199254740991 relationships: type: integer minimum: 0 maximum: 9007199254740991 required: - entities - relationships additionalProperties: false by_type: type: array items: type: object properties: kind: type: string enum: - entity - relationship type_id: type: string type_name: type: string minLength: 1 maxLength: 256 live: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - kind - type_id - type_name - live additionalProperties: false not_accepted: type: object properties: needs_evidence: type: integer minimum: 0 maximum: 9007199254740991 rejected: type: integer minimum: 0 maximum: 9007199254740991 required: - needs_evidence - rejected additionalProperties: false stop_requested: type: boolean required: - cursor - step - parts - live - by_type - not_accepted - stop_requested additionalProperties: false - type: 'null' queue: anyOf: - type: object properties: position: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 active_limit: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - position - active_limit additionalProperties: false - type: 'null' stopped_early: type: boolean review_not_run: type: boolean incomplete: default: null anyOf: - type: object properties: parts_delivered: type: integer minimum: 0 maximum: 9007199254740991 parts_total: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 reconciled: type: boolean failure_code: anyOf: - type: string - type: 'null' files_not_fully_read: anyOf: - maxItems: 256 type: array items: type: object properties: file_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ partly_read: type: boolean required: - file_id - partly_read additionalProperties: false - type: 'null' required: - parts_delivered - parts_total - reconciled - failure_code - files_not_fully_read additionalProperties: false - type: 'null' created_at: type: string completed_at: anyOf: - type: string - type: 'null' level: anyOf: - type: string enum: - fast - standard - deep - type: 'null' outcome: description: >- How the run ended, present only once it has ended: succeeded, partial (it delivered only what finished), failed or no_effect (it was stopped before it delivered anything). type: string enum: - succeeded - partial - failed - no_effect reason: description: For a failed run, its own failure code. type: string required: - schema - version - run_id - workspace_id - expected_revision - staging - source_count - status - execution_state - adoption_state - adopted_revision - staged_item_count - accepted_count - needs_evidence_count - rejected_count - repair_count - over_limit_count - error_code - progress - stopped_early - review_not_run - incomplete - created_at - completed_at - level additionalProperties: false required: - workspace - schema - version - workspace_id - runs additionalProperties: false - type: object properties: workspace: type: object properties: id: type: string creation_origin: type: string name: type: string description: anyOf: - type: string - type: 'null' status: type: string enum: - open - submitted - applied - closed revision: type: integer minimum: -9007199254740991 maximum: 9007199254740991 item_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 shape: anyOf: - type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} - type: 'null' bindings: type: array items: type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} bridge_set: anyOf: - type: object properties: digest: type: string declaration_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - digest - declaration_count additionalProperties: {} - type: 'null' created_at: type: string updated_at: type: string applied_at: anyOf: - type: string - type: 'null' replaced_by: type: string required: - id - creation_origin - name - description - status - revision - item_count - shape - bindings - bridge_set - created_at - updated_at - applied_at additionalProperties: {} schema: type: string const: penumbra.graph-extraction-findings version: type: number const: 1 run_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ events: type: array items: oneOf: - type: object properties: seq: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 event: type: string const: found finding_key: type: string minLength: 1 maxLength: 128 part: type: string minLength: 1 kind: type: string enum: - entity - relationship type_id: type: string minLength: 1 type_name: type: string minLength: 1 maxLength: 256 disposition: type: string enum: - accepted - needs_evidence - rejected value: type: object properties: name: anyOf: - type: string - type: 'null' properties: type: object propertyNames: type: string additionalProperties: {} citations: type: array items: {} issues: type: array items: type: object properties: code: type: string required: - code additionalProperties: false from_key: type: string minLength: 1 maxLength: 128 to_key: type: string minLength: 1 maxLength: 128 route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false required: - name - properties - citations additionalProperties: false required: - seq - event - finding_key - part - kind - type_id - type_name - disposition - value additionalProperties: false - type: object properties: seq: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 event: type: string const: withdrawn finding_key: type: string minLength: 1 maxLength: 128 part: type: string minLength: 1 kind: type: 'null' type_id: type: 'null' type_name: type: 'null' disposition: type: 'null' value: type: object properties: reason: type: string enum: - part_restarted - merged - dropped - not_in_result required: - reason additionalProperties: false required: - seq - event - finding_key - part - kind - type_id - type_name - disposition - value additionalProperties: false - type: object properties: seq: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 event: type: string const: step finding_key: type: 'null' part: type: 'null' kind: type: 'null' type_id: type: 'null' type_name: type: 'null' disposition: type: 'null' value: type: object properties: step: type: string enum: - draft - review - record - synthesis - reconcile - support - resuming - stopping parts_total: type: integer minimum: 0 maximum: 9007199254740991 required: - step additionalProperties: false required: - seq - event - finding_key - part - kind - type_id - type_name - disposition - value additionalProperties: false cursor: type: integer minimum: 0 maximum: 9007199254740991 more: type: boolean state: anyOf: - type: string - type: 'null' required: - workspace - schema - version - run_id - events - cursor - more - state additionalProperties: false - type: object properties: workspace: type: object properties: id: type: string creation_origin: type: string name: type: string description: anyOf: - type: string - type: 'null' status: type: string enum: - open - submitted - applied - closed revision: type: integer minimum: -9007199254740991 maximum: 9007199254740991 item_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 shape: anyOf: - type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} - type: 'null' bindings: type: array items: type: object properties: shape_id: type: string artifact_digest: type: string required: - shape_id - artifact_digest additionalProperties: {} bridge_set: anyOf: - type: object properties: digest: type: string declaration_count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - digest - declaration_count additionalProperties: {} - type: 'null' created_at: type: string updated_at: type: string applied_at: anyOf: - type: string - type: 'null' replaced_by: type: string required: - id - creation_origin - name - description - status - revision - item_count - shape - bindings - bridge_set - created_at - updated_at - applied_at additionalProperties: {} schema: type: string const: penumbra.graph-extraction-review version: type: number const: 1 run_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ workspace_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ output_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ completed_at: type: string result: type: object properties: schema: type: string const: penumbra.extraction.result version: type: number const: 1 lens_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ sources: minItems: 1 maxItems: 256 type: array items: type: object properties: source_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ file_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ version_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ content_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ required: - source_ref - file_id - version_id - content_digest additionalProperties: false candidates: maxItems: 1000 type: array items: oneOf: - type: object properties: kind: type: string const: entity candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ type_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ name: default: '' type: string maxLength: 1024 properties: type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false presentation: type: object properties: name: anyOf: - type: string maxLength: 1024 - type: 'null' description: anyOf: - type: string maxLength: 8192 - type: 'null' required: - name - description additionalProperties: false citations: minItems: 1 maxItems: 32 type: array items: type: object properties: source_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ original_source_ref: type: string minLength: 1 maxLength: 64 file_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ version_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ content_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ quote: type: string minLength: 1 maxLength: 4096 start_byte: type: integer minimum: 0 maximum: 9007199254740991 end_byte_exclusive: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 quote_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ verification: type: string enum: - exact - whitespace_normalized - typography_normalized - exact_quote_rebind - normalized_quote_rebind - ellipsis_fragment required: - source_ref - file_id - version_id - content_digest - quote - start_byte - end_byte_exclusive - quote_digest - verification additionalProperties: false required: - kind - candidate_ref - type_id - name - properties - citations additionalProperties: false - type: object properties: kind: type: string const: relationship candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ relationship_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ from_candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ to_candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ properties: type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false citations: minItems: 1 maxItems: 32 type: array items: type: object properties: source_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ original_source_ref: type: string minLength: 1 maxLength: 64 file_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ version_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ content_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ quote: type: string minLength: 1 maxLength: 4096 start_byte: type: integer minimum: 0 maximum: 9007199254740991 end_byte_exclusive: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 quote_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ verification: type: string enum: - exact - whitespace_normalized - typography_normalized - exact_quote_rebind - normalized_quote_rebind - ellipsis_fragment required: - source_ref - file_id - version_id - content_digest - quote - start_byte - end_byte_exclusive - quote_digest - verification additionalProperties: false required: - kind - candidate_ref - relationship_id - from_candidate_ref - to_candidate_ref - properties - citations additionalProperties: false needs_evidence: maxItems: 2000 type: array items: type: object properties: candidate: oneOf: - type: object properties: kind: type: string const: entity candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ type_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ name: default: '' type: string maxLength: 1024 properties: type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 citations: maxItems: 32 type: array items: type: object properties: source_ref: type: string minLength: 1 maxLength: 64 quote: type: string minLength: 1 maxLength: 4096 required: - source_ref - quote additionalProperties: false route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false required: - kind - candidate_ref - type_id - name - properties - citations additionalProperties: false - type: object properties: kind: type: string const: relationship candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ relationship_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ from_candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ to_candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ properties: type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 citations: maxItems: 32 type: array items: type: object properties: source_ref: type: string minLength: 1 maxLength: 64 quote: type: string minLength: 1 maxLength: 4096 required: - source_ref - quote additionalProperties: false route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false required: - kind - candidate_ref - relationship_id - from_candidate_ref - to_candidate_ref - properties - citations additionalProperties: false issues: minItems: 1 maxItems: 32 type: array items: anyOf: - type: object properties: code: type: string enum: - citation_missing - citation_source_unknown - citation_quote_unmatched - citation_quote_ambiguous citation_index: type: integer minimum: 0 maximum: 9007199254740991 source_ref: type: string maxLength: 64 required: - code additionalProperties: false - type: object properties: code: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ required: - code additionalProperties: false required: - candidate - issues additionalProperties: false rejected: maxItems: 2000 type: array items: type: object properties: candidate: oneOf: - type: object properties: kind: type: string const: entity candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ type_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ name: default: '' type: string maxLength: 1024 properties: type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 citations: maxItems: 32 type: array items: type: object properties: source_ref: type: string minLength: 1 maxLength: 64 quote: type: string minLength: 1 maxLength: 4096 required: - source_ref - quote additionalProperties: false route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false required: - kind - candidate_ref - type_id - name - properties - citations additionalProperties: false - type: object properties: kind: type: string const: relationship candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ relationship_id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ from_candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ to_candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ properties: type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 citations: maxItems: 32 type: array items: type: object properties: source_ref: type: string minLength: 1 maxLength: 64 quote: type: string minLength: 1 maxLength: 4096 required: - source_ref - quote additionalProperties: false route: type: string enum: - record - synthesis origin: type: object properties: part: type: string minLength: 1 maxLength: 128 model: type: string minLength: 1 maxLength: 256 exchange: type: integer minimum: 0 maximum: 9007199254740991 required: - part - model - exchange additionalProperties: false flags: maxItems: 8 type: array items: type: object properties: code: type: string enum: - possible_duplicate - quote_contradicts - quote_limits - property_unsupported reason: type: string minLength: 1 maxLength: 500 relation: type: string minLength: 1 maxLength: 64 required: - code - reason additionalProperties: false required: - kind - candidate_ref - relationship_id - from_candidate_ref - to_candidate_ref - properties - citations additionalProperties: false issues: minItems: 1 maxItems: 32 type: array items: anyOf: - type: object properties: code: type: string enum: - citation_missing - citation_source_unknown - citation_quote_unmatched - citation_quote_ambiguous citation_index: type: integer minimum: 0 maximum: 9007199254740991 source_ref: type: string maxLength: 64 required: - code additionalProperties: false - type: object properties: code: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ required: - code additionalProperties: false required: - candidate - issues additionalProperties: false repair_history: maxItems: 64000 type: array items: type: object properties: citation_index: type: integer minimum: 0 maximum: 9007199254740991 method: type: string enum: - whitespace_normalized - typography_normalized - exact_quote_rebind - normalized_quote_rebind - ellipsis_fragment source_ref_before: type: string minLength: 1 maxLength: 64 source_ref_after: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ quote_before: type: string minLength: 1 maxLength: 4096 quote_after: type: string minLength: 1 maxLength: 4096 before_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ after_digest: type: string pattern: ^sha256:[a-f0-9]{64}$ candidate_ref: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$ required: - citation_index - method - source_ref_before - source_ref_after - quote_before - quote_after - before_digest - after_digest - candidate_ref additionalProperties: false omitted_count: type: integer minimum: 0 maximum: 9007199254740991 required: - schema - version - lens_digest - sources - candidates - needs_evidence - rejected - repair_history additionalProperties: false required: - workspace - schema - version - run_id - workspace_id - output_digest - completed_at - result additionalProperties: false required: - data additionalProperties: false http_graph_workspaces_extractions_response____schema0: anyOf: - type: string - type: number - type: boolean - type: 'null' - type: array items: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 - type: object propertyNames: type: string additionalProperties: $ref: >- #/components/schemas/http_graph_workspaces_extractions_response____schema0 securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.