Documentation
REST API reference (v1)
Generated from the shared contract route table. Agent protocol: datanivra.agent/v1.
| Method | Path | Operation | Auth | Permission | Request → response |
|---|---|---|---|---|---|
GET | /v1/health | getHealth | Public | — | — → HealthStatus |
GET | /v1/health/live | getLiveness | Public | — | — → HealthStatus |
POST | /v1/auth/dev-login | devLogin | Public | — | DevLogin → SessionToken |
GET | /v1/auth/oidc/config | getOidcConfig | Public | — | — → OidcConfig |
POST | /v1/auth/oidc/start | startOidcLogin | Public | — | OidcLoginStart → OidcAuthorization |
POST | /v1/auth/oidc/callback | completeOidcLogin | Public | — | OidcCallback → SessionToken |
POST | /v1/auth/oidc/exchange | exchangeOidcToken | Public | — | OidcTokenExchange → SessionToken |
GET | /v1/auth/signup/config | getSignupConfig | Public | — | — → SignupConfig |
POST | /v1/auth/signup/start | startSignup | Public | — | SignupStart → SignupAccepted |
POST | /v1/auth/signup/verify | verifySignup | Public | — | SignupVerify → SignupTicket |
POST | /v1/auth/signup/slug | suggestTenantSlug | Public | — | SlugRequest → SlugSuggestion |
POST | /v1/auth/signup/complete | completeSignup | Public | — | SignupComplete → SessionToken |
POST | /v1/auth/email/start | startEmailLogin | Public | — | EmailLoginStart → SignupAccepted |
POST | /v1/auth/email/complete | completeEmailLogin | Public | — | EmailLoginComplete → SessionToken |
POST | /v1/auth/cli/start | startCliLogin | Public | — | CliLoginStart → CliLoginStarted |
POST | /v1/auth/cli/token | pollCliLogin | Public | — | CliLoginPoll → SessionToken |
POST | /v1/auth/cli/describe | describeCliLogin | User | — | CliLoginLookup → CliLoginRequestInfo |
POST | /v1/auth/cli/decide | decideCliLogin | User | — | CliLoginDecision → CliLoginRequestInfo |
POST | /v1/auth/session/refresh | refreshSession | User | — | — → SessionToken |
POST | /v1/auth/logout | logout | User | — | — → LogoutResult |
GET | /v1/me | getMe | User | — | — → User |
GET | /v1/tenant | getTenant | User | — | — → Tenant |
GET | /v1/organization | getOrganization | User | — | — → Organization |
PATCH | /v1/organization | updateOrganization | User | org.admin | OrganizationUpdate → Organization |
GET | /v1/organization/separation-of-duties | getSeparationOfDuties | User | org.admin | — → SeparationOfDutiesSettings |
PATCH | /v1/organization/separation-of-duties | updateSeparationOfDuties | User | org.admin | SeparationOfDutiesSettings → SeparationOfDutiesSettings |
GET | /v1/organization/execution-isolation | getExecutionIsolation | User | org.admin | — → ExecutionIsolationRequirement |
PATCH | /v1/organization/execution-isolation | updateExecutionIsolation | User | org.admin | ExecutionIsolationRequirement → ExecutionIsolationRequirement |
GET | /v1/roles | listRoles | User | — | — → RoleDefinition[] |
GET | /v1/users | listUsers | User | user.manage | — → User[] |
POST | /v1/users | inviteUser | User | user.manage | UserInvite → User |
PATCH | /v1/users/{user_id}/roles | updateUserRoles | User | user.manage | RoleAssignmentUpdate → User |
POST | /v1/users/{user_id}/disable | disableUser | User | user.manage | — → User |
POST | /v1/users/{user_id}/enable | enableUser | User | user.manage | — → User |
POST | /v1/auth/workload/token | exchangeWorkloadToken | Public | — | WorkloadTokenExchange → SessionToken |
GET | /v1/workload-identities | listWorkloadIdentities | User | org.admin | — → WorkloadIdentityTrust[] |
POST | /v1/workload-identities | createWorkloadIdentity | User | org.admin | WorkloadIdentityTrustCreate → WorkloadIdentityTrust |
GET | /v1/workload-identities/{workload_identity_id} | getWorkloadIdentity | User | org.admin | — → WorkloadIdentityTrust |
POST | /v1/workload-identities/{workload_identity_id}/disable | disableWorkloadIdentity | User | org.admin | WorkloadIdentityDisable → WorkloadIdentityTrust |
GET | /v1/organization/test-data-settings | getTestDataSettings | User | org.admin | — → TestDataSettings |
PATCH | /v1/organization/test-data-settings | updateTestDataSettings | User | org.admin | TestDataSettingsUpdate → TestDataSettings |
GET | /v1/agents | listAgents | User | agent.read | — → AgentRegistration[] |
GET | /v1/agents/{agent_id} | getAgent | User | agent.read | — → AgentRegistration |
POST | /v1/agents/enrollment-tokens | createEnrollmentToken | User | agent.manage | AgentEnrollmentTokenRequest → EnrollmentTokenIssued |
POST | /v1/agents/{agent_id}/revoke | revokeAgent | User | agent.manage | — → AgentRegistration |
POST | /v1/agent/enroll | agentEnroll | Enrollment token | — | AgentEnvelope → ControlPlaneEnvelope |
POST | /v1/agent/token | agentToken | Agent | — | — → AgentAccessToken |
POST | /v1/agent/heartbeat | agentHeartbeat | Agent | — | AgentEnvelope → ControlPlaneEnvelope |
POST | /v1/agent/leases | agentLease | Agent | — | AgentEnvelope → ControlPlaneEnvelope |
POST | /v1/agent/leases/{lease_id}/ack | agentLeaseAck | Agent | — | AgentEnvelope → ControlPlaneEnvelope |
POST | /v1/agent/leases/{lease_id}/renew | agentLeaseRenew | Agent | — | AgentEnvelope → ControlPlaneEnvelope |
POST | /v1/agent/reports | agentReport | Agent | — | AgentEnvelope → ControlPlaneEnvelope |
GET | /v1/sources | listSources | User | source.read | — → DataSourceDescriptor[] |
POST | /v1/sources | createSource | User | source.register | DataSourceCreate → DataSourceDescriptor |
GET | /v1/sources/{source_id} | getSource | User | source.read | — → DataSourceDescriptor |
POST | /v1/sources/{source_id}/sensitivity-attestation | attestSourceSensitivity | User | source.attest | SourceSensitivityAttestation → DataSourceDescriptor |
POST | /v1/sources/{source_id}/discover | discoverSource idempotent | User | discovery.run | — → Job |
GET | /v1/sources/{source_id}/schema | getSourceSchema | User | source.read | — → SchemaMetadata |
GET | /v1/findings | listFindings | User | source.read | — → SensitiveFieldFinding[] |
POST | /v1/findings/{finding_id}/review | reviewFinding | User | finding.review | FindingReview → SensitiveFieldFinding |
GET | /v1/policies | listPolicies | User | policy.read | — → Policy[] |
POST | /v1/policies | createPolicy | User | policy.edit | PolicyCreate → Policy |
GET | /v1/policies/{policy_id} | getPolicy | User | policy.read | — → Policy |
GET | /v1/policies/{policy_id}/versions | listPolicyVersions | User | policy.read | — → PolicyVersion[] |
POST | /v1/policies/{policy_id}/versions | createPolicyVersion | User | policy.edit | PolicyVersionCreate → PolicyVersion |
POST | /v1/policies/{policy_id}/versions/{version}/submit | submitPolicyVersion | User | policy.edit | — → PolicyVersion |
POST | /v1/policies/{policy_id}/versions/{version}/approve | approvePolicyVersion | User | policy.approve | PolicyApproval → PolicyVersion |
GET | /v1/policies/{policy_id}/versions/{version}/identity-validation | validateIdentityGraph | User | policy.read | — → IdentityGraphValidation |
POST | /v1/identity-mapping/suggestions | suggestIdentityLinks | User | policy.edit | IdentityLinkSuggestionRequest → IdentityLinkSuggestions |
POST | /v1/identity-mapping/plan | planIdentityClosure | User | dataset.read | IdentityClosurePlanRequest → IdentityClosurePlan |
GET | /v1/masking-domains | listMaskingDomains | User | policy.read | — → MaskingDomainEntry[] |
POST | /v1/policies/{policy_id}/versions/{version}/identity-overlap | requestIdentityOverlap | User | discovery.run | IdentityOverlapRequest → IdentityOverlapEvidence |
GET | /v1/policies/{policy_id}/versions/{version}/identity-overlap | listIdentityOverlap | User | policy.read | — → IdentityOverlapEvidence[] |
POST | /v1/policies/{policy_id}/versions/{version}/deprecate | deprecatePolicyVersion | User | policy.approve | — → PolicyVersion |
POST | /v1/policies/{policy_id}/versions/{version}/revoke | revokePolicyVersion | User | policy.approve | PolicyRevocation → PolicyVersion |
GET | /v1/environments | listEnvironments | User | dataset.read | — → Environment[] |
POST | /v1/environments | createEnvironment | User | environment.manage | EnvironmentCreate → Environment |
GET | /v1/dataset-requests | listDatasetRequests | User | dataset.read | — → DatasetRequest[] |
POST | /v1/dataset-requests | createDatasetRequest idempotent | User | dataset.request | DatasetRequestCreate → DatasetRequest |
GET | /v1/dataset-requests/{request_id} | getDatasetRequest | User | dataset.read | — → DatasetRequest |
POST | /v1/dataset-requests/{request_id}/cancel | cancelDatasetRequest | User | dataset.request | — → DatasetRequest |
POST | /v1/dataset-requests/{request_id}/approve | approveDatasetRequest | User | dataset.approve | DatasetRequestDecision → DatasetRequest |
POST | /v1/dataset-requests/{request_id}/reject | rejectDatasetRequest | User | dataset.approve | DatasetRequestDecision → DatasetRequest |
GET | /v1/datasets | listDatasets | User | dataset.read | — → Dataset[] |
GET | /v1/datasets/{dataset_id} | getDataset | User | dataset.read | — → Dataset |
GET | /v1/datasets/{dataset_id}/versions | listDatasetVersions | User | dataset.read | — → DatasetVersion[] |
GET | /v1/datasets/{dataset_id}/versions/{version}/manifest | getDatasetManifest | User | dataset.read | — → DatasetManifest |
GET | /v1/datasets/{dataset_id}/lineage | getDatasetLineage | User | dataset.read | — → LineageGraph |
POST | /v1/datasets/{dataset_id}/refresh | refreshDataset idempotent | User | dataset.request | RefreshRequest → Job |
POST | /v1/datasets/{dataset_id}/versions/{version}/provision | provisionDataset idempotent | User | dataset.provision | ProvisionRequest → Job |
POST | /v1/datasets/{dataset_id}/revoke | revokeDataset | User | dataset.revoke | DatasetRevocation → Dataset |
POST | /v1/datasets/{dataset_id}/versions/{version}/certification-review | reviewDatasetCertification | User | certification.review | CertificationReviewDecision → DatasetVersion |
POST | /v1/datasets/{dataset_id}/rollback | rollbackDataset idempotent | User | dataset.provision | RollbackRequest → Job |
GET | /v1/refresh-calendar | getRefreshCalendar | User | dataset.read | — → RefreshCalendarEntry[] |
GET | /v1/jobs | listJobs | User | job.read | — → Job[] |
GET | /v1/jobs/{job_id} | getJob | User | job.read | — → Job |
GET | /v1/jobs/{job_id}/steps | listJobSteps | User | job.read | — → JobStep[] |
GET | /v1/jobs/{job_id}/events | listJobEvents | User | job.read | — → JobEvent[] |
POST | /v1/jobs/{job_id}/cancel | cancelJob | User | job.cancel | — → Job |
GET | /v1/certification-reports | listCertificationReports | User | dataset.read | — → CertificationReport[] |
GET | /v1/certification-reports/{report_id} | getCertificationReport | User | dataset.read | — → CertificationReport |
GET | /v1/evidence | listEvidence | User | dataset.read | — → EvidenceReference[] |
GET | /v1/audit-events | listAuditEvents | User | audit.read | — → AuditEvent[] |
GET | /v1/audit-events/verify | verifyAuditChain | User | audit.read | — → AuditChainVerification |
GET | /v1/certificates | listCertificates | User | dataset.read | — → CertificateSummary[] |
GET | /v1/certificates/{certificate_id} | getCertificate | User | dataset.read | — → TestDataCertificate |
GET | /v1/certificates/{certificate_id}/status | getCertificateStatus | User | dataset.read | — → CertificateStatusStatement |
GET | /v1/certificates/{certificate_id}/package | getCertificatePackage | User | dataset.read | — → CertificateEvidencePackage |
GET | /v1/certificate-keys | listCertificateKeys | Public | — | — → CertificateKeySet |
GET | /v1/audit-export | exportAuditEvidence | User | audit.read | — → AuditEvidenceExport |
GET | /v1/industry-packs | listIndustryPacks | User | — | — → IndustryPack[] |
POST | /v1/industry-packs/{pack_id}/enable | enableIndustryPack | User | pack.manage | — → IndustryPack |
POST | /v1/industry-packs/{pack_id}/disable | disableIndustryPack | User | pack.manage | — → IndustryPack |
GET | /v1/industry-packs/{pack_id} | getIndustryPack | User | — | — → IndustryPackDetail |
POST | /v1/industry-packs/{pack_id}/upgrade | upgradeIndustryPack | User | pack.manage | PackVersionChange → IndustryPack |
POST | /v1/industry-packs/{pack_id}/rollback | rollbackIndustryPack | User | pack.manage | — → IndustryPack |
POST | /v1/industry-packs/{pack_id}/policy-drafts | createPackPolicyDrafts | User | policy.edit | PackPolicyDraftRequest → PackPolicyDrafts |
GET | /v1/entitlements/current | getCurrentEntitlement | User | billing.read | — → Entitlement |
GET | /v1/usage | listUsage | User | billing.read | — → UsageMeter[] |
POST | /v1/billing/webhooks/{provider} | receiveBillingWebhook | provider | — | — → WebhookAck |
GET | /v1/billing/subscription | getBillingSubscription | User | billing.read | — → SubscriptionView |
POST | /v1/billing/checkout | createBillingCheckout idempotent | User | billing.manage | CheckoutRequest → CheckoutResponse |
POST | /v1/billing/subscription/cancel | cancelBillingSubscription | User | billing.manage | — → SubscriptionView |
GET | /v1/billing/overview | getBillingOverview | User | billing.read | — → BillingOverview |
POST | /v1/billing/portal | createBillingPortalSession | User | billing.manage | — → BillingPortalSession |
POST | /v1/billing/subscription/change | changeBillingPlan idempotent | User | billing.manage | PlanChangeRequest → SubscriptionView |
POST | /v1/capacity/estimate | estimateCapacity | User | — | CapacityEstimateRequest → CapacityEstimate |
GET | /v1/sandbox | getSandbox | User | — | — → SandboxView |
POST | /v1/sandbox | createSandbox | User | agent.manage | SandboxCreate → SandboxView |
POST | /v1/sandbox/reset | resetSandbox | User | agent.manage | — → SandboxView |
POST | /v1/sandbox/progress | updateSandboxProgress | User | — | SandboxProgressUpdate → SandboxView |
POST | /v1/sandbox-runner/claims | claimSandboxWork | runner | — | — → SandboxClaims |
POST | /v1/sandbox-runner/sandboxes/{sandbox_id}/report | reportSandboxStatus | runner | — | SandboxRunnerReport → SandboxRunnerAck |
POST | /v1/sandbox-runner/usage | reportSandboxUsage | runner | — | SandboxUsageReport → SandboxUsageAck |
GET | /v1/reservations | listReservations | User | dataset.read | — → DatasetReservation[] |
POST | /v1/reservations | createReservation | User | dataset.provision | DatasetReservationCreate → DatasetReservation |
GET | /v1/reservations/{reservation_id} | getReservation | User | dataset.read | — → DatasetReservation |
POST | /v1/reservations/{reservation_id}/renew | renewReservation | User | dataset.provision | DatasetReservationRenew → DatasetReservation |
POST | /v1/reservations/{reservation_id}/release | releaseReservation | User | dataset.provision | DatasetReservationRelease → DatasetReservation |
GET | /v1/environment-leases | listEnvironmentLeases | User | dataset.read | — → EnvironmentLease[] |
POST | /v1/environment-leases | createEnvironmentLease idempotent | User | dataset.provision | EnvironmentLeaseCreate → EnvironmentLease |
GET | /v1/environment-leases/{lease_id} | getEnvironmentLease | User | dataset.read | — → EnvironmentLease |
POST | /v1/environment-leases/{lease_id}/renew | renewEnvironmentLease | User | dataset.provision | EnvironmentLeaseRenew → EnvironmentLease |
POST | /v1/environment-leases/{lease_id}/release | releaseEnvironmentLease | User | dataset.provision | EnvironmentLeaseRelease → EnvironmentLease |
GET | /v1/environment-leases/{lease_id}/evidence | getEnvironmentLeaseEvidence | User | dataset.read | — → EnvironmentLeaseEvidence |
GET | /v1/custom-schemas | listCustomSchemas | User | policy.read | — → CustomSchema[] |
POST | /v1/custom-schemas | createCustomSchema | User | policy.edit | CustomSchemaCreate → CustomSchema |
GET | /v1/custom-schemas/{custom_schema_id} | getCustomSchema | User | policy.read | — → CustomSchema |
GET | /v1/custom-schemas/{custom_schema_id}/versions | listCustomSchemaVersions | User | policy.read | — → CustomSchemaVersion[] |
POST | /v1/custom-schemas/{custom_schema_id}/versions | createCustomSchemaVersion | User | policy.edit | CustomSchemaVersionCreate → CustomSchemaVersion |
GET | /v1/custom-schemas/{custom_schema_id}/versions/{version} | getCustomSchemaVersion | User | policy.read | — → CustomSchemaVersion |
POST | /v1/custom-schemas/{custom_schema_id}/archive | archiveCustomSchema | User | policy.edit | CustomSchemaArchive → CustomSchema |
GET | /v1/test-data/profiles | listTestDataProfiles | User | test_data.request | — → TestDataProfileSummary[] |
POST | /v1/test-data/plan | planTestDataRequest | User | test_data.request | TestDataRequestCreate → TestDataPlan |
POST | /v1/test-data/requests | createTestDataRequest idempotent | User | test_data.request | TestDataRequestCreate → TestDataRequest |
GET | /v1/test-data/requests | listTestDataRequests | User | test_data.request | — → TestDataRequest[] |
GET | /v1/test-data/requests/{test_data_request_id} | getTestDataRequest | User | test_data.request | — → TestDataRequest |
POST | /v1/test-data/requests/{test_data_request_id}/approve | approveTestDataRequest | User | dataset.approve | TestDataRequestDecision → TestDataRequest |
POST | /v1/test-data/requests/{test_data_request_id}/reject | rejectTestDataRequest | User | dataset.approve | TestDataRequestDecision → TestDataRequest |
POST | /v1/test-data/requests/{test_data_request_id}/release | releaseTestDataRequest | User | test_data.request | TestDataRequestRelease → TestDataRequest |
GET | /v1/dataset-requests/{request_id}/repro-bundle | getReproBundle | User | dataset.read | — → ReproBundle |
POST | /v1/dataset-requests/{request_id}/repro-bundle/lease | createReproLease idempotent | User | dataset.provision | ReproLeaseCreate → EnvironmentLease |
POST | /v1/repro-revocations | revokeReproByIssue | User | dataset.revoke | ReproRevocation → ReproRevocationResult |
GET | /v1/eval-sets | listEvalSets | User | dataset.read | — → EvalSet[] |
POST | /v1/eval-sets | registerEvalSet | User | dataset.request | EvalSetCreate → EvalSet |
GET | /v1/eval-sets/{eval_set_id} | getEvalSet | User | dataset.read | — → EvalSet |
GET | /v1/eval-sets/{eval_set_id}/export | exportEvalSet | User | dataset.read | — → EvalSetExport |
GET | /v1/model-provider-policy | getModelProviderPosture | User | policy.read | — → ModelProviderPosture |
GET | /v1/datasets/{dataset_id}/versions/{version}/document-set | getDatasetDocumentSet | User | dataset.read | — → DocumentSetSummary |
GET | /v1/compliance-guard/environments | listGuardedEnvironments | User | guard.read | — → GuardedEnvironment[] |
POST | /v1/compliance-guard/environments | createGuardedEnvironment idempotent | User | guard.manage | GuardedEnvironmentCreate → GuardedEnvironment |
GET | /v1/compliance-guard/environments/{guarded_environment_id} | getGuardedEnvironment | User | guard.read | — → GuardedEnvironment |
PATCH | /v1/compliance-guard/environments/{guarded_environment_id} | updateGuardedEnvironment | User | guard.manage | GuardedEnvironmentUpdate → GuardedEnvironment |
POST | /v1/compliance-guard/environments/{guarded_environment_id}/scans | requestGuardScan idempotent | User | guard.manage | GuardScanRequest → GuardScan |
POST | /v1/compliance-guard/environments/{guarded_environment_id}/baseline | acceptGuardBaseline | User | guard.manage | GuardBaselineAccept → GuardedEnvironment |
GET | /v1/compliance-guard/scans | listGuardScans | User | guard.read | — → GuardScan[] |
GET | /v1/compliance-guard/scans/{scan_id} | getGuardScan | User | guard.read | — → GuardScan |
GET | /v1/compliance-guard/findings | listComplianceFindings | User | guard.read | — → ComplianceFindingRecord[] |
GET | /v1/compliance-guard/findings/{compliance_finding_id} | getComplianceFinding | User | guard.read | — → ComplianceFindingRecord |
POST | /v1/compliance-guard/findings/{compliance_finding_id}/acknowledge | acknowledgeComplianceFinding | User | guard.triage | GuardTriageRequest → ComplianceFindingRecord |
POST | /v1/compliance-guard/findings/{compliance_finding_id}/suppress | suppressComplianceFinding | User | guard.triage | GuardSuppressionCreate → ComplianceFindingRecord |
POST | /v1/compliance-guard/findings/{compliance_finding_id}/false-positive | markComplianceFindingFalsePositive | User | guard.triage | GuardTriageRequest → ComplianceFindingRecord |
POST | /v1/compliance-guard/findings/{compliance_finding_id}/reopen | reopenComplianceFinding | User | guard.triage | GuardTriageRequest → ComplianceFindingRecord |
GET | /v1/compliance-guard/notification-channels | listNotificationChannels | User | guard.read | — → NotificationChannel[] |
POST | /v1/compliance-guard/notification-channels | createNotificationChannel | User | guard.manage | NotificationChannelCreate → NotificationChannel |
PATCH | /v1/compliance-guard/notification-channels/{channel_id} | updateNotificationChannel | User | guard.manage | NotificationChannelUpdate → NotificationChannel |
POST | /v1/compliance-guard/notification-channels/{channel_id}/test | testNotificationChannel | User | guard.manage | — → GuardNotificationEvent |
GET | /v1/compliance-guard/trend | getComplianceGuardTrend | User | guard.read | — → GuardTrend |
GET | /v1/compliance-guard/guidance | listGuardGuidance | User | guard.read | — → GuardGuidance[] |
GET | /v1/public/plans | listPlans | Public | — | — → PlanOffer[] |
POST | /v1/public/leads | submitLead | Public | — | LeadSubmission → ReportAck |
POST | /v1/public/leads/form-tokens | issueLeadFormToken | Public | — | — → LeadFormToken |
POST | /v1/public/connector-interest | submitConnectorInterest | Public | — | ConnectorInterest → ReportAck |
POST | /v1/public/feature-requests | submitFeatureRequest | Public | — | FeatureRequestSubmission → ReportAck |
POST | /v1/feature-requests | submitConsoleFeatureRequest | User | — | FeatureRequestSubmission → ReportAck |
Read the API overview for authentication, errors, pagination and idempotency.