Skip to Content
veriom

Get security md refinement

A refinement's state and, once it succeeded, the refined file and its new rules.

GET
/v1/workspaces/{workspace_id}/tools/security-md/refinements/{refinement_id}

A refinement's state and, once it succeeded, the refined file and its new rules.

Authorization

workspaceToken
headerAuthorizationBearer <vat_<opaque-token>>

Expiring, hashed workspace token with explicit scopes.

Path Parameters

workspace_id*Workspace Id
Formatuuid
refinement_id*Refinement Id
Formatuuid

Response Body

Successful Response

application/json
  1. response
completed_at?|null
created_at*Created At
Formatdate-time
dropped_rules?Dropped Rules

Proposed rules left out: uncited, repeated or not plain policy.

Default0
error_code?string|null
file?|

The refined file, once the refinement succeeded.

id*Id
Formatuuid
rules?array<>
rules_without_room?Rules Without Room

Supported rules the format had no room for without losing a rule it already had (Windsurf reads at most 6,000 characters).

Default0
started_at?|null
status*Status
Value in"queued""running""succeeded""failed"
Example Request
curl -X GET 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/tools/security-md/refinements/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{  "completed_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "dropped_rules": 0,  "error_code": "string",  "file": {    "content": "string",    "filename": "string",    "media_type": "text/markdown",    "path": "string",    "sha256": "string",    "shortened": true,    "target": "claude_skill",    "target_label": "string"  },  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "rules": [    {      "evidence_ids": [        "string"      ],      "subject": "string",      "text": "string"    }  ],  "rules_without_room": 0,  "started_at": "2019-08-24T14:15:22Z",  "status": "queued"}