> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt > Use this file to discover all available pages before exploring further. # Mark content as externally posted > Report where your integration already published a Hrizn content item. Requires X-API-Key, content:write, and the API_ACCESS plan entitlement. The key-associated site constrains both reads and conditional writes; missing content and content belonging to another site return the same 404. Only posted_url is accepted; site, customer, and actor IDs are never accepted. This records the existing manual posted marker and URL, without crawling, independently verifying, or publishing the page. Generation state, CMS publishing state, and telemetry are unchanged. This callback does not add content to /content/published or make /content/{id}/publish-data available. marked_posted_at is the server-recorded first report time, not an external publication date. Corrections preserve it. Retrying the current URL is a no-op; a different URL replaces it. The last successfully applied update wins. Serialize corrections per content ID and stop superseded retries; there is no event version. On contention (409), retry only the latest payload. X-Idempotency-Key response caching is not supported; authorization reruns on every call. Backfill known content-ID/URL pairs one request at a time; no scanning, batch, unpublish, or new MCP tool is provided. ## OpenAPI ````yaml /openapi.yaml post /content/{id}/posted openapi: 3.1.0 info: title: Hrizn Public API version: 1.2.0 description: > The Hrizn Public API allows partners to programmatically create content, manage inventory descriptions, and integrate with the Hrizn platform. All endpoints are prefixed with `/public` and require an API key passed via the `X-API-Key` header (except the health check). contact: email: support@hrizn.io servers: - url: https://api.app.hrizn.io/v1/public description: Production security: - apiKeyAuth: [] tags: - name: Analytics description: >- Warehoused Google Search Console and GA4 reads (Teams+ API access, analytics:read). URL Inspection is live only on pages/performance. - name: IdeaClouds description: Create and manage AI-powered keyword research - name: Content Intelligence description: AI-powered content gap analysis and recommendations - name: Content description: Generate content from IdeaClouds - name: Compliance description: Run OEM compliance checks on content - name: Content Tools description: Generate SEO metadata, schemas, and social snippets - name: Inventory description: Access vehicle data and AI descriptions - name: Images description: >- Media Library images. Read the library (images:read): list and fetch images with alt text, AI-written title/caption/description, the generating prompt, dimensions, article links, and social variant cuts. Generate (images:write): async AI image generation returning an image_id; completion is delivered via image.generation.completed / image.generation.failed webhooks. - name: Market description: >- Live local market listings, days supply, competitive set, and pricing insights (Unlimited plan + market_data:read) - name: Site description: View dealership details and configuration - name: Webhooks description: Manage webhook subscriptions for real-time events - name: Reference description: Look up available types, scopes, and events - name: Social description: >- Social Hub posting and reviews across all connected platforms (X, Facebook, Instagram, LinkedIn, Google Business Profile) - name: Health description: Health check (no authentication) - name: Share description: >- Anonymous share-page routes (no API key). Called by Hrizn share pages (/s/{publicId}) on behalf of shoppers who are not signed in. Requests must originate from the Hrizn app origin (CORS is origin-checked, never wildcard) and are rate limited per client IP. Responses use a flat `{ error }` / `{ success }` body, not the `{ error: { code, message } }` envelope of API-key routes. paths: /content/{id}/posted: post: tags: - Content summary: Mark content as externally posted description: > Report where your integration already published a Hrizn content item. Requires X-API-Key, content:write, and the API_ACCESS plan entitlement. The key-associated site constrains both reads and conditional writes; missing content and content belonging to another site return the same 404. Only posted_url is accepted; site, customer, and actor IDs are never accepted. This records the existing manual posted marker and URL, without crawling, independently verifying, or publishing the page. Generation state, CMS publishing state, and telemetry are unchanged. This callback does not add content to /content/published or make /content/{id}/publish-data available. marked_posted_at is the server-recorded first report time, not an external publication date. Corrections preserve it. Retrying the current URL is a no-op; a different URL replaces it. The last successfully applied update wins. Serialize corrections per content ID and stop superseded retries; there is no event version. On contention (409), retry only the latest payload. X-Idempotency-Key response caching is not supported; authorization reruns on every call. Backfill known content-ID/URL pairs one request at a time; no scanning, batch, unpublish, or new MCP tool is provided. operationId: markContentPosted parameters: - name: id in: path required: true description: >- Hrizn content UUID returned by create; never an external CMS, job, or IdeaCloud ID. schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - posted_url properties: posted_url: type: string format: uri maxLength: 4096 description: >- Absolute HTTP(S) URL with no embedded credentials. Surrounding whitespace is trimmed before validation; the trimmed URL must be at most 4096 characters. example: https://www.example.com/blog/hybrid-suv-guide responses: '200': description: External publication recorded, corrected, or already current content: application/json: schema: type: object required: - data properties: data: type: object required: - id - posted_url - marked_posted_at - publish_state properties: id: type: string format: uuid posted_url: type: string format: uri marked_posted_at: type: string format: date-time description: >- Server-recorded first report time; preserved on retries and URL corrections. publish_state: type: string enum: - published '400': description: >- validation_error — invalid content UUID, invalid posted_url, or unknown body fields content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': $ref: '#/components/responses/Unauthorized' '403': description: >- forbidden for missing content:write scope, or plan_upgrade_required for missing API_ACCESS entitlement content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: >- not_found — content is missing or belongs to another site; responses are indistinguishable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- conflict — concurrent update contention; retry only the latest intended posted_url payload content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '503': description: >- service_unavailable — publication recording is temporarily unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - apiKeyAuth: [] components: schemas: ErrorResponse: type: object properties: error: type: object properties: code: type: string example: validation_error message: type: string example: 'keyword: Required' details: type: object request_id: type: string responses: Unauthorized: description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: Your Hrizn API key (prefix hzk_) ````