{
  "version": 1,
  "problems": [
    {
      "code": "project_required",
      "type": "https://screenrig.ai/problems/project-required",
      "title": "Select a project",
      "status": 400,
      "hint": "Use ?project= with a project carried by this token, or the explicit /api/projects/{project_id}/ parent route."
    },
    {
      "code": "free_organization_limit",
      "type": "https://screenrig.ai/problems/free-organization-limit",
      "title": "Free organization limit reached",
      "status": 409,
      "hint": "Create the project in the free organization the person already holds (screenrig project create NAME --organization-id ID), or in an organization holding Plus, Premium or Enterprise."
    },
    {
      "code": "organization_plan_required",
      "type": "https://screenrig.ai/problems/organization-plan-required",
      "title": "The organization needs a plan before it admits screens",
      "status": 409,
      "hint": "Move the project into the free organization its person holds (screenrig project moves, then screenrig project move --organization-id ID), or attach Plus, Premium or Enterprise to this organization."
    },
    {
      "code": "project_name_conflict",
      "type": "https://screenrig.ai/problems/project-name-conflict",
      "title": "Project name already used in the organization",
      "status": 409,
      "hint": "Choose a different project name in this organization."
    },
    {
      "code": "project_delete_blocked",
      "type": "https://screenrig.ai/problems/project-delete-blocked",
      "title": "Project cannot be deleted in its current state",
      "status": 409,
      "hint": "End any plan the project still holds of its own, archive its screens, resolve wallet obligations and stop live advertising, then read the deletion preview again. Automatic cleanup also requires an empty project still under the name enrollment gave it."
    },
    {
      "code": "owner_required",
      "type": "https://screenrig.ai/problems/owner-required",
      "title": "A responsible person is required",
      "status": 409,
      "hint": "The agent's invitation or first connection approval establishes its responsible person. Its existing project remains usable."
    },
    {
      "code": "owner_cannot_leave",
      "type": "https://screenrig.ai/problems/owner-cannot-leave",
      "title": "The project owner cannot leave",
      "status": 409,
      "hint": "The project owner keeps their membership and cannot be removed. Transfer ownership to another member first, then leave."
    },
    {
      "code": "internal_error",
      "type": "https://screenrig.ai/problems/internal-error",
      "title": "Internal server error",
      "status": 500,
      "retryable": false,
      "action": "retry_backoff",
      "hint": "The server failed unexpectedly and the request may not have taken effect. Read the resource back before retrying, and report the request_id if the failure repeats."
    },
    {
      "code": "invalid_request",
      "type": "https://screenrig.ai/problems/invalid-request",
      "title": "Request is invalid",
      "status": 400,
      "action": "hold_lkg",
      "hint": "Correct the request using detail and errors[], which name the field or header that was rejected, then send it again. Do not retry it unchanged."
    },
    {
      "code": "unauthorized",
      "type": "https://screenrig.ai/problems/unauthorized",
      "title": "Authentication is required",
      "status": 401,
      "action": "remint",
      "hint": "The credential is missing, expired, or revoked, so retrying with it fails again. If a stored agent credential was rejected, sign this installation in again (screenrig login); enroll a new project only when the user asked for one."
    },
    {
      "code": "credential_retired",
      "type": "https://screenrig.ai/problems/credential-retired",
      "title": "Credential was retired",
      "status": 401,
      "hint": "This screenRIG credential was retired. Update the screenRIG plugin (or the screenrig CLI) to the latest version, then sign in again with screenrig login; a person approves it in the dashboard."
    },
    {
      "code": "client_update_required",
      "type": "https://screenrig.ai/problems/client-update-required",
      "title": "Update the screenRIG plugin or CLI",
      "status": 410,
      "hint": "This version of the screenRIG plugin or CLI uses a sign-in that was retired. Update the plugin (or the screenrig CLI) to the latest version, then run screenrig login."
    },
    {
      "code": "forbidden",
      "type": "https://screenrig.ai/problems/forbidden",
      "title": "Request is not allowed",
      "status": 403,
      "action": "hold_lkg",
      "hint": "This credential or project may not do this. Check what it may do (screenrig project capabilities), then use a permitted operation or sign the agent in again (screenrig login) and have a person approve the capability it needs."
    },
    {
      "code": "insufficient_access",
      "type": "https://screenrig.ai/problems/insufficient-access",
      "title": "This access level cannot do this",
      "status": 403,
      "hint": "Read only access changes nothing; Propose access uploads media, writes notes and proposes playlist and screen changes for review, but cannot delete, control screens or spend credit. Ask a person to approve Manage access (screenrig login --access manage), or leave the change to a credential that has it."
    },
    {
      "code": "outside_upload_scope",
      "type": "https://screenrig.ai/problems/outside-upload-scope",
      "title": "Outside this uploader's playlists and folders",
      "status": 403,
      "hint": "This uploader works only in the playlists and media folders errors[0].upload_scope lists (screenrig playlist list, screenrig media folder list). Ask the project owner to add the playlist or folder, or leave this to a full member."
    },
    {
      "code": "outside_screen_scope",
      "type": "https://screenrig.ai/problems/outside-screen-scope",
      "title": "Outside this member's screens",
      "status": 403,
      "hint": "This member or agent works only on the screen folders and screens errors[0].screen_scope lists, and everything inside those folders (screenrig screen list, screenrig screen folder list). Ask the project owner to widen the scope, or leave this to a member of the whole project."
    },
    {
      "code": "protected_target",
      "type": "https://screenrig.ai/problems/protected-target",
      "title": "A protected screen is not changed this way",
      "status": 409,
      "hint": "This change reaches a screen in a protected screen folder and has no review form. Ask an approver to clear protection on the folder through a review, make the change, and protect it again."
    },
    {
      "code": "second_approver_required",
      "type": "https://screenrig.ai/problems/second-approver-required",
      "title": "A second approver must decide this review",
      "status": 403,
      "hint": "Changes that reach a protected screen folder are decided by an approver other than the person who proposed them or who is responsible for the agent that did. Ask another approver to decide it, or ask the project owner to let another member approve reviews."
    },
    {
      "code": "reserved_item",
      "type": "https://screenrig.ai/problems/reserved-item",
      "title": "This campaign is reserved",
      "status": 403,
      "hint": "A reserved campaign is changed or removed only by a person who can approve reviews on the screens it reaches. Ask an approver to make the change or to clear the reserved flag."
    },
    {
      "code": "approver_required",
      "type": "https://screenrig.ai/problems/approver-required",
      "title": "Only an approver can do this",
      "status": 403,
      "hint": "Approving reviews and granting Manage access need the project owner or a member who can approve. Ask the project owner to turn on Can approve for this person, or choose Read only or Propose."
    },
    {
      "code": "review_not_pending",
      "type": "https://screenrig.ai/problems/review-not-pending",
      "title": "The review is no longer pending",
      "status": 409,
      "hint": "Someone already decided, withdrew or replaced this review. Read it again (screenrig reviews show ID) for its current state."
    },
    {
      "code": "review_stale",
      "type": "https://screenrig.ai/problems/review-stale",
      "title": "The subject changed after this proposal",
      "status": 409,
      "hint": "The playlist, campaign, screen folder or screens the change was proposed against moved on, so it can no longer be applied as it was reviewed. Read it again and propose the change again on top of what is there now."
    },
    {
      "code": "review_blocked",
      "type": "https://screenrig.ai/problems/review-blocked",
      "title": "Another review must be decided first",
      "status": 409,
      "hint": "This screen change uses a playlist that has no approved version yet. Decide the playlist's review first (detail names it), or approve it together with its related screen changes."
    },
    {
      "code": "playlist_not_approved",
      "type": "https://screenrig.ai/problems/playlist-not-approved",
      "title": "The playlist has no approved version",
      "status": 409,
      "hint": "A playlist proposed for review cannot reach a screen until a person approves it. Wait for the review (screenrig reviews show ID), or choose a playlist that is approved."
    },
    {
      "code": "media_pending_review",
      "type": "https://screenrig.ai/problems/media-pending-review",
      "title": "The media item is waiting for a person's review",
      "status": 409,
      "hint": "An agent uploaded this media item or changed its tags or folder, and no person has decided it yet. Decide its review in Reviews first (screenrig reviews list), then change its tags."
    },
    {
      "code": "media_sync_source_refused",
      "type": "https://screenrig.ai/problems/media-sync-source-refused",
      "title": "The media sync source refused the request",
      "status": 409,
      "hint": "The provider refused the app, the connection or the item (see detail). Microsoft: grant Sites.Selected on the site or Files.Read.All. Canva or Dropbox: the connected person must be able to open it. Google Drive: share the folder with the account's service_account_email. Then run screenrig media sync account test ID."
    },
    {
      "code": "media_sync_source_unavailable",
      "type": "https://screenrig.ai/problems/media-sync-source-unavailable",
      "title": "The media sync source could not be reached",
      "status": 500,
      "retryable": true,
      "action": "retry_backoff",
      "hint": "The provider (Microsoft, Canva, Dropbox or Google) could not be reached or answered with a failure. Retry the same request after a short wait."
    },
    {
      "code": "canva_not_configured",
      "type": "https://screenrig.ai/problems/canva-not-configured",
      "title": "Canva is not configured",
      "status": 409,
      "hint": "Contact screenRIG support."
    },
    {
      "code": "canva_reconnect_required",
      "type": "https://screenrig.ai/problems/canva-reconnect-required",
      "title": "The Canva account needs to be connected",
      "status": 409,
      "hint": "Run screenrig media sync account connect ID and send the new link to the person who owns the Canva account; they open it signed in to Canva. Then run screenrig media sync account show ID until its state is ready."
    },
    {
      "code": "dropbox_not_configured",
      "type": "https://screenrig.ai/problems/dropbox-not-configured",
      "title": "Dropbox is not configured",
      "status": 409,
      "hint": "Create the account with the app key of your own Dropbox app (screenrig media sync account add dropbox --name NAME --app-key KEY), whose redirect URIs list this API's /api/dropbox/callback."
    },
    {
      "code": "dropbox_reconnect_required",
      "type": "https://screenrig.ai/problems/dropbox-reconnect-required",
      "title": "The Dropbox account needs to be connected",
      "status": 409,
      "hint": "Dropbox no longer honors the account's connection. Run screenrig media sync account connect ID and send the link to the person who owns the Dropbox account."
    },
    {
      "code": "google_drive_not_configured",
      "type": "https://screenrig.ai/problems/google-drive-not-configured",
      "title": "Google Drive is not configured",
      "status": 409,
      "hint": "Create the account with the JSON key of your own Google Cloud service account (screenrig media sync account add google-drive --name NAME --key-file FILE), then share the folder with its address."
    },
    {
      "code": "media_sync_sharer_not_member",
      "type": "https://screenrig.ai/problems/media-sync-sharer-not-member",
      "title": "The folder was not shared by a project member",
      "status": 403,
      "hint": "Share the folder with the account's service_account_email from the Google account of a member of this project whose email is verified, then create the sync again."
    },
    {
      "code": "not_found",
      "type": "https://screenrig.ai/problems/not-found",
      "title": "Resource was not found",
      "status": 404,
      "action": "hold_lkg",
      "hint": "The identifier is missing, archived, or belongs to another project. List the resource with its list command (for example screenrig screen list, playlist list, media list or app list; screenrig screen list --state archived shows archived screens) and use an identifier from the output."
    },
    {
      "code": "method_not_allowed",
      "type": "https://screenrig.ai/problems/method-not-allowed",
      "title": "Method is not allowed",
      "status": 405,
      "action": "hold_lkg",
      "hint": "This path does not accept this method; the Allow header lists the ones it does. If a screenrig CLI sent it, update the CLI."
    },
    {
      "code": "idempotency_mismatch",
      "type": "https://screenrig.ai/problems/idempotency-mismatch",
      "title": "Idempotency key does not match the original request",
      "status": 409,
      "action": "retry_backoff",
      "hint": "This idempotency key was already used for a different request. Retry the original request unchanged, or send the new request with a new key (Idempotency-Key / --idempotency-key)."
    },
    {
      "code": "credential_issuance_expired",
      "type": "https://screenrig.ai/problems/credential-issuance-expired",
      "title": "Credential issuance expired",
      "status": 410,
      "hint": "The one-time credential delivery for this installation cannot be recovered. Do not retry; report it and start a new enrollment or connection only with explicit approval."
    },
    {
      "code": "user_email_conflict",
      "type": "https://screenrig.ai/problems/user-email-conflict",
      "title": "Email address belongs to another person",
      "status": 409,
      "hint": "This email address already belongs to another person. Use a different address, or have that person sign in with it."
    },
    {
      "code": "provisioning_invalid",
      "type": "https://screenrig.ai/problems/provisioning-invalid",
      "title": "Browser provisioning invalid",
      "status": 404,
      "hint": "This browser provisioning is not recognized. Start browser setup again to get fresh provisioning."
    },
    {
      "code": "provisioning_expired",
      "type": "https://screenrig.ai/problems/provisioning-expired",
      "title": "Browser provisioning expired",
      "status": 410,
      "hint": "This browser provisioning expired. Start browser setup again to get fresh provisioning."
    },
    {
      "code": "provisioning_consumed",
      "type": "https://screenrig.ai/problems/provisioning-consumed",
      "title": "Browser provisioning consumed",
      "status": 409,
      "hint": "This browser provisioning was already used. If the browser is showing content it is paired; otherwise start browser setup again."
    },
    {
      "code": "provisioning_exchange_mismatch",
      "type": "https://screenrig.ai/problems/provisioning-exchange-mismatch",
      "title": "Browser provisioning exchange mismatch",
      "status": 409,
      "hint": "The provisioning exchange does not match the one issued. Start browser setup again from the same browser."
    },
    {
      "code": "browser_already_paired",
      "type": "https://screenrig.ai/problems/browser-already-paired",
      "title": "Browser already paired",
      "status": 409,
      "hint": "Treat the browser as already connected; do not pair it again."
    },
    {
      "code": "handoff_code_invalid",
      "type": "https://screenrig.ai/problems/handoff-code-invalid",
      "title": "Browser handoff code invalid",
      "status": 404,
      "hint": "Ask the user to open ScreenRig on the display and copy a fresh setup instruction, then claim that code."
    },
    {
      "code": "handoff_code_expired",
      "type": "https://screenrig.ai/problems/handoff-code-expired",
      "title": "Browser handoff code expired",
      "status": 410,
      "hint": "Ask the user to open ScreenRig on the display and copy a fresh setup instruction, then claim that code."
    },
    {
      "code": "handoff_session_rate_limited",
      "type": "https://screenrig.ai/problems/handoff-session-rate-limited",
      "title": "Browser handoff session rate limited",
      "status": 429,
      "hint": "Wait for the retry interval the response gives before starting another browser handoff; do not reload or retry in a loop."
    },
    {
      "code": "handoff_session_conflict",
      "type": "https://screenrig.ai/problems/handoff-session-conflict",
      "title": "Browser handoff session conflict",
      "status": 409,
      "hint": "This project cannot use first-screen handoff. Open the Player on the display and pair its six-character code (screenrig screen pair CODE)."
    },
    {
      "code": "browser_link_not_claimed",
      "type": "https://screenrig.ai/problems/browser-link-not-claimed",
      "title": "Browser link not claimed",
      "status": 409,
      "hint": "Claim the setup code first (screenrig browser setup), then let the browser continue."
    },
    {
      "code": "browser_link_project_mismatch",
      "type": "https://screenrig.ai/problems/browser-link-project-mismatch",
      "title": "Browser link project mismatch",
      "status": 403,
      "hint": "This setup code belongs to another project. Ask for a fresh code and claim it from the intended agent environment."
    },
    {
      "code": "origin_not_allowed",
      "type": "https://screenrig.ai/problems/origin-not-allowed",
      "title": "Origin is not allowed",
      "status": 403,
      "action": "hold_lkg",
      "hint": "Send this request from the ScreenRig origin that owns it; this request's Origin is not accepted for this route."
    },
    {
      "code": "resource_conflict",
      "type": "https://screenrig.ai/problems/resource-conflict",
      "title": "Resource state conflicts with the request",
      "status": 409,
      "action": "retry_backoff",
      "hint": "The resource is not in a state that allows this request; detail says which state. Read the resource, resolve that state, then retry."
    },
    {
      "code": "card_not_found",
      "type": "https://screenrig.ai/problems/card-not-found",
      "title": "Card not found",
      "status": 404,
      "hint": "List the project's cards with screenrig card list and the catalogue types with screenrig cards list. Address a card by its crd_ id: screenrig card show crd_ID reads it and screenrig card data put crd_ID writes its dynamic data."
    },
    {
      "code": "card_invalid",
      "type": "https://screenrig.ai/problems/card-invalid",
      "title": "Card placement is invalid",
      "status": 400,
      "hint": "errors[0].field names the placement member the card catalog refused and errors[0].card names the card. Create a card with a catalogue type from /api/card-types and only its static params; reference its global UID in a placement. Write dynamic properties at /api/cards/{id}/data."
    },
    {
      "code": "card_layout_invalid",
      "type": "https://screenrig.ai/problems/card-layout-invalid",
      "title": "Card layout is invalid",
      "status": 400,
      "hint": "errors[0].field names the layout, anchor, rect or layer. layout is required (full, free, center, wide, header, footer, corner, chip, strip); corner and chip take a corner anchor, strip an edge anchor, the rest none. GET /api/card-types lists the layouts a card allows. Except for free, omit rect and layer."
    },
    {
      "code": "card_layout_conflict",
      "type": "https://screenrig.ai/problems/card-layout-conflict",
      "title": "Cards on the page claim the same place",
      "status": 400,
      "hint": "errors[0].field names the second card. A page holds one full, center or wide card, one corner or chip card per corner, and one strip per edge (a header or footer takes the top or bottom edge's strip; a card with presence may share an edge). Move a card to another anchor or use layout free."
    },
    {
      "code": "card_data_invalid",
      "type": "https://screenrig.ai/problems/card-data-invalid",
      "title": "Card data document does not fit a card that reads it",
      "status": 409,
      "hint": "The card instance or a placement reading this data key refuses the document: errors[0].card names that card and errors[0].field the failing property. Correct the document to hold only that card's dynamic properties, valid against its schema, then write it again or republish."
    },
    {
      "code": "source_limit_reached",
      "type": "https://screenrig.ai/problems/source-limit-reached",
      "title": "Organization has the maximum data sources",
      "status": 409,
      "hint": "The organization has the maximum of 200 data sources across its projects. Delete one it no longer needs (screenrig source delete), then create the new one."
    },
    {
      "code": "source_target_unsupported",
      "type": "https://screenrig.ai/problems/source-target-unsupported",
      "title": "The data source cannot fill this card",
      "status": 422,
      "hint": "No shaper writes this kind of source into the target card's type. supported_cards lists the card types the kind can fill; point the source at one of those cards (screenrig card list)."
    },
    {
      "code": "source_target_taken",
      "type": "https://screenrig.ai/problems/source-target-taken",
      "title": "Another data source already writes this card",
      "status": 409,
      "hint": "One source writes one card. source_id names the source that has it: change or delete that one (screenrig source show), or point this source at another card."
    },
    {
      "code": "source_busy",
      "type": "https://screenrig.ai/problems/source-busy",
      "title": "A sync of the data source is running",
      "status": 409,
      "hint": "A scheduled sync holds the source. Wait for the retry interval the response gives (Retry-After), then refresh again; the sync in progress updates the status on its own."
    },
    {
      "code": "source_has_no_rooms",
      "type": "https://screenrig.ai/problems/source-has-no-rooms",
      "title": "This kind of data source offers no rooms",
      "status": 409,
      "hint": "Only a source that reads a booking system's rooms (kind momentus) has a room mapping. List the project's sources (screenrig source list) and pick one of that kind."
    },
    {
      "code": "source_secret_required",
      "type": "https://screenrig.ai/problems/source-secret-required",
      "title": "A data source secret is missing or no longer fits",
      "status": 400,
      "hint": "errors[] names each secret (secrets.NAME). Enter it with --secret NAME=@FILE; a secret entered for one address or account is not carried to another, so enter it again after pointing the source somewhere new."
    },
    {
      "code": "source_test_failed",
      "type": "https://screenrig.ai/problems/source-test-failed",
      "title": "The data source preview failed",
      "status": 422,
      "hint": "source_error.code says why the address could not be read or shaped, and source_error.message what to change. Fix that and test again; nothing was saved or written."
    },
    {
      "code": "connection_app_not_configured",
      "type": "https://screenrig.ai/problems/connection-app-not-configured",
      "title": "screenRIG's app is not configured for this provider",
      "status": 409,
      "hint": "This server has no screenRIG application for the provider, so a connection in mode screenrig_app cannot be made. Create the connection in mode own_app with the organization's own Microsoft Entra app or Google service account key, which works on every server."
    },
    {
      "code": "connection_limit_reached",
      "type": "https://screenrig.ai/problems/connection-limit-reached",
      "title": "Organization has the maximum connections",
      "status": 409,
      "hint": "The organization has the maximum of 50 connections across its projects. Delete one nothing reads through, or reuse an existing connection, then create the new one."
    },
    {
      "code": "card_media_invalid",
      "type": "https://screenrig.ai/problems/card-media-invalid",
      "title": "Card media reference does not name a ready image",
      "status": 400,
      "hint": "errors[0].field names a string that begins with media:, which a card reads as a media reference, and errors[0].media_id the media it names. Use media:<id> with the id of a ready image in this project (screenrig media list); card data may name only approved media. Text that is not a reference must not begin with media:."
    },
    {
      "code": "revision_conflict",
      "type": "https://screenrig.ai/problems/revision-conflict",
      "title": "Resource revision does not match",
      "status": 412,
      "action": "hold_lkg",
      "hint": "The resource changed since you read it. Read it again, reapply your change, and retry with its current revision (current_revision when present) as the expected revision (If-Match / --expect-rev)."
    },
    {
      "code": "invalid_range",
      "type": "https://screenrig.ai/problems/invalid-range",
      "title": "Requested byte range is not satisfiable",
      "status": 416,
      "action": "retry_backoff",
      "hint": "The requested byte range starts past the end of the content. Request a range within the content length, or read the whole object."
    },
    {
      "code": "quota_exceeded",
      "type": "https://screenrig.ai/problems/quota-exceeded",
      "title": "Project content quota is exceeded",
      "status": 413,
      "action": "hold_lkg",
      "hint": "The project or its organization is at a content limit (the organization's plan storage, card data keys or folders), or the project has five screens waiting to pair. Stored content keeps playing. Delete content it no longer needs or move to a larger plan, or finish pairing the screens waiting, then retry."
    },
    {
      "code": "payment_required",
      "type": "https://screenrig.ai/problems/payment-required",
      "title": "Payment is required",
      "status": 402,
      "action": "hold_lkg",
      "hint": "The project is deleted, or an advertising purchase is larger than the credit held for it. Requests, uploads, listen streams and webhook deliveries are never charged and never answer this. Do not retry; stored content and screens keep working."
    },
    {
      "code": "reseller_generation_limit",
      "type": "https://screenrig.ai/problems/reseller-generation-limit",
      "title": "Reseller image generation limit reached",
      "status": 402,
      "hint": "screenRIG does not generate images. Make or find the image yourself and upload it (screenrig media upload FILE)."
    },
    {
      "code": "feature_not_in_plan",
      "type": "https://screenrig.ai/problems/feature-not-in-plan",
      "title": "This feature is not in the project's plan",
      "status": 402,
      "hint": "This feature is part of a higher plan (required_plan names it); credit does not unlock it, so do not retry. Tell the user which plan includes it and continue without it; screenrig project capabilities lists the features this project has."
    },
    {
      "code": "rate_limited",
      "type": "https://screenrig.ai/problems/rate-limited",
      "title": "Request rate is too high",
      "status": 429,
      "action": "retry_backoff",
      "hint": "Wait for the retry interval the response gives (Retry-After, retry_after_seconds in the CLI), then retry the same request. Do not retry sooner. An organization's hourly agent-request cap answers this with a Retry-After of up to an hour: wait for it, do not loop. Screens keep playing and the dashboard keeps working."
    },
    {
      "code": "revocation_unavailable",
      "type": "https://screenrig.ai/problems/revocation-unavailable",
      "title": "Credential revocation state is unavailable",
      "status": 500,
      "retryable": true,
      "retry_after": 5,
      "hint": "This is not a credential problem: keep the credential and retry the same request after a short wait."
    },
    {
      "code": "dependency_unavailable",
      "type": "https://screenrig.ai/problems/dependency-unavailable",
      "title": "Required dependency is unavailable",
      "status": 500,
      "retryable": true,
      "action": "retry_backoff",
      "retry_after": 5,
      "hint": "A service this request needs is briefly unavailable. Retry the same request after a short wait (Retry-After when present)."
    },
    {
      "code": "dependency_timeout",
      "type": "https://screenrig.ai/problems/dependency-timeout",
      "title": "Required dependency did not answer in time",
      "status": 500,
      "retryable": true,
      "action": "retry_backoff",
      "hint": "A service this request needs did not answer in time. Retry the same request after a short backoff; the unfinished attempt was not charged."
    },
    {
      "code": "schema_incompatible",
      "type": "https://screenrig.ai/problems/schema-incompatible",
      "title": "Database schema is incompatible",
      "status": 500,
      "retryable": false,
      "action": "retry_backoff",
      "hint": "The service is mid-upgrade and cannot serve this request. Retry later; the request cannot succeed until the upgrade completes."
    },
    {
      "code": "not_ready",
      "type": "https://screenrig.ai/problems/not-ready",
      "title": "Service is not ready",
      "status": 500,
      "retryable": true,
      "action": "retry_backoff",
      "retry_after": 5,
      "hint": "The service is starting or a component it needs is not ready. Retry the same request after a short wait (Retry-After when present)."
    },
    {
      "code": "server_draining",
      "type": "https://screenrig.ai/problems/server-draining",
      "title": "Service is draining",
      "status": 421,
      "action": "retry_backoff",
      "hint": "This host is shutting down. Retry the same request shortly; it will reach a host that is serving."
    },
    {
      "code": "manifest_degraded",
      "type": "https://screenrig.ai/problems/manifest-degraded",
      "title": "Runtime manifest projection is degraded",
      "status": 500,
      "retryable": true,
      "action": "hold_lkg",
      "retry_after": 60,
      "hint": "The screen's manifest could not be built right now. Keep showing current content and retry after a short wait."
    },
    {
      "code": "screenshot_unavailable",
      "type": "https://screenrig.ai/problems/screenshot-unavailable",
      "title": "Screenshot is not available",
      "status": 409,
      "action": "hold_lkg",
      "hint": "The screen's Player could not provide a screenshot. Check the screen is online (screenrig screen show ID) and request a new screenshot later."
    },
    {
      "code": "identity_invalid",
      "type": "https://screenrig.ai/problems/identity-invalid",
      "title": "Player public key is invalid",
      "status": 400,
      "action": "hold_lkg",
      "hint": "The Player public key is malformed. Generate a valid key and start pairing again."
    },
    {
      "code": "identity_conflict",
      "type": "https://screenrig.ai/problems/identity-conflict",
      "title": "Player public key does not match the enrollment",
      "status": 409,
      "hint": "The public key does not match the one this pairing or screen is bound to. Pair again with the key the device holds."
    },
    {
      "code": "enrollment_bound",
      "type": "https://screenrig.ai/problems/enrollment-bound",
      "title": "Player public key is already bound to a project",
      "status": 409,
      "hint": "This Player key is already bound to a project. Use that screen as it is, or archive it and move the screen to new hardware with screen recover."
    },
    {
      "code": "proof_invalid",
      "type": "https://screenrig.ai/problems/proof-invalid",
      "title": "Player identity proof is invalid",
      "status": 401,
      "action": "retry_backoff",
      "hint": "The signed proof did not verify. Re-sign the request with the Player key over the exact request, then retry."
    },
    {
      "code": "screen_archived",
      "type": "https://screenrig.ai/problems/screen-archived",
      "title": "Screen is archived",
      "status": 409,
      "action": "clear_lkg",
      "hint": "The screen is archived. Unarchive it first (screenrig screen unarchive ID) if you mean to use it."
    },
    {
      "code": "screen_archive_required",
      "type": "https://screenrig.ai/problems/screen-archive-required",
      "title": "Archive the screen instead of deleting or unbinding it",
      "status": 409,
      "action": "hold_lkg",
      "hint": "Archive the screen (screenrig screen archive ID) instead of deleting or unbinding it."
    },
    {
      "code": "passkey_invalid",
      "type": "https://screenrig.ai/problems/passkey-invalid",
      "title": "Passkey ceremony is invalid",
      "status": 401,
      "hint": "The passkey ceremony failed or expired. Start a new passkey sign-in and complete it once."
    },
    {
      "code": "passkey_unknown",
      "type": "https://screenrig.ai/problems/passkey-unknown",
      "title": "This passkey is no longer registered",
      "status": 401,
      "hint": "This passkey is not registered with screenRIG. Sign in another way, or reset your sign-in to register a new passkey."
    },
    {
      "code": "passkeys_disabled",
      "type": "https://screenrig.ai/problems/passkeys-disabled",
      "title": "Passkeys are disabled on this server",
      "status": 403,
      "hint": "This server does not accept passkeys. Sign in another way."
    },
    {
      "code": "application_in_use",
      "type": "https://screenrig.ai/problems/application-in-use",
      "title": "A live manifest still references an application release",
      "status": 409,
      "hint": "A playlist on a live screen still references this application release. Remove it from those playlists or reassign the screens, then retry."
    },
    {
      "code": "agent_connection_invalid",
      "type": "https://screenrig.ai/problems/agent-connection-invalid",
      "title": "Agent connection is invalid",
      "status": 404,
      "hint": "This agent sign-in is not recognized. Start a new one (screenrig login)."
    },
    {
      "code": "agent_connection_code_mismatch",
      "type": "https://screenrig.ai/problems/agent-connection-code-mismatch",
      "title": "The code does not match this sign-in",
      "status": 400,
      "hint": "Compare the code with the one screenrig login printed in the terminal and enter it again. After five mismatches the sign-in expires; run screenrig login again."
    },
    {
      "code": "agent_connection_expired",
      "type": "https://screenrig.ai/problems/agent-connection-expired",
      "title": "Agent connection is expired",
      "status": 410,
      "hint": "This agent sign-in expired before it was approved. Start a new one (screenrig login) and approve it in the dashboard."
    },
    {
      "code": "agent_connection_conflict",
      "type": "https://screenrig.ai/problems/agent-connection-conflict",
      "title": "Agent connection is already resolved",
      "status": 409,
      "hint": "This connection was already approved or denied. Read its status (screenrig agent status) instead of resolving it again."
    },
    {
      "code": "agent_connection_not_approved",
      "type": "https://screenrig.ai/problems/agent-connection-not-approved",
      "title": "Agent connection is not approved",
      "status": 409,
      "hint": "The connection is still waiting for approval. Ask the user to approve it in the dashboard, then poll its status again."
    },
    {
      "code": "agent_limit_exceeded",
      "type": "https://screenrig.ai/problems/agent-limit-exceeded",
      "title": "Agent limit is exceeded",
      "status": 409,
      "hint": "The organization has the maximum number of live agents across its projects. Disconnect an agent it no longer uses, then connect again."
    },
    {
      "code": "agent_lockout_risk",
      "type": "https://screenrig.ai/problems/agent-lockout-risk",
      "title": "Disconnecting the last active agent risks lockout",
      "status": 409,
      "hint": "This is the project's last active agent. Disconnect only if the user confirms, with the explicit override (screenrig agent disconnect --yes --allow-lockout)."
    },
    {
      "code": "recovery_ambiguous",
      "type": "https://screenrig.ai/problems/recovery-ambiguous",
      "title": "Device identifier is attached to more than one screen",
      "status": 409,
      "hint": "The device is attached to more than one screen, so recovery cannot pick one. List the screens (screenrig screen list), report the conflict, and do not retry."
    },
    {
      "code": "recovery_expired",
      "type": "https://screenrig.ai/problems/recovery-expired",
      "title": "Screen recovery offer has expired",
      "status": 410,
      "hint": "The recovery offer lapsed. Pair the device again so the screen receives a new recovery offer, then run screen recover."
    },
    {
      "code": "recovery_not_offered",
      "type": "https://screenrig.ai/problems/recovery-not-offered",
      "title": "No screen recovery is pending",
      "status": 404,
      "hint": "No new device is waiting to take over this screen. Pair the new device first, then run screen recover."
    },
    {
      "code": "invitation_limit_reached",
      "type": "https://screenrig.ai/problems/invitation-limit-reached",
      "title": "Organization has the maximum outstanding invitations",
      "status": 409,
      "hint": "The organization has the maximum outstanding invitations across its projects. Revoke an unused invitation (screenrig invitations revoke), then create the new one."
    },
    {
      "code": "organization_admin_limit",
      "type": "https://screenrig.ai/problems/organization-admin-limit",
      "title": "Organization admin limit reached",
      "status": 409,
      "hint": "An organization has at most 20 admins, counting pending admin invitations. An admin revokes a pending invitation or removes an admin in the dashboard, then invites again."
    },
    {
      "code": "library_no_screens",
      "type": "https://screenrig.ai/problems/library-no-screens",
      "title": "A project with screens can't be the Library",
      "status": 409,
      "hint": "To make a project the Library, pick one without screens or move or archive its screens first. Screens can't be added to the Library: pair them to another project of the organization, which uses the Library's media and playlists."
    },
    {
      "code": "guest_not_allowed",
      "type": "https://screenrig.ai/problems/guest-not-allowed",
      "title": "The organization does not admit this person as a guest",
      "status": 403,
      "hint": "The organization's guest policy does not admit this address to its projects. An organization admin can change the policy in the dashboard, or the person can be invited with an address the policy admits."
    },
    {
      "code": "managed_member",
      "type": "https://screenrig.ai/problems/managed-member",
      "title": "An identity provider manages this person",
      "status": 409,
      "hint": "This organization's identity provider provisions and removes this person, so an admin cannot remove them here. Remove or deactivate them in the identity provider."
    },
    {
      "code": "organization_admin_member",
      "type": "https://screenrig.ai/problems/organization-admin-member",
      "title": "This member is an organization admin",
      "status": 409,
      "hint": "The person is a designated admin of the organization. Remove their admin seat in the dashboard first, then remove them as a member."
    },
    {
      "code": "member_owns_projects",
      "type": "https://screenrig.ai/problems/member-owns-projects",
      "title": "This member owns projects in the organization",
      "status": 409,
      "hint": "The detail names the projects this person owns in the organization. Transfer each project's ownership to another member, then remove them."
    },
    {
      "code": "managed_elsewhere",
      "type": "https://screenrig.ai/problems/managed-elsewhere",
      "title": "Another organization manages this person",
      "status": 409,
      "hint": "Another organization's identity provider manages this person, so they cannot join this organization as a member. They can still be invited to individual projects."
    },
    {
      "code": "version_required",
      "type": "https://screenrig.ai/problems/version-required",
      "title": "Playlist requires a newer API version",
      "status": 409,
      "hint": "This playlist has ad pages, which only the playlists API (/api/playlists) accepts. Write it there, or remove the ad pages to keep using this API."
    },
    {
      "code": "price_change_pending",
      "type": "https://screenrig.ai/problems/price-change-pending",
      "title": "Campaign is paused until new rates are accepted",
      "status": 409,
      "hint": "The seller changed rates and the campaign is paused. Preview the campaign for a fresh quote and accept it (screenrig ads campaigns accept-rates) only with the buyer's consent."
    },
    {
      "code": "quote_stale",
      "type": "https://screenrig.ai/problems/quote-stale",
      "title": "Advertising quote is stale or expired",
      "status": 409,
      "hint": "The quote expired or no longer matches the campaign. Preview the campaign again (screenrig ads campaigns preview) and use the new quote."
    },
    {
      "code": "insufficient_credits",
      "type": "https://screenrig.ai/problems/insufficient-credits",
      "title": "Eligible credits are insufficient",
      "status": 402,
      "hint": "The project's eligible credit does not cover this spend. Check the balance and source eligibility (screenrig billing balance), then reduce the spend."
    },
    {
      "code": "self_deal",
      "type": "https://screenrig.ai/problems/self-deal",
      "title": "A project cannot buy advertising in its own network",
      "status": 409,
      "hint": "A project cannot buy ads in its own network. Target another network's inventory."
    },
    {
      "code": "goal_overbooked",
      "type": "https://screenrig.ai/problems/goal-overbooked",
      "title": "The goal is larger than the available plays",
      "status": 409,
      "hint": "Lower goal_plays, widen the targeting or the flight, or set overbook to true to book it anyway; screenrig ads direct availability shows the estimate."
    },
    {
      "code": "invitation_invalid",
      "type": "https://screenrig.ai/problems/invitation-invalid",
      "title": "Invitation is invalid",
      "status": 404,
      "hint": "This invitation link is not recognized. Ask a project member for a new invitation."
    },
    {
      "code": "invitation_expired",
      "type": "https://screenrig.ai/problems/invitation-expired",
      "title": "Invitation is expired",
      "status": 410,
      "hint": "This invitation expired. Ask a project member for a new invitation."
    },
    {
      "code": "invitation_consumed",
      "type": "https://screenrig.ai/problems/invitation-consumed",
      "title": "Invitation is already accepted",
      "status": 409,
      "hint": "This invitation was already accepted. Sign in instead."
    },
    {
      "code": "invitation_email_mismatch",
      "type": "https://screenrig.ai/problems/invitation-email-mismatch",
      "title": "Invitation belongs to a different email address",
      "status": 403,
      "hint": "The invitation was sent to a different email address. Sign in with that address or ask for an invitation to this one."
    },
    {
      "code": "reauthentication_required",
      "type": "https://screenrig.ai/problems/reauthentication-required",
      "title": "Fresh sign-in proof is required",
      "status": 401,
      "hint": "This action needs a fresh sign-in. Sign in again, then retry within a few minutes."
    },
    {
      "code": "member_limit_reached",
      "type": "https://screenrig.ai/problems/member-limit-reached",
      "title": "Project has the maximum members",
      "status": 409,
      "hint": "The project has the most people its plan allows (required_plan, when present, names a plan with room for more). Remove a member or revoke an invitation it no longer needs, then retry."
    },
    {
      "code": "project_limit_reached",
      "type": "https://screenrig.ai/problems/project-limit-reached",
      "title": "Organization has the maximum projects",
      "status": 409,
      "hint": "The organization has the most projects its plan allows (required_plan, when present, names a plan with room for more; without it, contact support). Put the project in another organization, or delete a project it no longer needs, then retry."
    },
    {
      "code": "billed_by_reseller",
      "type": "https://screenrig.ai/problems/billed-by-reseller",
      "title": "The organization is billed through its reseller",
      "status": 409,
      "hint": "Its reseller pays for its plan and usage, so purchases and plan changes go through the reseller. An organization admin can end the delegation (DELETE /api/organizations/{org_id}/reseller) to pay for itself."
    },
    {
      "code": "reseller_conflict",
      "type": "https://screenrig.ai/problems/reseller-conflict",
      "title": "The organization cannot take that reseller role",
      "status": 409,
      "hint": "A reseller cannot be a customer of a reseller, an organization has at most one reseller, and staff and promo organizations take no part. The detail names the reason."
    },
    {
      "code": "last_credential",
      "type": "https://screenrig.ai/problems/last-credential",
      "title": "Last sign-in method cannot be removed",
      "status": 409,
      "hint": "Add another sign-in method before removing this one."
    },
    {
      "code": "sso_required",
      "type": "https://screenrig.ai/problems/sso-required",
      "title": "This address signs in through its identity provider",
      "status": 403,
      "hint": "This address belongs to an organization that requires single sign-on, so a password or passkey cannot sign it in. Have the person sign in with single sign-on from the dashboard sign-in page."
    },
    {
      "code": "no_project",
      "type": "https://screenrig.ai/problems/no-project",
      "title": "No current project is selected",
      "status": 409,
      "hint": "Select a project first, then retry."
    },
    {
      "code": "feature_unavailable",
      "type": "https://screenrig.ai/problems/feature-unavailable",
      "title": "This feature is not available on this server",
      "status": 404,
      "action": "hold_lkg",
      "hint": "This feature is not enabled on this server; detail says what to use instead. Do not retry."
    },
    {
      "code": "user_binding_stale",
      "type": "https://screenrig.ai/problems/user-binding-stale",
      "title": "Claiming user email binding is stale",
      "status": 409,
      "hint": "The verified email changed during sign-in. Start the sign-in again."
    },
    {
      "code": "session_expired",
      "type": "https://screenrig.ai/problems/session-expired",
      "title": "Runtime session is expired or no longer current",
      "status": 401,
      "action": "remint",
      "hint": "Mint a new runtime session, then retry."
    },
    {
      "code": "credential_revoked",
      "type": "https://screenrig.ai/problems/credential-revoked",
      "title": "Device credential no longer binds this device to a screen",
      "status": 401,
      "action": "repair",
      "hint": "This device key no longer binds a screen. Pair the device again with this key."
    },
    {
      "code": "screen_link_invalid",
      "type": "https://screenrig.ai/problems/screen-link-invalid",
      "title": "Screen link is not valid",
      "status": 401,
      "action": "clear_lkg",
      "hint": "This screen link was replaced, turned off or never issued. Show the screen's current link (screenrig screen link show SCREEN_ID) and open that address instead."
    },
    {
      "code": "screen_link_not_found",
      "type": "https://screenrig.ai/problems/screen-link-not-found",
      "title": "Screen has no link",
      "status": 404,
      "hint": "Create the screen's link (screenrig screen link create SCREEN_ID), then show it (screenrig screen link show SCREEN_ID)."
    },
    {
      "code": "proof_clock_skew",
      "type": "https://screenrig.ai/problems/proof-clock-skew",
      "title": "Player identity proof is outside the accepted time window",
      "status": 401,
      "action": "retry_backoff",
      "hint": "Re-sign the proof using a clock offset from server_time, then retry."
    },
    {
      "code": "key_retired",
      "type": "https://screenrig.ai/problems/key-retired",
      "title": "Player key was replaced and its grace window has closed",
      "status": 401,
      "action": "repair",
      "hint": "This key was replaced. Pair the device again with its current key."
    },
    {
      "code": "assignment_not_found",
      "type": "https://screenrig.ai/problems/assignment-not-found",
      "title": "Screen has no playlist assignment",
      "status": 404,
      "action": "clear_lkg",
      "hint": "Assign a playlist to the screen (screenrig screen assign), then the Player will load it."
    },
    {
      "code": "upgrade_required",
      "type": "https://screenrig.ai/problems/upgrade-required",
      "title": "Player version is below the supported minimum",
      "status": 403,
      "action": "upgrade_required",
      "hint": "Keep showing current content and update the Player to at least min_supported."
    },
    {
      "code": "reboot_unsupported",
      "type": "https://screenrig.ai/problems/reboot-unsupported",
      "title": "Screen cannot reboot remotely",
      "status": 409,
      "hint": "This screen's Player cannot reboot remotely. Use screen reload to refresh content, or restart the device by hand."
    },
    {
      "code": "command_unsupported",
      "type": "https://screenrig.ai/problems/command-unsupported",
      "title": "Screen cannot do this remotely",
      "status": 409,
      "hint": "This screen's Player does not support this action (clear_cache, restart_app or update). Read the screen's host capabilities, or use screen reload to refresh content."
    },
    {
      "code": "play_page_unsupported",
      "type": "https://screenrig.ai/problems/play-page-unsupported",
      "title": "Screen cannot play a page on request",
      "status": 409,
      "hint": "This screen's Player cannot play a page on request. Update the Player to its current version, then retry."
    },
    {
      "code": "identify_unsupported",
      "type": "https://screenrig.ai/problems/identify-unsupported",
      "title": "Screen cannot identify itself",
      "status": 409,
      "hint": "This screen's Player cannot show an identify overlay. Update the Player to its current version, or use screenrig screen toast ID --text NAME."
    },
    {
      "code": "volume_unsupported",
      "type": "https://screenrig.ai/problems/volume-unsupported",
      "title": "Screen cannot set its volume",
      "status": 409,
      "hint": "This screen's Player cannot set its volume remotely. Update the Player to its current version, or set the volume in the Player's settings menu."
    },
    {
      "code": "display_output_unsupported",
      "type": "https://screenrig.ai/problems/display-output-unsupported",
      "title": "Screen cannot set its output mode",
      "status": 409,
      "hint": "This screen's Player did not declare the display_output.mode host capability, so it cannot set its video output mode. Update the Player to its current version, or clear display.output (null)."
    },
    {
      "code": "display_cec_unsupported",
      "type": "https://screenrig.ai/problems/display-cec-unsupported",
      "title": "Screen cannot take its display's input over CEC",
      "status": 409,
      "hint": "This screen's Player did not declare the display_power.cec_active_source host capability, so it cannot switch the TV to its input. Update the Player to its current version, or clear display.cec (null)."
    },
    {
      "code": "page_not_on_screen",
      "type": "https://screenrig.ai/problems/page-not-on-screen",
      "title": "Page is not in the playlist the screen is playing",
      "status": 409,
      "hint": "Retry with a page id of the playlist the screen is playing now (screenrig playlist show ID)."
    },
    {
      "code": "live_unsupported",
      "type": "https://screenrig.ai/problems/live-unsupported",
      "title": "Screen cannot show live view",
      "status": 409,
      "hint": "This screen's Player did not declare the live_view host capability. Update the Player to its current version, or use screenrig screen screenshot ID."
    },
    {
      "code": "live_unavailable",
      "type": "https://screenrig.ai/problems/live-unavailable",
      "title": "Live view is not available for this screen",
      "status": 409,
      "hint": "The screen is offline, has no live session, or its Player ended the session; detail says which. Check the screen is online (screenrig screen show ID), then start live view again (screenrig screen live start ID)."
    },
    {
      "code": "live_not_ready",
      "type": "https://screenrig.ai/problems/live-not-ready",
      "title": "The screen is not publishing yet",
      "status": 409,
      "hint": "The Player has been asked to publish and has not reached the relay yet. Retry after the Retry-After seconds; the session status shows when it is publishing (screenrig screen live status ID)."
    },
    {
      "code": "live_session_ended",
      "type": "https://screenrig.ai/problems/live-session-ended",
      "title": "The live session has ended",
      "status": 410,
      "action": "hold_lkg",
      "hint": "Stop publishing and keep playing. A Player acts on a live_id only while it is the screen's current session."
    },
    {
      "code": "wall_unsupported",
      "type": "https://screenrig.ai/problems/wall-unsupported",
      "title": "Screen cannot lay out a video wall",
      "status": 409,
      "hint": "This screen's Player did not declare the host capability that lays out the wall: display.wall for two or more outputs, display.rotate for one rotated output. Use the Linux Player's kiosk install (cage and wlr-randr) or the Windows Player, update it to its current version, then set the wall again."
    },
    {
      "code": "playlist_format_mismatch",
      "type": "https://screenrig.ai/problems/playlist-format-mismatch",
      "title": "Playlist format does not match the screen's video wall",
      "status": 409,
      "hint": "A playlist with a wall format binds only to a screen whose wall has the same shape (PATCH /api/screens/{id}), or choose another playlist. A region playlist (a strip) plays only as a schedule entry or campaign with covers set to its region, on a display whose orientation it fits and that it covers by at most half."
    },
    {
      "code": "primitive_locked",
      "type": "https://screenrig.ai/problems/primitive-locked",
      "title": "A locked element can be changed only by an approver",
      "status": 403,
      "hint": "A primitive marked locked is a template's fixed brand content: only the project owner or a member who can approve adds, removes, moves or edits it, or clears its lock. errors[0].field names the primitive. Change the page around it, or ask an approver to make the change."
    },
    {
      "code": "playlist_is_template",
      "type": "https://screenrig.ai/problems/playlist-is-template",
      "title": "The playlist is a template",
      "status": 409,
      "hint": "A playlist that declares fields is a template: it holds {field.NAME} tokens for the playlists made from it and no screen shows it. Create a playlist from it (POST /api/playlists with from_template) and assign that one."
    },
    {
      "code": "webhook_limit_reached",
      "type": "https://screenrig.ai/problems/webhook-limit-reached",
      "title": "Organization has the maximum webhooks",
      "status": 409,
      "hint": "The organization has the maximum of 50 notifications, across every channel. Delete one it no longer needs (screenrig notifications delete), then create the new one."
    },
    {
      "code": "alert_not_open",
      "type": "https://screenrig.ai/problems/alert-not-open",
      "title": "Alert is not open",
      "status": 409,
      "hint": "The alert already resolved, so there is nothing to acknowledge. List the open alerts (screenrig alerts list) and acknowledge one of those."
    },
    {
      "code": "alert_mute_limit_reached",
      "type": "https://screenrig.ai/problems/alert-mute-limit-reached",
      "title": "Organization has the maximum mutes",
      "status": 409,
      "hint": "The organization has the maximum of 50 current mutes across its projects. End one it no longer needs (screenrig alerts unmute), or cover more screens with one mute by tag."
    },
    {
      "code": "notification_limit_reached",
      "type": "https://screenrig.ai/problems/notification-limit-reached",
      "title": "Organization has the maximum notifications",
      "status": 409,
      "hint": "The organization has the maximum of 50 notifications, across every channel. Delete one it no longer needs (screenrig notifications delete), then create the new one."
    },
    {
      "code": "notification_covers_other_projects",
      "type": "https://screenrig.ai/problems/notification-covers-other-projects",
      "title": "Notification covers other projects",
      "status": 409,
      "hint": "Change the notification from the organization's Notifications page in the dashboard, or create a notification for this project alone (screenrig notifications create)."
    },
    {
      "code": "report_subscription_limit_reached",
      "type": "https://screenrig.ai/problems/report-subscription-limit-reached",
      "title": "Organization has the maximum report subscriptions",
      "status": 409,
      "hint": "The organization has the maximum of 50 report subscriptions across its projects. Delete one it no longer needs (screenrig reports subscriptions delete), then create the new one."
    },
    {
      "code": "fleet_link_limit_reached",
      "type": "https://screenrig.ai/problems/fleet-link-limit-reached",
      "title": "Organization has the maximum fleet links",
      "status": 409,
      "hint": "The organization has the maximum of 50 fleet links across its projects. Delete one it no longer needs (screenrig fleet-links delete), then create the new one."
    },
    {
      "code": "webhook_url_rejected",
      "type": "https://screenrig.ai/problems/webhook-url-rejected",
      "title": "Webhook URL must be HTTPS on a public Internet host",
      "status": 400,
      "hint": "Use an https:// URL on a public Internet host; private, loopback, and non-HTTPS addresses are refused."
    },
    {
      "code": "notification_destination_rejected",
      "type": "https://screenrig.ai/problems/notification-destination-rejected",
      "title": "Notification destination is not valid for its channel",
      "status": 400,
      "hint": "Give the credential the service itself issues: a Slack incoming webhook URL, a Teams Workflows webhook URL, a PagerDuty Events API v2 routing key or a Telegram bot token. The detail names the shape the channel takes."
    },
    {
      "code": "document_not_shared",
      "type": "https://screenrig.ai/problems/document-not-shared",
      "title": "Document asks viewers to sign in",
      "status": 400,
      "hint": "Change the file's sharing as the detail says, then publish again."
    },
    {
      "code": "note_contains_credential",
      "type": "https://screenrig.ai/problems/note-contains-credential",
      "title": "Note text contains a credential",
      "status": 422,
      "hint": "Nothing was stored. Take the token, key or password out of the text (say where the secret is kept instead) and add the note again."
    },
    {
      "code": "note_rejected",
      "type": "https://screenrig.ai/problems/note-rejected",
      "title": "Note text was rejected",
      "status": 422,
      "hint": "Nothing was stored. A note is a plain fact for other agents, never an instruction to a model; rewrite it as a fact and add it again."
    },
    {
      "code": "note_not_open",
      "type": "https://screenrig.ai/problems/note-not-open",
      "title": "Note is not open",
      "status": 409,
      "hint": "The note is already resolved. List the open notes (screenrig notes) and confirm, resolve or replace one of those."
    },
    {
      "code": "note_limit_reached",
      "type": "https://screenrig.ai/problems/note-limit-reached",
      "title": "Organization has the maximum open notes",
      "status": 409,
      "hint": "The organization has 200 open notes across its projects. Resolve the ones that no longer hold (screenrig notes resolve ID REASON), starting with those the detail names, then add the note again."
    },
    {
      "code": "trigger_limit_reached",
      "type": "https://screenrig.ai/problems/trigger-limit-reached",
      "title": "Organization has the maximum triggers",
      "status": 409,
      "hint": "The organization has the maximum of 20 triggers across its projects. Delete one it no longer needs (screenrig triggers delete), then create the new one."
    },
    {
      "code": "bi_upstream_refused",
      "type": "https://screenrig.ai/problems/bi-upstream-refused",
      "title": "The BI system refused the connection",
      "status": 409,
      "hint": "Fix the connection as the detail says, then run screenrig bi connection test ID."
    },
    {
      "code": "bi_upstream_unavailable",
      "type": "https://screenrig.ai/problems/bi-upstream-unavailable",
      "title": "The BI system could not be reached",
      "status": 500,
      "retryable": true,
      "hint": "Check that the BI system is reachable from the public Internet and that the detail names nothing else wrong, then run screenrig bi connection test ID."
    },
    {
      "code": "bi_web_unavailable",
      "type": "https://screenrig.ai/problems/bi-web-unavailable",
      "title": "This server has no page renderer",
      "status": 409,
      "hint": "Web connections and views need a page renderer, which this server does not have. Use a Grafana, Power BI or Tableau connection here, or a server with a page renderer."
    },
    {
      "code": "schedule_import_invalid",
      "type": "https://screenrig.ai/problems/schedule-import-invalid",
      "title": "The import has rows with errors",
      "status": 422,
      "hint": "Preview the sheet (screenrig schedule import FILE), correct the rows it lists by column, and commit the corrected sheet."
    },
    {
      "code": "schedule_import_stale",
      "type": "https://screenrig.ai/problems/schedule-import-stale",
      "title": "The project changed since the preview",
      "status": 409,
      "hint": "Screens, media, playlists or levels changed, or the rows read differently. Nothing was written. Preview the sheet again and commit with the new fingerprint."
    },
    {
      "code": "campaign_limit_reached",
      "type": "https://screenrig.ai/problems/campaign-limit-reached",
      "title": "Organization has the maximum campaigns",
      "status": 409,
      "hint": "The organization has the maximum of 100 campaigns across its projects. Delete one it no longer needs (screenrig campaign delete), then create the new one."
    },
    {
      "code": "kv_webhook_limit_reached",
      "type": "https://screenrig.ai/problems/kv-webhook-limit-reached",
      "title": "Application has the maximum key/value webhooks",
      "status": 409,
      "hint": "The application has the maximum of 20 key/value webhooks. Delete one it no longer needs (DELETE /api/applications/{application_id}/kv-webhooks/{webhook_id}), then create the new one."
    },
    {
      "code": "support_conversation_closed",
      "type": "https://screenrig.ai/problems/support-conversation-closed",
      "title": "Support conversation is closed",
      "status": 409,
      "hint": "Read the conversation history or start a new conversation with screenrig support submit."
    },
    {
      "code": "submission_too_short",
      "type": "https://screenrig.ai/problems/submission-too-short",
      "title": "Submission is too short to act on",
      "status": 422,
      "hint": "Describe what happened or what you need in at least a full sentence, then send it again with a new idempotency key."
    },
    {
      "code": "submission_unclear",
      "type": "https://screenrig.ai/problems/submission-unclear",
      "title": "Submission does not describe a problem or request",
      "status": 422,
      "hint": "Describe the problem, question or request in plain language, then send it again with a new idempotency key."
    },
    {
      "code": "submission_rejected",
      "type": "https://screenrig.ai/problems/submission-rejected",
      "title": "Submission was not accepted",
      "status": 422,
      "hint": "Do not resend this text. Send a plain-language description of a screenRIG problem, question or request instead."
    },
    {
      "code": "submission_screening_unavailable",
      "type": "https://screenrig.ai/problems/submission-screening-unavailable",
      "title": "Submission cannot be screened right now",
      "status": 500,
      "retryable": true,
      "retry_after": 120,
      "hint": "Send the same request again with the same idempotency key after the Retry-After interval."
    },
    {
      "code": "demo_slot_unavailable",
      "type": "https://screenrig.ai/problems/demo-slot-unavailable",
      "title": "Demo time is no longer available",
      "status": 409,
      "hint": "Refresh the available demo times and choose another time. Your saved request is retained."
    },
    {
      "code": "agentid_claim_invalid",
      "type": "https://screenrig.ai/problems/agentid-claim-invalid",
      "title": "AgentID claim is invalid or expired",
      "status": 400,
      "hint": "The AgentID claim code is missing, expired, or already redeemed. Sign in with AgentID again for a fresh claim code, or enroll with screenrig agent enroll --email ADDRESS."
    },
    {
      "code": "agentid_already_enrolled",
      "type": "https://screenrig.ai/problems/agentid-already-enrolled",
      "title": "AgentID is already enrolled",
      "status": 409,
      "hint": "An installation already holds this AgentID. Run screenrig login from that installation to add a project."
    },
    {
      "code": "account_exists",
      "type": "https://screenrig.ai/problems/account-exists",
      "title": "This email already has a screenRIG account",
      "status": 409,
      "hint": "This email already has a screenRIG account. Sign in instead."
    },
    {
      "code": "email_verification_required",
      "type": "https://screenrig.ai/problems/email-verification-required",
      "title": "Verify your email to continue",
      "status": 403,
      "hint": "The time to verify this account's email has passed. Open the link in the verification email, or have a new link sent to the address from the dashboard."
    },
    {
      "code": "unverified_account_replacement",
      "type": "https://screenrig.ai/problems/unverified-account-replacement",
      "title": "This reset creates a new, empty account",
      "status": 409,
      "hint": "If you created the account with this address, open the verification link in its email on the device where you signed up, and sign in there. To go on with a new, empty account instead, confirm the replacement."
    },
    {
      "code": "app_store_transaction_invalid",
      "type": "https://screenrig.ai/problems/app-store-transaction-invalid",
      "title": "App Store purchase could not be verified",
      "status": 422,
      "hint": "The signed value is not a screenRIG plan transaction from the App Store for this server's environment. Send the transaction exactly as StoreKit returned it, from a build of the app that buys against this server."
    },
    {
      "code": "app_store_account_mismatch",
      "type": "https://screenrig.ai/problems/app-store-account-mismatch",
      "title": "Purchase belongs to another organization",
      "status": 409,
      "hint": "The transaction carries another organization's account token. Read this organization's offer again and buy with its account_token, or open the organization the purchase was made for."
    },
    {
      "code": "education_not_eligible",
      "type": "https://screenrig.ai/problems/education-not-eligible",
      "title": "Organization is not eligible for the Education plan",
      "status": 403,
      "hint": "Staff mark verified K-12 schools and districts as eligible. Ask support to verify the organization, or choose the Plus or Premium plan."
    },
    {
      "code": "app_store_plan_conflict",
      "type": "https://screenrig.ai/problems/app-store-plan-conflict",
      "title": "Organization already holds a plan",
      "status": 409,
      "hint": "The organization already holds this plan or a higher one through another source: staff, invoicing or another App Store subscription. Cancel the App Store subscription under Manage subscription, or ask support."
    }
  ]
}
