Content refresh brief

Create an implementation-ready refresh plan for an existing URL and keyword. Costs 12 credits.

post/content/refresh-brief

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/content/refresh-brief
  • Auth: API key in header x-api-key

Query parameters

syncboolean

Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

urlstring uri required
keywordstring required
locationstring
location_codeinteger

Optional search location code for deterministic geo-targeting.

languagestring
scrape_depth'h1' | 'h2' | 'h3'

Response

Completed content refresh brief with agent_workflow

urlstring uri
keywordstring
priority'high' | 'medium' | 'low'
refresh_briefobject
gapobject
markdown_summarystring

Changes

No recorded changes to this operation across all 1 revision of this API.