SEO

List SEO fixes

Vidrys's proposed fixes to page titles, meta descriptions and canonical tags: what each page has, what it would get, and where each fix stands. Approving is done on the dashboard.

GEThttps://api.vidrys.com/v1/projects/{project_id}/seo/fixes

Plan: Track and above
Key: read
Rate cost: 1 unit
MCP tool: list_seo_fixes

List SEO fixes

curl --request GET \
  --url "https://api.vidrys.com/v1/projects/{project_id}/seo/fixes" \
  --header "Authorization: Bearer $VIDRYS_API_KEY"

200 · success

{
  "mode": "on",
  "deploys_remaining": 54,
  "fixes": [
    {
      "id": "d4e5f6a7-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
      "url": "https://acmeinvoicing.com/pricing",
      "fix_type": "meta_description",
      "label": "Meta description",
      "status": "verified",
      "current_value": null,
      "proposed_value": "Plans from ₹999 a month for freelancers and small teams, GST invoices included.",
      "rationale": "Taken from the opening of this page's own text, fitted to 50-160 characters.",
      "provider": "ghost",
      "dry_run": false,
      "written": true,
      "deployed_at": "2026-09-27T09:12:40+00:00",
      "verified_at": "2026-09-27T09:13:51+00:00",
      "error": null,
      "created_at": "2026-09-27T03:41:02+00:00",
      "updated_at": "2026-09-27T09:13:51+00:00"
    }
  ],
  "page": {
    "page": 1,
    "page_size": 50,
    "total": 1
  }
}

Authorization

Sent as a header on every request.

Authorizationstringrequired

A Vidrys API key, sent as Bearer vidrys_sk_…. A read key is enough. See Authentication.

Path parameters

project_idstringrequired

The project's id, from List projects.

Query parameters

pageintegerdefault 1

Page number, from 1.

page_sizeintegerdefault 50

Rows per page, 1–100.

Response · 200

application/json

modestring

Whether this deployment writes fixes: off, dry runs only, or on.

Values:offshadowon

deploys_remaininginteger

Fixes the plan still allows this month.

fixesobject[]

Every fix of the project, newest first.

+Show child attributes

idstring

Fix id.

urlstring

The page.

fix_typestring

The field it changes.

Values:titlemeta_descriptioncanonical

labelstring

The field's name on the screen.

statusstring

Where the fix stands. verified means the live page carries the value; unverified means it was written but the page does not show it.

Values:proposedapproveddeployingdeployedverifiedunverifiedfailedrolling_backrolled_backdismissed

current_valuestringnullable

What the page had when the fix was proposed. Null: nothing.

proposed_valuestringnullable

What the fix sets.

rationalestringnullable

Where the value came from.

providerstringnullable

The CMS it is written through, once known.

dry_runboolean

Approving now would run, or ran, as a dry run.

writtenbooleannullable

Whether Vidrys itself wrote the value. False when it was found already in place.

deployed_atstringnullable

When it was written, ISO 8601.

verified_atstringnullable

When the live page was found carrying it.

errorstringnullable

Why it failed, when it did.

created_atstring

ISO 8601.

updated_atstring

ISO 8601.

pageobject

Where these rows sit in the full list.

+Show child attributes

pageinteger

This page's number, from 1.

page_sizeinteger

Rows per page.

totalinteger

Rows across every page.

Errors

403 plan_feature_unavailable	The feature is on a higher plan. Bulk exports and webhooks are Custom-only.
404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
422 invalid_request	A parameter or body field is missing or has the wrong type or value. The message names the field. Also returned when a write would pass the plan's prompt limit.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on every plan from Track up — Solo is the one without it.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.