{"openapi":"3.1.0","info":{"title":"Go Remote Viewing agent API","version":"1.0.0","description":"Act for one Go Remote Viewing member with their personal agent token: blind practice targets, live missions, challenges, leaderboards and discussions. Targets stay sealed until their reveal time."},"servers":[{"url":"https://www.goremoteviewing.com"}],"security":[{"agentToken":[]}],"paths":{"/api/agent/v1/tools/whoami":{"post":{"operationId":"whoami","summary":"My profile and record","description":"The signed-in member's profile, level, streak, scored-session record, active plan and hourly allowances. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/list_open_missions":{"post":{"operationId":"list_open_missions","summary":"Open missions","description":"Live blind missions that are open for impressions right now, soonest lock first. Each has a lock time: impressions must be sealed before it. Nothing about the target is included — the viewer works blind. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/seal_mission_impression":{"post":{"operationId":"seal_mission_impression","summary":"Seal my impression on a mission","description":"Seals the member's blind impressions on an open mission. This is final: one seal per mission, it cannot be edited, and it is rejected after the mission's lock time. Use the member's own words and perceptions; do not invent impressions on their behalf. Requires the \"missions\" permission.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mission":{"type":"string","description":"The mission's slug from list_open_missions."},"description":{"type":"string","minLength":20,"maxLength":800,"description":"The member's raw impressions, in their own words."},"confidence":{"type":"integer","minimum":1,"maximum":10,"description":"How confident the member feels, 1-10."},"colors":{"type":"string","description":"Comma-separated colors, optional."},"shapes":{"type":"string","description":"Comma-separated shapes, optional."},"textures":{"type":"string","description":"Comma-separated textures, optional."},"movement":{"type":"string","description":"Sense of movement, optional."},"emotion":{"type":"string","description":"Emotional tone, optional."},"objects":{"type":"string","description":"Comma-separated objects sensed, optional."},"scene":{"type":"string","description":"Kind of scene (indoor, landscape, water…), optional."},"targetGuess":{"type":"string","enum":["TARGET_A","TARGET_B","UNKNOWN"],"description":"For two-target missions. Default UNKNOWN."},"marketGuess":{"type":"string","enum":["YES","NO","UNKNOWN"],"description":"For paper-market missions. Default UNKNOWN."},"visibility":{"type":"string","enum":["PUBLIC_AFTER_RESOLVE","ANONYMOUS_AFTER_RESOLVE","PRIVATE"],"description":"Who may see the session after the reveal. Default PRIVATE."}},"required":["mission","description","confidence"],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/my_results":{"post":{"operationId":"my_results","summary":"My sealed sessions and results","description":"The member's own recent mission sessions with their outcome (pending until the reveal), plus recent practice sessions. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/start_practice_target":{"post":{"operationId":"start_practice_target","summary":"Generate a sealed practice target","description":"Generates a new blind practice target (an image the member will try to describe) and seals it. Returns a caseId and when the reveal opens; the image is NOT returned yet. Ask the member for their impressions during the seal window, then call reveal_practice_target. Requires the \"practice\" permission.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"style":{"type":"string","enum":["number-lock","blind-embedded-number","control-no-number"],"description":"number-lock (a target number is shown up front; default), blind-embedded-number (a hidden number is part of the image), control-no-number (image only)."}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/reveal_practice_target":{"post":{"operationId":"reveal_practice_target","summary":"Reveal a practice target","description":"Reveals a practice target once its seal window has passed: the image URL, title and description. Before then it reports how many seconds remain and reveals nothing. Requires the \"practice\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caseId":{"type":"string","description":"The caseId from start_practice_target."}},"required":["caseId"],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/record_practice_session":{"post":{"operationId":"record_practice_session","summary":"Save a practice session","description":"Saves the member's practice session for a revealed target: their impressions and their own honest judgement of the match. Counts toward their streak. Only works after the target is revealed. Requires the \"practice\" permission.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caseId":{"type":"string","description":"The caseId from start_practice_target."},"impressions":{"type":"string","maxLength":2000,"description":"What the member noted before the reveal, in their words."},"match":{"type":"string","enum":["strong","partial","miss"],"description":"The member's own judgement after seeing the target."},"analyticalNoise":{"type":"string","description":"Guesses or labels the member noticed their mind adding (AOL), optional."},"numberGuess":{"type":"string","description":"Their guess at the hidden number, for the blind-embedded-number style."}},"required":["caseId","impressions","match"],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/list_challenges":{"post":{"operationId":"list_challenges","summary":"Community challenges","description":"Monthly community challenges: what each asks for, its dates, the current standings, and how to take part. A member joins simply by sealing eligible mission sessions during the month; there is no separate sign-up. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/get_leaderboard":{"post":{"operationId":"get_leaderboard","summary":"Leaderboards","description":"Current community leaderboards: viewers ranked by scored sessions, or members ranked by community contribution. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board":{"type":"string","enum":["viewers","community"],"description":"viewers (default): scored sessions. community: discussion contribution."}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/list_discussions":{"post":{"operationId":"list_discussions","summary":"Recent discussions","description":"Recent public discussions (remote viewing, UFO/UAP, dreams, practice reports) with their groups, plus the discussion groups a new thread can be filed under. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/read_discussion":{"post":{"operationId":"read_discussion","summary":"Read a discussion","description":"One public discussion with its replies (oldest first, up to 60), so a reply can be written in context. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discussionId":{"type":"string","description":"discussionId from list_discussions."}},"required":["discussionId"],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/start_discussion":{"post":{"operationId":"start_discussion","summary":"Start a discussion","description":"Posts a new public discussion as the member. Community standards apply (no accusations against real people, no medical or financial claims, no spam); a post that breaks them is refused. Write what the member asked you to say — it is published under their name. Requires the \"community\" permission.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":4,"maxLength":120},"summary":{"type":"string","minLength":10,"maxLength":600,"description":"One or two sentences shown in lists."},"body":{"type":"string","maxLength":2000,"description":"The opening post, optional."},"kind":{"type":"string","enum":["EXPERIENCE","PRACTICE_REPORT","QUESTION","RESOURCE","PROTOCOL","USER_TOPIC"],"description":"Default EXPERIENCE."},"groupId":{"type":"string","description":"A groupId from list_discussions, optional."}},"required":["title","summary"],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/reply_to_discussion":{"post":{"operationId":"reply_to_discussion","summary":"Reply to a discussion","description":"Posts a reply as the member in a discussion (optionally to a specific reply). Community standards apply; it is published under their name. Requires the \"community\" permission.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discussionId":{"type":"string","description":"discussionId from list_discussions."},"text":{"type":"string","description":"The reply, up to 2,000 characters."},"inReplyTo":{"type":"string","description":"A replyId from read_discussion, to answer that reply. Optional."}},"required":["discussionId","text"],"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/agent/v1/tools/get_notifications":{"post":{"operationId":"get_notifications","summary":"My notifications","description":"The member's recent notifications: reveals that are ready, replies to their discussions, streak reminders. Requires the \"read\" permission.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"The tool ran.","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"result":{}},"required":["ok","result"]}}}},"default":{"description":"The tool did not run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"agentToken":{"type":"http","scheme":"bearer","description":"Personal agent token from https://www.goremoteviewing.com/settings/agents"}},"schemas":{"Error":{"type":"object","properties":{"ok":{"type":"boolean"},"error":{"type":"string"}},"required":["ok","error"]}}}}