API documentation

Policy encoding

Policy should be encoded as a reviewed, versioned Decionis artifact rather than hidden inside connector code, wrappers, or partner-specific middleware. When policy lives across PDFs, markdown, Jira, Confluence, XML, transaction logs, SAP notes, or uploads, start with a draft and then persist the accepted version.

Draft flow

Draft generation turns scattered source material into a strategy-shaped Decionis artifact that can be reviewed before versioning.

Stage	What happens
Collect sources	Provide pasted text, direct-upload artifacts such as PDF or markdown exports, and optionally live pull connectors for Jira, Confluence, SAP, Google Drive, Notion, or a Git-backed repository.
Extract	Decionis can pull live connector content on demand, normalizes the readable text, uses the configured LLM when available, and falls back to deterministic extraction heuristics when it is not.
Review	The draft response includes extracted source metadata, warnings, open questions, review checklist items, and strategy-compatible JSON.
Version	Once accepted, persist the reviewed draft through the existing policy strategy create path so it becomes the next version in the policy family.

Draft endpoint

Use this route when policy intent lives across multiple silos and needs to be converted into a reviewable Decionis strategy draft.

POST/v1/orgs/:orgId/policies/strategies/draftAPI key

Generate a non-persistent policy draft from pasted text, uploads, and optional live pull connectors.

curl -X POST https://api.decionis.com/v1/orgs/<org_id>/policies/strategies/draft \
  -H "Authorization: Bearer sk_org_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "suggested_name": "finance-routing-approval",
    "workflow_key": "finance_routing_approval",
    "live_connector_ids": ["<jira_connector_uuid>", "<confluence_connector_uuid>"],
    "sources": [
      {
        "label": "Jira approval flow",
        "source_type": "JIRA",
        "content": "Invoices above 10000 EUR require finance manager review before payment."
      },
      {
        "label": "Procurement policy PDF",
        "source_type": "UPLOAD",
        "file_name": "procurement-policy.pdf",
        "content_type": "application/pdf",
        "content_base64": "<base64>"
      }
    ]
  }'

{
  "generated_at": "2026-04-22T10:30:00.000Z",
  "draft": {
    "used_llm": true,
    "suggested_name": "finance-routing-approval",
    "workflow_key": "finance_routing_approval",
    "summary": "Encoded 2 sources into a draft policy with 1 auto-execute, 2 review, and 1 block/ignore clauses.",
    "strategy": {
      "name": "finance-routing-approval",
      "status": "DRAFT",
      "rollout_percentage": 0,
      "strategy_rules": {
        "min_confidence": 0.85,
        "require_human_review_above_risk": "medium",
        "required_signal_domains": ["JIRA", "PDF"],
        "encoded_policy": {
          "workflow_key": "finance_routing_approval",
          "auto_execute": ["Route low-risk invoices under threshold directly."],
          "escalate_for_review": ["Invoices above 10000 EUR require finance manager review."],
          "ignore_or_block": ["Reject requests missing a vendor reference."]
        }
      },
      "metadata": {
        "review_status": "PENDING_REVIEW",
        "source_materials": [
          { "label": "Jira approval flow", "source_type": "JIRA" },
          { "label": "Finance wiki / AP thresholds", "source_type": "CONFLUENCE" }
        ]
      }
    },
    "review_checklist": ["Review thresholds and owners before publish."],
    "open_questions": ["Confirm the exact confidence threshold for autonomous execution."],
    "warnings": []
  }
}

Source connectors

These routes register reusable live pull connectors that can be selected when generating a policy draft.

GET/v1/orgs/:orgId/policy-sources/connector-typesAPI key

List the live connector types available to this workspace.

POST/v1/orgs/:orgId/policy-sources/connectorsAPI key

Create a reusable live source connector for Jira, Confluence, SAP, Google Drive, Notion, or a Git-backed repository.

{
  "name": "finance-confluence",
  "connector_type": "confluence",
  "poll_interval_minutes": 60,
  "config": {
    "base_url": "https://your-domain.atlassian.net/wiki",
    "space_keys": "FINANCE",
    "max_results": 10
  },
  "credentials": {
    "email": "policy-bot@example.com",
    "api_token": "<token>"
  }
}

POST/v1/orgs/:orgId/policy-sources/connectors/:connectorId/pullAPI key

Run an immediate live pull and update the connector's pull status.

Bundle contract

After review, policy should still be published as a stable versioned artifact for downstream Decision Dossier lineage.

{
  "protocol_version": "v1",
  "artifact_type": "policy_bundle",
  "org_id": "<org_uuid>",
  "bundle_key": "study-abroad-eligibility-v1",
  "version": "2026-03-11",
  "author": "partner-policy-team",
  "workflow_key": "study_abroad_eligibility",
  "rules": [
    {
      "rule_key": "require_verified_signal",
      "action": "reject_if_missing"
    },
    {
      "rule_key": "require_fresh_assertion",
      "action": "recompute_if_stale"
    }
  ]
}

Review and versioning

Draft generation does not persist anything by itself. Persist the accepted result through the strategy create route, and use the protocol bundle route when an integration submits policy directly.

POST/v1/orgs/:orgId/policies/strategiesAPI key

Persist the reviewed draft as the next version in a policy family.

curl -X POST https://api.decionis.com/v1/orgs/<org_id>/policies/strategies \
  -H "Authorization: Bearer sk_org_xxx" \
  -H "Content-Type: application/json" \
  -d @draft-reviewed-policy.json

POST/v1/protocol/policies/bundlesAPI key

Submit a protocol-level versioned policy bundle when an integration participates directly in policy authoring.

POST/v1/protocol/executions/dispatchesAPI key

Submit a governed execution dispatch artifact when the partner also participates in downstream execution.

Required fields

These fields define the minimum useful identity, review, and lineage for draft generation and published policy artifacts.

Field	Description
org_id	Owning Decionis organization identifier.
sources	Draft endpoint input. Source array with pasted text or uploaded file content encoded as base64.
live_connector_ids	Optional draft endpoint input. Existing policy source connector IDs to pull live during draft generation.
suggested_name	Optional policy family name to guide the draft output.
workflow_key	Workflow the draft or bundle governs.
review_checklist / open_questions	Draft endpoint output used to drive human review before a version is saved.
protocol_version	Protocol version used by the published artifact.
artifact_type	Artifact class. Use policy_bundle for protocol-level policy submissions.
bundle_key	Stable key for the policy bundle family.
version	Version label or timestamp for the published policy artifact.
rules	Ordered list of published policy rules or policy graph nodes.

Loading…

Decionis API Reference

Base URL: https://api.decionis.com/v1

Quickstart Main site Contact