NUnullplatform
Suggestion

Approve a suggestion

Changed on

Approve a pending suggestion. The owning agent will then execute the fix.

post/action_item/{actionItemId}/suggestions/{id}/approve

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/action_item/{actionItemId}/suggestions/{id}/approve
  • Auth
    HTTP bearer

Path parameters

actionItemIdstring required

The action item ID.

idstring required

The suggestion ID.

Response

The approved suggestion.

idstring

The unique suggestion ID.

slugstring

Auto-generated URL-friendly slug.

action_item_idstring

The parent action item ID.

status'pending' | 'approved' | 'applied' | 'failed' | 'rejected' | 'expired'

The current status.

created_bystring

The agent that created the suggestion.

ownerstring

The agent or system that will execute the fix.

confidencenumber

Confidence score between 0 and 1.

descriptionstring

A description of the proposed fix. Supports Markdown.

metadataobject

Machine-to-machine metadata for the executor.

user_metadataobject

Human-editable parameters.

user_metadata_configobject

JSON Schema for rendering user_metadata in the UI.

executed_atstring date

Date when the suggestion was executed.

expires_atstring date

Expiration date.

created_atstring date-time

Creation timestamp.

updated_atstring date-time

Last update timestamp.

Example response

{
  "id": "sUg123AbCdEf",
  "slug": "update-dockerfile-base-image",
  "action_item_id": "xYz789AbCdEf",
  "status": "pending",
  "created_by": "security-scanner-agent",
  "owner": "image-updater-agent",
  "confidence": 0.92,
  "description": "Update the Dockerfile base image to resolve CVE-2026-1234.",
  "metadata": {
    "repository": "org/my-api-service",
    "branch": "fix/cve-2026-1234"
  },
  "user_metadata": {
    "target_version": "20-alpine3.19"
  },
  "execution_result": {
    "success": true,
    "message": "Base image updated successfully.",
    "details": {
      "pull_request": "https://github.com/org/my-api-service/pull/42"
    }
  },
  "expires_at": "2026-05-15",
  "created_at": "2026-04-06T12:30:00.000Z",
  "updated_at": "2026-04-06T12:30:00.000Z"
}

Changes

  • 728d4df70ca1Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      removed subschema #1 subschema #2 from the response body oneOf list for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status