Docsloth / developers
Self-hostStart quickstart

docsloth.dev

Model schemas

122 shared models in one JSON Schema document. Generated clients and every server validate against these definitions, so the contract cannot drift between repositories.

Actions

Actions

  • Download schema

    Downloads the exact JSON Schema document rendered on this page, with Content-Disposition set. No account, no cost.

  • Read migration

    Opens the real migration component: published version and migration history, with its prop schema and fixture.

  • Download OpenAPI contracts

    The API page is generated from the published core OpenAPI document and lists every registered operation; the cloud contract mirrors the same envelope.

$id: https://docsloth.dev/schemas/v1/models.json
ModelTypeRequired fields
ActionRequestobjectaction, reason
Actorobjectid, kind, org_id, scopes
AgentInstallPlanobjectfiles, configuration, manual_steps, requested_scopes
AgentInstallRequestobjectclient, software_id, mode, write_project_instructions
AnalyticsQueryobjectsoftware_id, metric, from, to, group_by, filters
AnalyticsResultobjectmetric, rows, data_through, sampling_rate, limitations
Approvalobjectid, target_id, action, payload_hash, expires_at, state
ApprovalDecisionobjectdecision, payload_hash
Audienceobjectid, label, intent, technical_depth, visibility
AuditEventobjectid, org_id, actor_id, action, target_id, timestamp, outcome, request_id, details_hash
AuthorizationSessionobjectid, authorization_url, expires_at
AuthorizationStartobjectprovider, purpose, return_path, requested_scopes
Budgetobjectid, scope, scope_id, limit_micro_usd, consumed_micro_usd, reserved_micro_usd, overages_enabled, revision
BudgetUpdateobjectlimit_micro_usd, overages_enabled, expected_revision
CapabilityGrantobjectid, expires_at, operation, max_charge_micro_usd, opaque_token
CapabilityRequestobjectcomponent_instance_id, resource_id, operation, payload, environment, max_charge_micro_usd
ChatAnswerobjectid, conversation_id, text, citations, unsupported_points, action_requests
ChatRequestobjectpublication_id, message, max_charge_micro_usd
CheckoutRequestobjectplan, interval, quantity, return_path
CheckoutSessionobjectid, url, expires_at
CheckResultobjectid, job_id, check, status, evidence_ids, details
ComponentInstallobjectpackage, version, integrity
ComponentInstanceobjectid, package, version, integrity, props, bindings, fact_ids, mode
ComponentManifestobjectname, version, protocol, license, description, runtime, trust_class, entry, integrity, props_schema, tools, resources, fallback, recording_policy, permissions
ConsentReceiptobjectid, site_id, purposes, consented, policy_version, issued_at, expires_at
ConsentRequestobjectsite_id, purposes, consented, policy_version, receipt_nonce
ContextPackobjectid, publication_id, text, fact_ids, evidence_ids, constraints, omissions, estimated_tokens, expires_at
ContextRequestobjecttask, publication_id, audience_id, token_budget, include_examples
CredentialCreateobjectresource_id, secret
DeploymentEventobjectexternal_id, software_id, environment_id, status, revision_vector, occurred_at
DiscoveryManifestobjectschema_version, generator, publication_id, canonical_origin, formats, visibility
DocBlockobjectid, kind, content, fact_ids, evidence_ids, ownership, visibility, verification, revision
DocPageobjectid, program_id, title, slug, locale, audience_id, snapshot_id, revision, blocks, seo
DocPatchobjectid, page_id, base_revision, operations, reason, evidence_ids, requested_checks, actor_kind
DocProgramobjectid, software_id, revision, objective, audiences, locales, source_ids, allowed_components, style, policies
Domainobjectid, software_id, hostname, state, challenge_name, challenge_value, tls_state, revision
DomainCreateobjecthostname, software_id
EditorPlanobjectid, job_id, base_revision, summary, affected_page_ids, actions, estimated_charge_micro_usd, status
EditorRequestobjectsoftware_id, program_id, instruction, mode, expected_revision, max_charge_micro_usd
Entitlementobjectid, package_name, license_version, allowed_versions, deployment_limit, status
Environmentobjectid, software_id, name, kind, source_mode, auto_publish, required_checks
Evidenceobjectid, source_id, snapshot_hash, path, method, visibility, content_hash
Executionobjectid, state, artifact_ids
Experimentobjectid, software_id, hypothesis, primary_metric, guardrails, state, variants, minimum_days, minimum_sessions_per_variant
ExperimentCreateobjecthypothesis, primary_metric, guardrails, candidate_publication_ids
Exportobjectid, job_id, status, scope, scope_id, excluded_secret_refs
ExportRequestobjectsoftware_id, format, audience_ids, include_private
Factobjectid, subject_node, predicate, value, state, evidence_ids, visibility, snapshot_id
FeedbackCreateobjectpublication_id, page_id, rating, category
FleetEnrollmentobjectnode_id, one_time_token, expires_at, control_plane_url
FleetEnrollRequestobjectname, public_key, deployment_mode, requested_capabilities
FleetNodeobjectid, name, deployment_mode, core_version, protocol_version, last_heartbeat_at, status, capabilities, egress_policy
ForgeRequestobjectsoftware_id, brief, runtime, allowed_capabilities, max_charge_micro_usd, visibility
ForgeResultobjectid, job_id, status, package_name, candidate_version, check_ids, capability_changes
GraphEdgeobjectid, source_node, target_node, kind, status, evidence_ids
GraphNodeobjectid, software_id, kind, name, qualified_name, evidence_ids, visibility, payload
GraphSliceobjectnodes, edges, truncated, omitted_count, snapshot_id
GrowthProposalobjectid, software_id, objective, evidence_refs, hypothesis, proposed_plan_id, status, expected_metric, uncertainties, revision
Healthobjectstatus, version, schema_version
ImportRequestobjectupload_id, software_id, mode, dry_run
IngestResultobjectaccepted, rejected, duplicates
InviteRequestobjectemail, role, software_ids
Invoiceobjectid, provider_id, currency, status, subtotal_cents, tax_cents, total_cents, period_start, period_end
Jobobjectid, software_id, kind, stage, attempt, created_at, updated_at, input_hash
JobEventobjectid, job_id, stage, timestamp, message
JobRequestobjectkind, dry_run, max_charge_micro_usd
MediaAssetobjectid, software_id, content_type, sha256, size_bytes, status, visibility, alt_text, artifact_key, created_at
MediaRequestobjectsoftware_id, filename, content_type, size_bytes, sha256, visibility, alt_text, caption
Membershipobjectid, org_id, user_id, role, state
Messageobjectmessage, request_id
ModelBindingobjectid, resource_id, model_id, role, mode, max_input_tokens, max_output_tokens, capabilities
Notificationobjectid, kind, title, body, target_path, created_at, read
ObservationConnectorobjectid, provider, resource_id, software_id, status, allowed_fields
Orderobjectid, org_id, seller_id, listing_id, state, subtotal_micro_usd, tax_micro_usd, fee_micro_usd, currency, created_at
OrderRequestobjectlisting_id, offer_id, license_version, quantity, approved_total_micro_usd, return_path
PackageReviewobjectpackage_id, version, decision, reason, evidence_ids
PatchOpobjectop, path
Policyobjectid, org_id, revision, name, rules
PolicyConditionunion—
Problemobjecttype, title, status, code, detail, request_id, retryable
ProviderCallbackobjectcode, state
ProviderInstallationobjectid, provider, provider_account, status, permissions, created_at
Publicationobjectid, software_id, release_id, program_revision, manifest_hash, artifact_prefix, status, canonical_origin, visibility
PublisherBalanceobjectcurrency, pending_cents, available_cents, reserved_cents, provider_account_id, last_synced_at
PublishRequestobjectcandidate_id, expected_live_id, payload_hash
Quoteobjectid, org_id, price_version, expires_at, maximum_charge_micro_usd, estimated_charge_micro_usd, line_items, approval_required
RegistryItemobjectid, manifest, publisher_id, source_url, price_kind, state, verified_identity
ReleaseManifestobjectid, software_id, mode, label, sources, deployment_ids, created_at, manifest_hash
ReplayAccessobjectsession_id, chunks, expires_at
ReplaySessionobjectid, software_id, publication_id, started_at, duration_ms, compressed_bytes, status, consent_receipt_id, chunk_count, retention_until
ReplaySettingsobjecttext, updated_at, updated_by
ReplaySettingsUpdateobjecttext
ReplayTextModestring—
ReplayUploadobjectsession_id, site_id, sequence, compressed_bytes, content_hash, consent_receipt_id, masked
Resourceobjectid, org_id, kind, provider, label, state, environment, allowed_operations, allowed_hosts, revision, credential_present
ResourceCreateobjectkind, provider, label, environment, allowed_operations, allowed_hosts, configuration
SecretFindingobjectid, page_id, surface, location, rule, detail, excerpt, acknowledged
SecretFindingLocationobjectfile
SecretFindingsAcknowledgementobjectsoftware_id, acknowledged, already_acknowledged, acknowledged_by, acknowledged_at
SecretFindingsAcknowledgeRequestobjectids
SecretFindingsProblemobjecttype, title, status, code, detail, request_id, retryable, software_id, publication_id, findings, findings_total, acknowledged_total, acknowledge_url, review_url
SecretFindingsReviewobjectpublication_id, software_id, visibility, status, schema, detector_version, scanned_at, files_scanned, counts, blocking, findings, truncated, acknowledge_url
SecretFindingsUnknownobjectstatus, code, detail, unknown_ids
ShareLinkobjectid, url, expires_at, visibility, publication_id
ShareRequestobjectanswer_id, expires_in_seconds, visibility, redacted
Softwareobjectid, org_id, name, slug, state, revision, created_at
SoftwareCreateobjectname, slug, objective, visibility
SourceBindingobjectid, software_id, provider, external_id, locator, subpath, ref, visibility, state, revision
SourceCandidateobjectinstallation_id, external_id, provider, full_name, default_branch, private, readable, clone_url
SourceCreateobjectprovider, external_id, locator, subpath, ref, visibility
SourceRefobjectpath, lines, section_id
Subscriptionobjectid, plan, state, current_period_start, current_period_end, cancel_at_period_end
TelemetryBatchobjectevents
TelemetryEventobjectid, site_id, event, timestamp, consent, properties
UploadGrantobjectid, upload_url, expires_at, max_bytes
UsageEventobjectevent_id, org_id, software_id, meter, quantity, rate_version, source, occurred_at, mode, internal_fault
UserProfileobjectid, email, display_name, workspace_ids, roles, mfa_enrolled
WebhookAckobjectaccepted, delivery_id, duplicate
WebhookHookobjectid, provider, url, created_at, created_by, revoked_at
WebhookHookCreateobjectprovider
Workspaceobjectid, name, slug, plan, created_at, revision
WorkspaceCreateobjectname, slug