Dismiss suggestion

POST

/api/v1/workflows/{workflowId}/smart/suggestions/{id}/dismiss

const url = 'https://api.justcrawl.io/api/v1/workflows/example/smart/suggestions/example/dismiss';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.justcrawl.io/api/v1/workflows/example/smart/suggestions/example/dismiss \
  --header 'Authorization: Bearer <token>'

Marks a suggestion dismissed without applying it. The DAG stays as-is; future optimization ticks can still write fresh suggestions if metrics keep favoring a different ranking. Org-scoped — cross-tenant probes return 404 indistinguishably from missing suggestions. Requires workflows:write.

Authorizations

bearerAuth

Parameters

Path Parameters

workflowId

required

string

The workflow’s stable logical id — the workflowId field of a workflow object, NOT its id field. id is the per-version row key and 404s here.

required

string

Responses

200

Suggestion dismissed.

application/json

object

status

string

Allowed values: dismissed

Example

{
  "status": "dismissed"
}

401

Missing or invalid authentication token

application/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

application/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

404

Resource not found

application/json

object

error

string

Example

{
  "error": "Workflow not found"
}

500

Unexpected server error. Logs and PostHog $exception capture

application/json

object

error

string

Example

{
  "error": "Something went wrong"
}