{"openapi":"3.1.0","info":{"title":"TellMeHow API","version":"1.0.0","description":"Public API of a workspace. Authenticate with a personal API token or an OAuth access token (`Authorization: Bearer …`). A token acts with the exact rights of its member (roles and policies apply as in the web app); a `read` token can only call GET operations. JSON bodies use snake_case, dates are ISO 8601 UTC, identifiers are ULIDs. Long lists are paginated with `?cursor=&limit=`. Errors: `{ code, message, details }` with a stable `code`."},"servers":[{"url":"https://{workspace}.tellmehow.io/api/v1","description":"Your workspace: replace {workspace} with its subdomain.","variables":{"workspace":{"default":"your-workspace","description":"Workspace subdomain."}}}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Ai"},{"name":"Analysis"},{"name":"Chat"},{"name":"Deliverables"},{"name":"Engagements"},{"name":"Integrations"},{"name":"Interviews"},{"name":"Methods"},{"name":"Privacy"},{"name":"Sources"},{"name":"Usage"},{"name":"Workspaces"}],"paths":{"/ai/catalog":{"get":{"tags":["Ai"],"operationId":"ai.catalog","summary":"Get — Catalog","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/credentials":{"get":{"tags":["Ai"],"operationId":"ai.credentials.index","summary":"List — Credential","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/credentials/{credential}/test":{"post":{"tags":["Ai"],"operationId":"ai.credentials.test","summary":"Test — Credential","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"credential","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/enums/drivers":{"get":{"tags":["Ai"],"operationId":"ai.enums.drivers","summary":"Drivers — Catalog","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/enums/usages":{"get":{"tags":["Ai"],"operationId":"ai.enums.usages","summary":"Usages — Catalog","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/enums/voice-architectures":{"get":{"tags":["Ai"],"operationId":"ai.enums.voice-architectures","summary":"Voice Architectures — Catalog","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/price-grid":{"get":{"tags":["Ai"],"operationId":"ai.price-grid.index","summary":"List — Price Grid","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/profiles":{"get":{"tags":["Ai"],"operationId":"ai.profiles.index","summary":"List — Profile","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"put":{"tags":["Ai"],"operationId":"ai.profiles.upsert","summary":"Upsert — Profile","security":[{"bearerAuth":["write"]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope_type":{"enum":["workspace","method","engagement"]},"scope_id":{"type":["string","null"],"minLength":26,"maxLength":26},"usage":{"enum":["voice","stt","tts","transcription","vision","analysis","chat","embedding","ocr"]},"driver":{"enum":["openai","openai_compatible","mistral","anthropic","deepgram","elevenlabs","tesseract"]},"model":{"type":"string","maxLength":128},"voice_architecture":{"enum":["realtime","cascade"]},"settings":{"type":"array","properties":{"base_url":{"type":["string","null"],"maxLength":512},"capabilities":{"type":"array","items":{"type":"boolean"}}}},"credential_source":{"enum":["workspace","platform"]},"credential_id":{"type":["string","null"],"minLength":26,"maxLength":26},"label":{"type":["string","null"],"maxLength":255},"is_enabled":{"type":"boolean"}},"required":["scope_type","usage","driver","model","credential_source"]}}}}}},"/ai/profiles/{profile}":{"delete":{"tags":["Ai"],"operationId":"ai.profiles.destroy","summary":"Delete — Profile","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"profile","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/profiles/{profile}/test":{"post":{"tags":["Ai"],"operationId":"ai.profiles.test","summary":"Test — Profile","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"profile","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sample":{"type":["string","null"],"maxLength":500},"scope_type":{"enum":["workspace","method","engagement"]},"scope_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}}},"/ai/usages/{usage}/test":{"post":{"tags":["Ai"],"operationId":"ai.usages.test","summary":"Test Usage — Profile","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"usage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"sample":{"type":["string","null"],"maxLength":500},"scope_type":{"enum":["workspace","method","engagement"]},"scope_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}}},"/ai/voice-lab/trials":{"get":{"tags":["Ai"],"operationId":"ai.voice-lab.index","summary":"List — Voice Lab","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Ai"],"operationId":"ai.voice-lab.store","summary":"Create — Voice Lab","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"engagement_id":{"type":["string","null"],"minLength":26,"maxLength":26},"mode":{"enum":["voice_only","voice_screen"]},"locale":{"type":["string","null"],"maxLength":8},"label":{"type":["string","null"],"maxLength":255},"voice_profile_id":{"type":["string","null"],"minLength":26,"maxLength":26},"voice":{"type":["array","null"],"properties":{"voice_architecture":{"enum":["realtime","cascade"]},"driver":{"enum":["openai","openai_compatible","mistral","anthropic","deepgram","elevenlabs","tesseract"]},"model":{"type":"string","maxLength":128},"settings":{"type":"array"},"credential_source":{"enum":["workspace","platform"]},"credential_id":{"type":["string","null"],"minLength":26,"maxLength":26}}},"stt":{"type":["array","null"],"properties":{"driver":{"enum":["openai","openai_compatible","mistral","anthropic","deepgram","elevenlabs","tesseract"]},"model":{"type":"string","maxLength":128},"settings":{"type":"array"},"credential_source":{"enum":["workspace","platform"]},"credential_id":{"type":["string","null"],"minLength":26,"maxLength":26}}},"tts":{"type":["array","null"],"properties":{"driver":{"enum":["openai","openai_compatible","mistral","anthropic","deepgram","elevenlabs","tesseract"]},"model":{"type":"string","maxLength":128},"settings":{"type":"array"},"credential_source":{"enum":["workspace","platform"]},"credential_id":{"type":["string","null"],"minLength":26,"maxLength":26}}},"client_info":{"type":["array","null"],"properties":{"os":{"type":["string","null"],"maxLength":64},"browser":{"type":["string","null"],"maxLength":64},"device_class":{"type":["string","null"],"maxLength":64}}}}}}}}}},"/ai/voice-lab/trials/{trial}":{"patch":{"tags":["Ai"],"operationId":"ai.voice-lab.update","summary":"Update — Voice Lab","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"trial","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"first_sound_ms":{"type":["integer","null"],"minimum":0,"maximum":600000},"response_ms":{"type":["integer","null"],"minimum":0,"maximum":600000},"duration_ms":{"type":["integer","null"],"minimum":0,"maximum":3600000},"note":{"type":["string","null"],"maxLength":2000}}}}}}},"delete":{"tags":["Ai"],"operationId":"ai.voice-lab.destroy","summary":"Delete — Voice Lab","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"trial","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ai/voices":{"get":{"tags":["Ai"],"operationId":"ai.voices","summary":"Voices — Catalog","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/analysis/enums/{name}":{"get":{"tags":["Analysis"],"operationId":"analysis.enums","summary":"Get — Analysis Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/client-companies":{"get":{"tags":["Engagements"],"operationId":"client-companies.index","summary":"List — Client Company","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Engagements"],"operationId":"client-companies.store","summary":"Create — Client Company","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"industry":{"type":["string","null"],"maxLength":255},"headcount":{"type":["integer","null"],"minimum":1,"maximum":10000000},"country":{"type":["string","null"],"minLength":2,"maxLength":2},"notes":{"type":["string","null"],"maxLength":5000}},"required":["name"]}}}}}},"/client-companies/{company}":{"patch":{"tags":["Engagements"],"operationId":"client-companies.update","summary":"Update — Client Company","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"industry":{"type":["string","null"],"maxLength":255},"headcount":{"type":["integer","null"],"minimum":1,"maximum":10000000},"country":{"type":["string","null"],"minLength":2,"maxLength":2},"notes":{"type":["string","null"],"maxLength":5000}}}}}}},"delete":{"tags":["Engagements"],"operationId":"client-companies.destroy","summary":"Delete — Client Company","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/compliance-documents/{document}/download":{"get":{"tags":["Privacy"],"operationId":"privacy.compliance-documents.download","summary":"Download — Compliance Document","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"document","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements":{"get":{"tags":["Engagements"],"operationId":"engagements.index","summary":"List — Engagement","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Engagements"],"operationId":"engagements.store","summary":"Create — Engagement","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"client_company_id":{"type":"string","minLength":26,"maxLength":26},"method_id":{"type":"string","minLength":26,"maxLength":26},"method_version_id":{"type":["string","null"],"minLength":26,"maxLength":26},"locales":{"type":"array","minItems":1,"items":{"type":"string","maxLength":8}},"default_locale":{"type":["string","null"],"maxLength":8},"objectives":{"type":["string","null"],"maxLength":10000},"context":{"type":["string","null"],"maxLength":20000},"known_tools":{"type":"array","maxItems":60,"items":{"type":"string","maxLength":120}},"vocabulary":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"term":{"type":"string","maxLength":120},"meaning":{"type":["string","null"],"maxLength":500}},"required":["term"]}},"deadline_at":{"type":["string","null"],"format":"date-time"}},"required":["name","client_company_id","method_id"]}}}}}},"/engagements/enums/blur-categories":{"get":{"tags":["Engagements"],"operationId":"engagements.enums.blur-categories","summary":"Blur Categories — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/enums/{name}":{"get":{"tags":["Engagements"],"operationId":"engagements.enums.show","summary":"Get — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}":{"get":{"tags":["Engagements"],"operationId":"engagements.show","summary":"Get — Engagement","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Engagements"],"operationId":"engagements.update","summary":"Update — Engagement","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"client_company_id":{"type":"string","minLength":26,"maxLength":26},"method_id":{"type":"string","minLength":26,"maxLength":26},"method_version_id":{"type":"string","minLength":26,"maxLength":26},"context":{"type":["string","null"],"maxLength":20000},"objectives":{"type":["string","null"],"maxLength":10000},"vocabulary":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"term":{"type":"string","maxLength":120},"meaning":{"type":["string","null"],"maxLength":500}},"required":["term"]}},"known_tools":{"type":"array","maxItems":60,"items":{"type":"string","maxLength":120}},"locales":{"type":"array","minItems":1,"items":{"type":"string","maxLength":8}},"default_locale":{"type":"string","maxLength":8},"sharing_mode":{"enum":["disabled","anonymized","by_role"]},"naming_allowed":{"type":"boolean"},"deadline_at":{"type":["string","null"],"format":"date-time"},"retention_raw_days":{"type":"integer","minimum":1,"maximum":3650},"retention_deliverable_days":{"type":"integer","minimum":1,"maximum":3650},"video_mode":{"enum":["full","keyframes"]},"tacit_validation_days":{"type":["integer","null"],"minimum":1,"maximum":60},"blur_enabled":{"type":"boolean"},"blur_categories":{"type":"array","items":{"type":"string","enum":["iban","card","nir","email","phone","password","custom","mask"]}},"blur_custom_patterns":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"label":{"type":"string","maxLength":120},"regex":{"type":"string","maxLength":500}},"required":["label","regex"]}},"posture_overrides":{"type":"array"},"welcome_screen_overrides":{"type":"array"},"reminder_schedule":{"type":"array","properties":{"enabled":{"type":"boolean"},"not_started_days":{"type":"array","maxItems":6,"items":{"type":"integer","minimum":1,"maximum":90}},"unvalidated_days":{"type":"array","maxItems":6,"items":{"type":"integer","minimum":1,"maximum":90}}}},"cse_informed_at":{"type":["string","null"],"format":"date-time"},"cse_consulted_at":{"type":["string","null"],"format":"date-time"},"budget_cap_session":{"type":["number","null"],"minimum":0,"maximum":100000},"budget_cap_total":{"type":["number","null"],"minimum":0,"maximum":10000000},"settings":{"type":"array","properties":{"require_email_code":{"type":"boolean"}}}}}}}}},"delete":{"tags":["Engagements"],"operationId":"engagements.destroy","summary":"Delete — Engagement","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/analysis/runs":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.runs.index","summary":"List — Analysis Run","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Analysis"],"operationId":"engagements.analysis.runs.store","summary":"Create — Analysis Run","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"enum":["incremental","full"]}},"required":["mode"]}}}}}},"/engagements/{engagement}/analysis/runs/{run}/cancel":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.runs.cancel","summary":"Cancel — Analysis Run","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"run","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/analysis/summary":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.summary","summary":"Summary — Analysis Run","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/archive":{"post":{"tags":["Engagements"],"operationId":"engagements.archive","summary":"Archive — Engagement","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/artifacts":{"get":{"tags":["Sources"],"operationId":"engagements.sources.artifacts.index","summary":"List — Artifact","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Sources"],"operationId":"engagements.sources.artifacts.store","summary":"Create — Artifact","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","maxLength":25600}},"required":["file"]}}}}}},"/engagements/{engagement}/artifacts/{artifact}":{"get":{"tags":["Sources"],"operationId":"engagements.sources.artifacts.show","summary":"Get — Artifact","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"artifact","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"delete":{"tags":["Sources"],"operationId":"engagements.sources.artifacts.destroy","summary":"Delete — Artifact","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"artifact","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/artifacts/{artifact}/download":{"get":{"tags":["Sources"],"operationId":"engagements.sources.artifacts.download","summary":"Download — Artifact","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"artifact","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/blur-preview":{"post":{"tags":["Engagements"],"operationId":"engagements.blur-preview","summary":"Blur Preview — Engagement","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":5000},"blur_categories":{"type":"array","items":{"type":"string"}},"blur_custom_patterns":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"label":{"type":"string","maxLength":120},"regex":{"type":"string","maxLength":500}},"required":["label","regex"]}}},"required":["text"]}}}}}},"/engagements/{engagement}/change-proposals":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.change-proposals.index","summary":"List — Change Proposal","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/change-proposals/accept-all":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.change-proposals.accept-all","summary":"Accept All — Change Proposal","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"entity_type":{"enum":["process","process_step","process_flow","finding","opportunity"]},"analysis_run_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}}},"/engagements/{engagement}/change-proposals/reject-all":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.change-proposals.reject-all","summary":"Reject All — Change Proposal","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"entity_type":{"enum":["process","process_step","process_flow","finding","opportunity"]},"analysis_run_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}}},"/engagements/{engagement}/change-proposals/{proposal}/accept":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.change-proposals.accept","summary":"Accept — Change Proposal","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/change-proposals/{proposal}/reject":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.change-proposals.reject","summary":"Reject — Change Proposal","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/chat/threads":{"get":{"tags":["Chat"],"operationId":"chat.threads.index","summary":"Threads — Chat","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Chat"],"operationId":"chat.threads.store","summary":"Create — Chat","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"deliverable_version_id":{"type":["string","null"]},"title":{"type":["string","null"],"maxLength":255}}}}}}}},"/engagements/{engagement}/chat/threads/{thread}":{"delete":{"tags":["Chat"],"operationId":"chat.threads.destroy","summary":"Delete — Chat","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"thread","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/chat/threads/{thread}/messages":{"get":{"tags":["Chat"],"operationId":"chat.threads.messages.index","summary":"Messages — Chat","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"thread","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Chat"],"operationId":"chat.threads.messages.store","summary":"Ask — Chat","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"thread","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","maxLength":2000}},"required":["content"]}}}}}},"/engagements/{engagement}/compliance-documents":{"get":{"tags":["Privacy"],"operationId":"privacy.engagements.compliance-documents.index","summary":"List — Compliance Document","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Privacy"],"operationId":"privacy.engagements.compliance-documents.store","summary":"Create — Compliance Document","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"enum":["cse_note","dpia_template","processing_agreement","classification_note"]},"locale":{"type":"string","enum":["en","fr"]},"engagement_id":{"type":["string","null"],"minLength":26,"maxLength":26}},"required":["kind","locale"]}}}}}},"/engagements/{engagement}/contradictions":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.contradictions.index","summary":"List — Contradiction","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/contradictions/{contradiction}/resolve":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.contradictions.resolve","summary":"Resolve — Contradiction","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"contradiction","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["resolved","kept_as_finding","dismissed"]},"resolution_note":{"type":["string","null"],"maxLength":2000},"resolved_finding_id":{"type":["string","null"],"minLength":26,"maxLength":26}},"required":["status"]}}}}}},"/engagements/{engagement}/costs":{"get":{"tags":["Usage"],"operationId":"engagements.costs","summary":"App\\ Http\\ Controllers\\ Api\\ V1\\ Usage\\ Engagement Cost Controller — Engagement Cost","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deletion-requests":{"get":{"tags":["Privacy"],"operationId":"privacy.engagements.deletion-requests.index","summary":"List — Deletion Request","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Privacy"],"operationId":"privacy.engagements.deletion-requests.store","summary":"Create — Deletion Request","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"participant_id":{"type":"string","minLength":26,"maxLength":26}},"required":["participant_id"]}}}}}},"/engagements/{engagement}/deletion-requests/{deletion}/execute":{"post":{"tags":["Privacy"],"operationId":"privacy.engagements.deletion-requests.execute","summary":"Execute — Deletion Request","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"deletion","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/comments/{comment}/close":{"post":{"tags":["Deliverables"],"operationId":"deliverables.comments.close","summary":"Close — Sponsor Comment","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"comment","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/comments/{comment}/reply":{"post":{"tags":["Deliverables"],"operationId":"deliverables.comments.reply","summary":"Reply — Sponsor Comment","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"comment","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"body":{"type":"string","maxLength":5000}},"required":["body"]}}}}}},"/engagements/{engagement}/deliverable/documents":{"get":{"tags":["Deliverables"],"operationId":"deliverables.documents.index","summary":"List — Deliverable Document","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/documents/generate-all":{"post":{"tags":["Deliverables"],"operationId":"deliverables.documents.generate-all","summary":"Generate All — Deliverable Document","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ai":{"type":"boolean"}}}}}}}},"/engagements/{engagement}/deliverable/documents/{kind}":{"get":{"tags":["Deliverables"],"operationId":"deliverables.documents.show","summary":"Get — Deliverable Document","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Deliverables"],"operationId":"deliverables.documents.update","summary":"Update — Deliverable Document","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"updated_at":{"type":"string","maxLength":64},"included":{"type":"boolean"},"parameters":{"type":"array"},"blocks":{"type":"array","maxItems":200,"items":{"type":"array","properties":{"id":{"type":["string","null"],"maxLength":64},"type":{"enum":["heading","paragraph","message","key_figures","item_list","table","chart","process","quote","callout"]},"level":{"type":["integer","null"]},"text":{"type":["string","null"],"maxLength":5000},"title":{"type":["string","null"],"maxLength":200},"refs":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"type":{"enum":["finding","opportunity","process","process_step","contradiction","evidence","tool","topic","follow_up"]},"id":{"type":"string","maxLength":64}},"required":["type","id"]}},"data_ref":{"type":["string","null"],"maxLength":64},"items":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":64}},"item_type":{"enum":["finding","opportunity","process","process_step","contradiction","evidence","tool","topic","follow_up"]},"ids":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":64}},"display":{"enum":["compact","full"]},"options":{"type":["array","null"]},"chart":{"enum":["gain_effort_matrix","pain_heatmap","coverage_bars","topic_coverage","roadmap_lanes"]},"process_id":{"type":["string","null"],"maxLength":64},"show_map":{"type":"boolean"},"evidence_id":{"type":["string","null"],"maxLength":64},"theme":{"type":["string","null"],"maxLength":64},"tone":{"enum":["info","caution"]}},"required":["type"]}}},"required":["updated_at"]}}}}}},"/engagements/{engagement}/deliverable/documents/{kind}/generate":{"post":{"tags":["Deliverables"],"operationId":"deliverables.documents.generate","summary":"Generate — Deliverable Document","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"enum":["keep_edits","replace_all"]},"process_id":{"type":["string","null"]},"ai":{"type":"boolean"}}}}}}}},"/engagements/{engagement}/deliverable/draft":{"get":{"tags":["Deliverables"],"operationId":"deliverables.draft.show","summary":"Get — Deliverable Draft","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Deliverables"],"operationId":"deliverables.draft.update","summary":"Update — Deliverable Draft","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"introduction":{"type":["string","null"],"maxLength":20000},"recommendations":{"type":["string","null"],"maxLength":20000},"attribution":{"enum":["by_role","named"]},"named_interview_ids":{"type":"array","items":{"type":"string"}},"include_proposed":{"type":"boolean"},"dismiss_suggestion":{"type":"boolean"},"stage":{"enum":["interim","final"]},"auto_refresh_interim":{"type":"boolean"}}}}}}}},"/engagements/{engagement}/deliverable/draft/evidences/{evidence}/preview":{"get":{"tags":["Deliverables"],"operationId":"deliverables.draft.evidences.preview","summary":"Evidence Preview — Deliverable Draft","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidence","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/draft/preview":{"get":{"tags":["Deliverables"],"operationId":"deliverables.draft.preview","summary":"Preview — Deliverable Draft","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/draft/suggest-recommendations":{"post":{"tags":["Deliverables"],"operationId":"deliverables.draft.suggest","summary":"Suggest — Deliverable Draft","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/publish":{"post":{"tags":["Deliverables"],"operationId":"deliverables.publish","summary":"Publish — Deliverable Version","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"changelog":{"type":["string","null"],"maxLength":5000},"stage":{"enum":["interim","final"]}}}}}}}},"/engagements/{engagement}/deliverable/versions":{"get":{"tags":["Deliverables"],"operationId":"deliverables.versions.index","summary":"List — Deliverable Version","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/versions/{version}":{"get":{"tags":["Deliverables"],"operationId":"deliverables.versions.show","summary":"Get — Deliverable Version","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/versions/{version}/comments":{"get":{"tags":["Deliverables"],"operationId":"deliverables.versions.comments.index","summary":"List — Sponsor Comment","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/deliverable/versions/{version}/snapshot":{"get":{"tags":["Deliverables"],"operationId":"deliverables.versions.snapshot","summary":"Snapshot — Deliverable Version","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/evidences/{evidence}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.evidences.update","summary":"Update Evidence — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidence","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"is_publishable":{"type":"boolean"}},"required":["is_publishable"]}}}}}},"/engagements/{engagement}/evidences/{evidence}/preview":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.evidences.preview","summary":"Preview Evidence — Finding","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidence","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/exports":{"get":{"tags":["Deliverables"],"operationId":"deliverables.exports.index","summary":"List — Export","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Deliverables"],"operationId":"deliverables.exports.store","summary":"Create — Export","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"enum":["bpmn","findings_csv","opportunities_csv","json_bundle","printable","document_pdf","document_pptx","document_docx","document_csv","deliverable_pdf"]},"deliverable_version_id":{"type":["string","null"]},"process_id":{"type":["string","null"]},"document_kind":{"enum":["coverage","interim_insights","methodology","executive_summary","roadmap","process_sheets","tool_landscape","role_activity","pain_map","uncertainties","verbatims"]}},"required":["kind"]}}}}}},"/engagements/{engagement}/exports/{export}/download":{"get":{"tags":["Deliverables"],"operationId":"deliverables.exports.download","summary":"Download — Export","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"export","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/external-sources":{"get":{"tags":["Sources"],"operationId":"engagements.sources.external-sources.index","summary":"List — External Source","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Sources"],"operationId":"engagements.sources.external-sources.store","summary":"Create — External Source","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","maxLength":10240},"name":{"type":"string","maxLength":255}},"required":["file","name"]}}}}}},"/engagements/{engagement}/external-sources/{source}":{"delete":{"tags":["Sources"],"operationId":"engagements.sources.external-sources.destroy","summary":"Delete — External Source","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"source","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/external-sources/{source}/items":{"get":{"tags":["Sources"],"operationId":"engagements.sources.external-sources.items","summary":"Items — External Source","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"source","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/findings":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.index","summary":"List — Finding","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.store","summary":"Create — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"enum":["irritant","re_entry","volume","duration","business_rule","tool","key_person_dependency","risk","good_practice","other"]},"statement":{"type":"string","maxLength":1000},"details":{"type":["string","null"],"maxLength":4000},"quantity":{"type":["array","null"]},"process_id":{"type":["string","null"],"minLength":26,"maxLength":26},"step_id":{"type":["string","null"],"minLength":26,"maxLength":26},"deliverable_category":{"type":["string","null"],"maxLength":64},"evidences":{"type":"array","items":{"type":"object","properties":{"source_type":{"enum":["transcript_segment","screen_frame","pin","artifact_chunk","external_source_item","recap_item"]},"source_id":{"type":"string","minLength":26,"maxLength":26},"locator":{"type":["array","null"]},"excerpt":{"type":["string","null"],"maxLength":1000}},"required":["source_type","source_id"]}}},"required":["type","statement"]}}}}}},"/engagements/{engagement}/findings/{finding}":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.show","summary":"Get — Finding","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"finding","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.update","summary":"Update — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"finding","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"enum":["irritant","re_entry","volume","duration","business_rule","tool","key_person_dependency","risk","good_practice","other"]},"statement":{"type":"string","maxLength":1000},"details":{"type":["string","null"],"maxLength":4000},"quantity":{"type":["array","null"]},"process_id":{"type":["string","null"],"minLength":26,"maxLength":26},"step_id":{"type":["string","null"],"minLength":26,"maxLength":26},"deliverable_category":{"type":["string","null"],"maxLength":64}}}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.destroy","summary":"Delete — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"finding","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/findings/{finding}/evidences":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.evidences.store","summary":"Store Evidence — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"finding","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_type":{"enum":["transcript_segment","screen_frame","pin","artifact_chunk","external_source_item","recap_item"]},"source_id":{"type":"string","minLength":26,"maxLength":26},"locator":{"type":["array","null"]},"excerpt":{"type":["string","null"],"maxLength":1000}},"required":["source_type","source_id"]}}}}}},"/engagements/{engagement}/findings/{finding}/evidences/{evidence}":{"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.evidences.destroy","summary":"Destroy Evidence — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"finding","in":"path","required":true,"schema":{"type":"string"}},{"name":"evidence","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/findings/{finding}/review":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.findings.review","summary":"Review — Finding","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"finding","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"review_status":{"enum":["proposed","validated","rejected"]}},"required":["review_status"]}}}}}},"/engagements/{engagement}/follow-ups":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.follow-ups.index","summary":"List — Follow Up","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Analysis"],"operationId":"engagements.analysis.follow-ups.store","summary":"Create — Follow Up","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"enum":["contradiction","gap","uncertain_figure","shallow_topic","gain_data"]},"title":{"type":"string","maxLength":255},"questions":{"type":"array","minItems":2,"maxItems":5,"items":{"type":"string","maxLength":500}},"estimated_minutes":{"type":"integer","minimum":5,"maximum":15},"participant_ids":{"type":"array","minItems":1,"items":{"type":"string","minLength":26,"maxLength":26}},"contradiction_id":{"type":["string","null"],"minLength":26,"maxLength":26},"finding_id":{"type":["string","null"],"minLength":26,"maxLength":26},"topic_key":{"type":["string","null"],"maxLength":64}},"required":["reason","title","questions","estimated_minutes","participant_ids"]}}}}}},"/engagements/{engagement}/follow-ups/{proposal}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.follow-ups.update","summary":"Update — Follow Up","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"questions":{"type":"array","minItems":2,"maxItems":5,"items":{"type":"string","maxLength":500}},"estimated_minutes":{"type":"integer","minimum":5,"maximum":15},"participant_ids":{"type":"array","minItems":1,"items":{"type":"string","minLength":26,"maxLength":26}}}}}}}}},"/engagements/{engagement}/follow-ups/{proposal}/accept":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.follow-ups.accept","summary":"Accept — Follow Up","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"send_now":{"type":["boolean","null"]}}}}}}}},"/engagements/{engagement}/follow-ups/{proposal}/decline":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.follow-ups.decline","summary":"Decline — Follow Up","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/interviews":{"get":{"tags":["Interviews"],"operationId":"engagements.interviews.index","summary":"List — Interview","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/interviews/preview-session":{"post":{"tags":["Interviews"],"operationId":"engagements.interviews.preview","summary":"Preview — Interview","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"population_id":{"type":["string","null"],"minLength":26,"maxLength":26},"mode":{"enum":["voice_screen","voice_only","text_simulation"]},"locale":{"type":["string","null"],"maxLength":8},"client_info":{"type":["array","null"],"properties":{"os":{"type":["string","null"],"maxLength":64},"browser":{"type":["string","null"],"maxLength":64},"device_class":{"type":["string","null"],"maxLength":64}}}}}}}}}},"/engagements/{engagement}/interviews/test":{"post":{"tags":["Interviews"],"operationId":"engagements.interviews.test","summary":"Test — Interview","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"population_id":{"type":["string","null"],"minLength":26,"maxLength":26},"mode":{"enum":["voice_screen","voice_only","text_simulation"]},"locale":{"type":["string","null"],"maxLength":8},"client_info":{"type":["array","null"],"properties":{"os":{"type":["string","null"],"maxLength":64},"browser":{"type":["string","null"],"maxLength":64},"device_class":{"type":["string","null"],"maxLength":64}}}}}}}}}},"/engagements/{engagement}/invite-all":{"post":{"tags":["Engagements"],"operationId":"engagements.invite-all","summary":"Invite All — Participant Link","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"only_not_invited":{"type":"boolean"},"participant_ids":{"type":"array","items":{"type":"string","minLength":26,"maxLength":26}}}}}}}}},"/engagements/{engagement}/launch":{"post":{"tags":["Engagements"],"operationId":"engagements.launch","summary":"Launch — Engagement","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"send_invitations":{"type":"boolean"}}}}}}}},"/engagements/{engagement}/launch-check":{"get":{"tags":["Engagements"],"operationId":"engagements.launch-check","summary":"Launch Check — Engagement","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/live-sessions":{"get":{"tags":["Interviews"],"operationId":"engagements.live-sessions","summary":"Live Sessions — Interview","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/members":{"post":{"tags":["Engagements"],"operationId":"engagements.members.store","summary":"Create — Engagement Member","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string","minLength":26,"maxLength":26}},"required":["user_id"]}}}}}},"/engagements/{engagement}/members/{user}":{"delete":{"tags":["Engagements"],"operationId":"engagements.members.destroy","summary":"Delete — Engagement Member","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"user","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/message-templates":{"get":{"tags":["Engagements"],"operationId":"engagements.message-templates.index","summary":"List — Message Template","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/message-templates/{kind}/{locale}":{"get":{"tags":["Engagements"],"operationId":"engagements.message-templates.show","summary":"Get — Message Template","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"put":{"tags":["Engagements"],"operationId":"engagements.message-templates.update","summary":"Update — Message Template","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","maxLength":255},"body_markdown":{"type":"string","maxLength":20000}},"required":["subject","body_markdown"]}}}}},"delete":{"tags":["Engagements"],"operationId":"engagements.message-templates.destroy","summary":"Delete — Message Template","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/opportunities":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.opportunities.index","summary":"List — Opportunity","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Analysis"],"operationId":"engagements.analysis.opportunities.store","summary":"Create — Opportunity","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"problem":{"type":"string","maxLength":4000},"solution":{"type":"string","maxLength":4000},"category":{"type":"string","maxLength":64},"gain":{"type":["array","null"]},"effort":{"enum":["low","medium","high"]},"priority":{"type":["string","null"],"maxLength":32},"risks":{"type":["string","null"],"maxLength":2000},"finding_ids":{"type":"array","minItems":1,"items":{"type":"string","minLength":26,"maxLength":26}}},"required":["title","problem","solution","category","effort","finding_ids"]}}}}}},"/engagements/{engagement}/opportunities/{opportunity}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.opportunities.update","summary":"Update — Opportunity","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"opportunity","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"problem":{"type":"string","maxLength":4000},"solution":{"type":"string","maxLength":4000},"category":{"type":"string","maxLength":64},"gain":{"type":["array","null"]},"effort":{"enum":["low","medium","high"]},"priority":{"type":["string","null"],"maxLength":32},"risks":{"type":["string","null"],"maxLength":2000},"finding_ids":{"type":"array","minItems":1,"items":{"type":"string","minLength":26,"maxLength":26}}}}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.opportunities.destroy","summary":"Delete — Opportunity","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"opportunity","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/opportunities/{opportunity}/review":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.opportunities.review","summary":"Review — Opportunity","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"opportunity","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"review_status":{"enum":["proposed","validated","rejected"]}},"required":["review_status"]}}}}}},"/engagements/{engagement}/participants":{"get":{"tags":["Engagements"],"operationId":"engagements.participants.index","summary":"List — Participant","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Engagements"],"operationId":"engagements.participants.store","summary":"Create — Participant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","maxLength":255},"email":{"type":"string","format":"email","maxLength":255},"role_title":{"type":"string","maxLength":255},"population_id":{"type":"string","minLength":26,"maxLength":26},"locale":{"type":["string","null"],"maxLength":8},"consultant_note":{"type":["string","null"],"maxLength":5000}},"required":["display_name","email","role_title","population_id"]}}}}}},"/engagements/{engagement}/participants/import":{"post":{"tags":["Engagements"],"operationId":"engagements.participants.import","summary":"Import — Participant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","maxLength":1024},"dry_run":{"type":"boolean"},"create_populations":{"type":"boolean"}},"required":["file"]}}}}}},"/engagements/{engagement}/participants/{participant}":{"get":{"tags":["Engagements"],"operationId":"engagements.participants.show","summary":"Get — Participant","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Engagements"],"operationId":"engagements.participants.update","summary":"Update — Participant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"type":"string","maxLength":255},"email":{"type":"string","format":"email","maxLength":255},"role_title":{"type":"string","maxLength":255},"population_id":{"type":"string","minLength":26,"maxLength":26},"locale":{"type":["string","null"],"maxLength":8},"consultant_note":{"type":["string","null"],"maxLength":5000}}}}}}},"delete":{"tags":["Engagements"],"operationId":"engagements.participants.destroy","summary":"Delete — Participant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/participants/{participant}/invite":{"post":{"tags":["Engagements"],"operationId":"engagements.participants.invite","summary":"Invite — Participant Link","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"locale":{"type":["string","null"],"maxLength":8}}}}}}}},"/engagements/{engagement}/participants/{participant}/links":{"get":{"tags":["Engagements"],"operationId":"engagements.participants.links.index","summary":"List — Participant Link","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Engagements"],"operationId":"engagements.participants.links.store","summary":"Create — Participant Link","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"purpose":{"enum":["interview","follow_up","recap_reminder"]},"expires_in_days":{"type":["integer","null"],"minimum":1,"maximum":365},"requires_email_code":{"type":["boolean","null"]},"chapter_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}}},"/engagements/{engagement}/participants/{participant}/links/{token}/revoke":{"post":{"tags":["Engagements"],"operationId":"engagements.participants.links.revoke","summary":"Revoke — Participant Link","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/participants/{participant}/messages":{"get":{"tags":["Engagements"],"operationId":"engagements.participants.messages","summary":"Messages — Participant","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/participants/{participant}/reinstate":{"post":{"tags":["Engagements"],"operationId":"engagements.participants.reinstate","summary":"Reinstate — Participant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/participants/{participant}/remind":{"post":{"tags":["Engagements"],"operationId":"engagements.participants.remind","summary":"Remind — Participant Link","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/participants/{participant}/revoke":{"post":{"tags":["Engagements"],"operationId":"engagements.participants.revoke","summary":"Revoke — Participant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"participant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/plan/{ownerType}/{ownerId}":{"get":{"tags":["Engagements"],"operationId":"engagements.plan.show","summary":"Get — Plan","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"put":{"tags":["Engagements"],"operationId":"engagements.plan.update","summary":"Update — Plan","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"chapters":{"type":"array","maxItems":30,"items":{"type":"object","properties":{"title":{"type":"string","maxLength":255},"topic_keys":{"type":"array","items":{"type":"string","maxLength":64}},"estimated_minutes":{"type":["integer","null"],"minimum":1,"maximum":240},"planned_session":{"type":["integer","null"],"minimum":1,"maximum":20},"origin":{"enum":["consultant","ai_proposal","ai_live","analysis"]}},"required":["title"]}}}}}}}}},"/engagements/{engagement}/plan/{ownerType}/{ownerId}/proposals/{proposalId}":{"get":{"tags":["Engagements"],"operationId":"engagements.plan.proposals.show","summary":"Proposal — Plan","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposalId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/plan/{ownerType}/{ownerId}/propose":{"post":{"tags":["Engagements"],"operationId":"engagements.plan.propose","summary":"Propose — Plan","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"locale":{"type":["string","null"],"maxLength":8},"target_minutes":{"type":["integer","null"],"minimum":10,"maximum":480},"notes":{"type":["string","null"],"maxLength":2000}}}}}}}},"/engagements/{engagement}/populations":{"get":{"tags":["Engagements"],"operationId":"engagements.populations.index","summary":"List — Population","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Engagements"],"operationId":"engagements.populations.store","summary":"Create — Population","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":5000},"expected_demonstrations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}}},"required":["name"]}}}}}},"/engagements/{engagement}/populations/reorder":{"post":{"tags":["Engagements"],"operationId":"engagements.populations.reorder","summary":"Reorder — Population","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","minItems":1,"items":{"type":"string","minLength":26,"maxLength":26}}},"required":["ids"]}}}}}},"/engagements/{engagement}/populations/{population}":{"patch":{"tags":["Engagements"],"operationId":"engagements.populations.update","summary":"Update — Population","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"population","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":5000},"expected_demonstrations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}}}}}}}},"delete":{"tags":["Engagements"],"operationId":"engagements.populations.destroy","summary":"Delete — Population","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"population","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/privacy/participants":{"get":{"tags":["Privacy"],"operationId":"privacy.engagements.participants","summary":"Participants — Privacy Engagement","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/processes":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.index","summary":"List — Process","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.store","summary":"Create — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":4000}},"required":["name"]}}}}}},"/engagements/{engagement}/processes/{process}":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.show","summary":"Get — Process","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.update","summary":"Update — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":4000}}}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.destroy","summary":"Delete — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/processes/{process}/actors":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.actors.store","summary":"Store Actor — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role_label":{"type":"string","maxLength":255},"population_id":{"type":["string","null"],"minLength":26,"maxLength":26}},"required":["role_label"]}}}}}},"/engagements/{engagement}/processes/{process}/actors/{actor}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.actors.update","summary":"Update Actor — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"actor","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role_label":{"type":"string","maxLength":255},"population_id":{"type":["string","null"],"minLength":26,"maxLength":26}},"required":["role_label"]}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.actors.destroy","summary":"Destroy Actor — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"actor","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/processes/{process}/flows":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.flows.store","summary":"Store Flow — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from_step_id":{"type":"string","minLength":26,"maxLength":26},"to_step_id":{"type":"string","minLength":26,"maxLength":26},"condition_label":{"type":["string","null"],"maxLength":255},"variant_id":{"type":["string","null"],"minLength":26,"maxLength":26}},"required":["from_step_id","to_step_id"]}}}}}},"/engagements/{engagement}/processes/{process}/flows/{flow}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.flows.update","summary":"Update Flow — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"flow","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"condition_label":{"type":["string","null"],"maxLength":255},"variant_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.flows.destroy","summary":"Destroy Flow — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"flow","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/processes/{process}/layout":{"put":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.layout","summary":"Layout — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"nodes":{"type":"array"},"edges":{"type":["array","null"]},"lanes":{"type":["string","null"],"enum":["none","actor","population"]},"manual":{"type":"array","items":{"type":"string"}}},"required":["nodes"]}}}}}},"/engagements/{engagement}/processes/{process}/merge":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.merge","summary":"Merge — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"into_process_id":{"type":"string","minLength":26,"maxLength":26}},"required":["into_process_id"]}}}}}},"/engagements/{engagement}/processes/{process}/review":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.review","summary":"Review — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"review_status":{"enum":["proposed","validated","rejected"]}},"required":["review_status"]}}}}}},"/engagements/{engagement}/processes/{process}/split":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.processes.split","summary":"Split — Process","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"step_ids":{"type":"array","minItems":1,"items":{"type":"string","minLength":26,"maxLength":26}},"new_name":{"type":"string","maxLength":255}},"required":["step_ids","new_name"]}}}}}},"/engagements/{engagement}/processes/{process}/steps":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.steps.store","summary":"Store Step — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":2000},"step_type":{"enum":["start","task","decision","wait","end"]},"position":{"type":["integer","null"],"minimum":1},"after_step_id":{"type":["string","null"],"minLength":26,"maxLength":26},"actor_id":{"type":["string","null"],"minLength":26,"maxLength":26},"actor_role":{"type":["string","null"],"maxLength":255},"tool_id":{"type":["string","null"],"minLength":26,"maxLength":26},"input_text":{"type":["string","null"],"maxLength":255},"output_text":{"type":["string","null"],"maxLength":255},"duration_estimate":{"type":["array","null"]},"volume_estimate":{"type":["array","null"]}},"required":["name"]}}}}}},"/engagements/{engagement}/processes/{process}/steps/{step}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.steps.update","summary":"Update Step — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":2000},"step_type":{"enum":["start","task","decision","wait","end"]},"position":{"type":"integer","minimum":1},"actor_id":{"type":["string","null"],"minLength":26,"maxLength":26},"actor_role":{"type":["string","null"],"maxLength":255},"tool_id":{"type":["string","null"],"minLength":26,"maxLength":26},"input_text":{"type":["string","null"],"maxLength":255},"output_text":{"type":["string","null"],"maxLength":255},"duration_estimate":{"type":["array","null"]},"volume_estimate":{"type":["array","null"]}}}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.steps.destroy","summary":"Destroy Step — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/processes/{process}/steps/{step}/evidences":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.steps.evidences","summary":"Step Evidences — Process Part","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"step","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/processes/{process}/variants":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.variants.store","summary":"Store Variant — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"condition_text":{"type":["string","null"],"maxLength":2000}},"required":["name"]}}}}}},"/engagements/{engagement}/processes/{process}/variants/{variant}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.variants.update","summary":"Update Variant — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"variant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"condition_text":{"type":["string","null"],"maxLength":2000}},"required":["name"]}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.variants.destroy","summary":"Destroy Variant — Process Part","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"process","in":"path","required":true,"schema":{"type":"string"}},{"name":"variant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/progress":{"get":{"tags":["Engagements"],"operationId":"engagements.progress","summary":"Progress — Engagement","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/raw-access-logs":{"get":{"tags":["Privacy"],"operationId":"privacy.engagements.raw-access-logs","summary":"For Engagement — Raw Access Log","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/reopen":{"post":{"tags":["Engagements"],"operationId":"engagements.reopen","summary":"Reopen — Engagement","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/retention":{"get":{"tags":["Privacy"],"operationId":"privacy.engagements.retention","summary":"Get — Retention","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/sponsors":{"get":{"tags":["Engagements"],"operationId":"engagements.sponsors.index","summary":"List — Sponsor","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Engagements"],"operationId":"engagements.sponsors.store","summary":"Create — Sponsor","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":255},"name":{"type":["string","null"],"maxLength":255},"locale":{"type":["string","null"],"maxLength":8}},"required":["email"]}}}}}},"/engagements/{engagement}/sponsors/{user}":{"delete":{"tags":["Engagements"],"operationId":"engagements.sponsors.destroy","summary":"Delete — Sponsor","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"user","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/test-interview":{"post":{"tags":["Engagements"],"operationId":"engagements.test-interview","summary":"Create — Test Interview","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"population_id":{"type":["string","null"],"minLength":26,"maxLength":26},"participant_id":{"type":["string","null"],"minLength":26,"maxLength":26}}}}}}}},"/engagements/{engagement}/tools":{"get":{"tags":["Analysis"],"operationId":"engagements.analysis.tools.index","summary":"List — Tool","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Analysis"],"operationId":"engagements.analysis.tools.store","summary":"Create — Tool","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"kind":{"enum":["software","spreadsheet","email","paper","messaging","other"]},"aliases":{"type":"array","items":{"type":"string","maxLength":255}}},"required":["name"]}}}}}},"/engagements/{engagement}/tools/{tool}":{"patch":{"tags":["Analysis"],"operationId":"engagements.analysis.tools.update","summary":"Update — Tool","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"tool","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"kind":{"enum":["software","spreadsheet","email","paper","messaging","other"]},"aliases":{"type":"array","items":{"type":"string","maxLength":255}}}}}}}},"delete":{"tags":["Analysis"],"operationId":"engagements.analysis.tools.destroy","summary":"Delete — Tool","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"tool","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/engagements/{engagement}/tools/{tool}/merge":{"post":{"tags":["Analysis"],"operationId":"engagements.analysis.tools.merge","summary":"Merge — Tool","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"engagement","in":"path","required":true,"schema":{"type":"string"}},{"name":"tool","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"into_tool_id":{"type":"string","minLength":26,"maxLength":26}},"required":["into_tool_id"]}}}}}},"/guide/{ownerType}/{ownerId}/effective":{"get":{"tags":["Methods"],"operationId":"guide.effective","summary":"Effective — Guide","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/guide/{ownerType}/{ownerId}/overrides/{topic}":{"put":{"tags":["Methods"],"operationId":"guide.overrides.put","summary":"Put Override — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"topic","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"enum":["modify","remove","make_optional","make_mandatory"]},"patch":{"type":["array","null"],"properties":{"title":{"type":"string","maxLength":255},"description":{"type":"string","maxLength":4000},"depth":{"enum":["overview","standard","deep"]},"opening_questions":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}},"information_targets":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string","maxLength":255}},"required":["key","label"]}},"demonstrations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}},"forbidden_subjects":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":255}}}}},"required":["operation"]}}}}},"delete":{"tags":["Methods"],"operationId":"guide.overrides.destroy","summary":"Destroy Override — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"topic","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/guide/{ownerType}/{ownerId}/proposals/{proposal}":{"get":{"tags":["Methods"],"operationId":"guide.proposals.show","summary":"Proposal — Guide","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/guide/{ownerType}/{ownerId}/proposals/{proposal}/accept":{"post":{"tags":["Methods"],"operationId":"guide.proposals.accept","summary":"Accept Proposal — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"proposal","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"keys":{"type":"array","minItems":1,"items":{"type":"string"}},"edits":{"type":"array","items":{"type":"array","properties":{"title":{"type":"string","maxLength":255},"requirement":{"enum":["mandatory","optional"]},"depth":{"enum":["overview","standard","deep"]}}}}},"required":["keys"]}}}}}},"/guide/{ownerType}/{ownerId}/propose-topics":{"post":{"tags":["Methods"],"operationId":"guide.propose-topics","summary":"Propose — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","minimum":3,"maximum":12},"focus":{"type":["string","null"],"maxLength":1000},"locale":{"type":["string","null"],"enum":["en","fr"]}}}}}}}},"/guide/{ownerType}/{ownerId}/topics":{"get":{"tags":["Methods"],"operationId":"guide.topics.index","summary":"List — Guide","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Methods"],"operationId":"guide.topics.store","summary":"Create — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":["string","null"]},"title":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":4000},"requirement":{"enum":["mandatory","optional"]},"depth":{"enum":["overview","standard","deep"]},"opening_questions":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}},"information_targets":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string","maxLength":255}},"required":["key","label"]}},"demonstrations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}},"forbidden_subjects":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":255}},"deliverable_category":{"type":["string","null"],"maxLength":64},"position":{"type":"integer","minimum":0}},"required":["title"]}}}}}},"/guide/{ownerType}/{ownerId}/topics/reorder":{"post":{"tags":["Methods"],"operationId":"guide.topics.reorder","summary":"Reorder — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"}}},"required":["ids"]}}}}}},"/guide/{ownerType}/{ownerId}/topics/{topic}":{"patch":{"tags":["Methods"],"operationId":"guide.topics.update","summary":"Update — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"topic","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":["string","null"]},"title":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":4000},"requirement":{"enum":["mandatory","optional"]},"depth":{"enum":["overview","standard","deep"]},"opening_questions":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}},"information_targets":{"type":"array","maxItems":20,"items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string","maxLength":255}},"required":["key","label"]}},"demonstrations":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":500}},"forbidden_subjects":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":255}},"deliverable_category":{"type":["string","null"],"maxLength":64},"position":{"type":"integer","minimum":0}}}}}}},"delete":{"tags":["Methods"],"operationId":"guide.topics.destroy","summary":"Delete — Guide","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"ownerType","in":"path","required":true,"schema":{"type":"string"}},{"name":"ownerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"topic","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/interviews/{interview}":{"get":{"tags":["Interviews"],"operationId":"interviews.show","summary":"Get — Interview","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"interview","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/interviews/{interview}/chapters":{"get":{"tags":["Interviews"],"operationId":"interviews.chapters","summary":"Chapters — Interview","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"interview","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/interviews/{interview}/chapters/{chapter}/recap":{"get":{"tags":["Interviews"],"operationId":"interviews.chapters.recap","summary":"Recap — Interview","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"interview","in":"path","required":true,"schema":{"type":"string"}},{"name":"chapter","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/interviews/{interview}/sources/{type}/{source}":{"get":{"tags":["Interviews"],"operationId":"interviews.sources.show","summary":"Source — Interview","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"interview","in":"path","required":true,"schema":{"type":"string"}},{"name":"type","in":"path","required":true,"schema":{"type":"string"}},{"name":"source","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/me":{"get":{"tags":["Workspaces"],"operationId":"me.show","summary":"Get — Me","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Workspaces"],"operationId":"me.update","summary":"Update — Me","security":[{"bearerAuth":["write"]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"locale":{"type":"string","enum":["en","fr"]}}}}}}}},"/media-thumbnails/{disk}/{path}":{"get":{"tags":["Interviews"],"operationId":"interviews.media.thumbnail","summary":"Thumbnail — Media","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"disk","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/media/{disk}/{path}":{"get":{"tags":["Interviews"],"operationId":"interviews.media","summary":"App\\ Http\\ Controllers\\ Api\\ V1\\ Interviews\\ Media Controller — Media","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"disk","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods":{"get":{"tags":["Methods"],"operationId":"methods.index","summary":"List — Method","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Methods"],"operationId":"methods.store","summary":"Create — Method","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":2000}},"required":["name"]}}}}}},"/methods/enums/avatar-presets":{"get":{"tags":["Methods"],"operationId":"methods.enums.avatar-presets","summary":"Avatar Presets — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/enums/{name}":{"get":{"tags":["Methods"],"operationId":"methods.enums.show","summary":"Get — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/from-template":{"post":{"tags":["Methods"],"operationId":"methods.from-template","summary":"Store From Template — Method","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"template_key":{"type":"string"},"name":{"type":["string","null"],"maxLength":255},"locale":{"type":["string","null"],"enum":["en","fr"]}},"required":["template_key"]}}}}}},"/methods/templates":{"get":{"tags":["Methods"],"operationId":"methods.templates.index","summary":"List — Method Template","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/{method}":{"get":{"tags":["Methods"],"operationId":"methods.show","summary":"Get — Method","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Methods"],"operationId":"methods.update","summary":"Update — Method","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"description":{"type":["string","null"],"maxLength":2000}},"required":["name"]}}}}},"delete":{"tags":["Methods"],"operationId":"methods.destroy","summary":"Delete — Method","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/{method}/duplicate":{"post":{"tags":["Methods"],"operationId":"methods.duplicate","summary":"Duplicate — Method","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/{method}/versions":{"get":{"tags":["Methods"],"operationId":"methods.versions.index","summary":"List — Method Version","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/{method}/versions/{version}":{"get":{"tags":["Methods"],"operationId":"methods.versions.show","summary":"Get — Method Version","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Methods"],"operationId":"methods.versions.update","summary":"Update — Method Version","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"objectives":{"type":["string","null"],"maxLength":10000},"interviewer_instructions":{"type":["string","null"],"maxLength":10000},"posture":{"type":"array","properties":{"register":{"type":"array","items":{"enum":["vous","tu","neutral"]}},"use_first_name":{"type":"boolean"},"formality":{"enum":["relaxed","standard","formal"]},"warmth":{"enum":["reserved","standard","warm"]},"probing":{"enum":["light","standard","insistent"]},"silence_threshold_ms":{"type":"integer","minimum":400,"maximum":5000},"allow_suggestions":{"type":"boolean"}}},"persona":{"type":"array","required":["name"],"properties":{"name":{"type":"string","maxLength":60},"avatar_preset":{"enum":["classic","short_hair","glasses","curly","bun","beard"]},"voice":{"type":["string","null"],"maxLength":128}}},"welcome_screen":{"type":"array","items":{"type":"array","properties":{"title":{"type":["string","null"],"maxLength":255},"intro":{"type":["string","null"],"maxLength":2000},"accept_label":{"type":["string","null"],"maxLength":255},"highlights":{"type":"array","maxItems":6,"items":{"type":["string","null"],"maxLength":300}},"blocks":{"type":"array","items":{"type":"object","properties":{"title":{"type":["string","null"],"maxLength":255},"body":{"type":["string","null"],"maxLength":4000}}},"properties":{"custom":{"type":"array","maxItems":6,"items":{"type":"object","properties":{"title":{"type":["string","null"],"maxLength":255},"body":{"type":["string","null"],"maxLength":4000}}}}}}}}},"deliverable_schema":{"type":"array","properties":{"sections":{"type":"array","items":{"type":"object","properties":{"key":{"enum":["summary","process_map","findings","contradictions","opportunities","recommendations","tools"]},"enabled":{"type":"boolean"}},"required":["key","enabled"]}},"finding_categories":{"type":"array","maxItems":30,"items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"array","items":{"type":["string","null"],"maxLength":255}},"description":{"type":"array","items":{"type":["string","null"],"maxLength":1000}}},"required":["key","label"]}},"opportunity_categories":{"type":"array","maxItems":30,"items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"array","items":{"type":["string","null"],"maxLength":255}},"description":{"type":"array","items":{"type":["string","null"],"maxLength":1000}}},"required":["key","label"]}},"priority_scale":{"type":"array","maxItems":6,"items":{"type":"object","properties":{"key":{"type":"string","maxLength":32},"label":{"type":"array","items":{"type":["string","null"],"maxLength":255}},"rule":{"type":"string","maxLength":255}},"required":["key","label","rule"]}}}}}}}}}}},"/methods/{method}/versions/{version}/draft":{"post":{"tags":["Methods"],"operationId":"methods.versions.draft","summary":"Draft — Method Version","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/methods/{method}/versions/{version}/persona/avatar":{"post":{"tags":["Methods"],"operationId":"methods.versions.avatar","summary":"Avatar — Method Version","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"avatar":{"type":"string","format":"binary","maxLength":2048}},"required":["avatar"]}}}}}},"/methods/{method}/versions/{version}/publish":{"post":{"tags":["Methods"],"operationId":"methods.versions.publish","summary":"Publish — Method Version","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"method","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/openapi.json":{"get":{"tags":["Integrations"],"operationId":"openapi","summary":"Get — Open Api","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/privacy/engagements":{"get":{"tags":["Privacy"],"operationId":"privacy.engagements","summary":"List — Privacy Engagement","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/privacy/enums/compliance-kinds":{"get":{"tags":["Privacy"],"operationId":"privacy.enums.compliance-kinds","summary":"Compliance Kinds — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/privacy/enums/deletion-statuses":{"get":{"tags":["Privacy"],"operationId":"privacy.enums.deletion-statuses","summary":"Deletion Statuses — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/privacy/enums/purge-kinds":{"get":{"tags":["Privacy"],"operationId":"privacy.enums.purge-kinds","summary":"Purge Kinds — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/privacy/enums/raw-resources":{"get":{"tags":["Privacy"],"operationId":"privacy.enums.raw-resources","summary":"Raw Resources — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}":{"get":{"tags":["Interviews"],"operationId":"sessions.show","summary":"Get — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/artifacts":{"get":{"tags":["Interviews"],"operationId":"sessions.artifacts","summary":"Artifacts — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/end":{"post":{"tags":["Interviews"],"operationId":"sessions.end","summary":"End — Session","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/frames":{"get":{"tags":["Interviews"],"operationId":"sessions.frames","summary":"Frames — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/frames/latest":{"get":{"tags":["Interviews"],"operationId":"sessions.frames.latest","summary":"Latest Frame — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/pins":{"get":{"tags":["Interviews"],"operationId":"sessions.pins","summary":"Pins — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/recordings/{recording}/stream":{"get":{"tags":["Interviews"],"operationId":"sessions.recordings.stream","summary":"Stream — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"name":"recording","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sessions/{session}/transcript":{"get":{"tags":["Interviews"],"operationId":"sessions.transcript","summary":"Transcript — Session","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"session","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/sources/schema/external-source/{version}":{"get":{"tags":["Sources"],"operationId":"sources.schema","summary":"Schema — External Source","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace":{"get":{"tags":["Workspaces"],"operationId":"workspace.show","summary":"Get — Workspace","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Workspaces"],"operationId":"workspace.update","summary":"Update — Workspace","security":[{"bearerAuth":["write"]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"display_name":{"type":"string","minLength":1,"maxLength":255},"locales":{"type":"array","minItems":1,"items":{"type":"string","enum":["en","fr"]}},"default_locale":{"type":"string","enum":["en","fr"]},"retention_raw_days":{"type":"integer","minimum":1,"maximum":3650},"retention_deliverable_days":{"type":"integer","minimum":1,"maximum":3650},"settings":{"type":"array","properties":{"require_2fa_for_consultants":{"type":"boolean"},"participant_email_code_default":{"type":"boolean"},"platform_keys_allowed":{"type":"boolean"}}}}}}}}}},"/workspace/branding":{"patch":{"tags":["Workspaces"],"operationId":"workspace.branding.update","summary":"Update — Workspace Branding","security":[{"bearerAuth":["write"]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"primary_color":{"type":["string","null"]},"accent_color":{"type":["string","null"]},"email_sender_name":{"type":"string","minLength":1,"maxLength":120}}}}}}}},"/workspace/branding/logo":{"post":{"tags":["Workspaces"],"operationId":"workspace.branding.logo","summary":"Store Logo — Workspace Branding","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"logo":{"type":"string","format":"binary","maxLength":1024},"dark":{"type":"boolean"}},"required":["logo"]}}}}},"delete":{"tags":["Workspaces"],"operationId":"workspace.branding.logo.destroy","summary":"Destroy Logo — Workspace Branding","security":[{"bearerAuth":["write"]}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/compliance-documents":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.compliance-documents.index","summary":"Workspace Index — Compliance Document","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Privacy"],"operationId":"privacy.workspace.compliance-documents.store","summary":"Workspace Store — Compliance Document","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"enum":["cse_note","dpia_template","processing_agreement","classification_note"]},"locale":{"type":"string","enum":["en","fr"]},"engagement_id":{"type":["string","null"],"minLength":26,"maxLength":26}},"required":["kind","locale"]}}}}}},"/workspace/dashboard":{"get":{"tags":["Workspaces"],"operationId":"workspace.dashboard","summary":"Get — Dashboard","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/deletion-requests":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.deletion-requests","summary":"Workspace Index — Deletion Request","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/invitations":{"get":{"tags":["Workspaces"],"operationId":"workspace.invitations.index","summary":"List — Invitation","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Workspaces"],"operationId":"workspace.invitations.store","summary":"Create — Invitation","security":[{"bearerAuth":["write"]}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":255},"role":{"enum":["admin","consultant"]}},"required":["email","role"]}}}}}},"/workspace/invitations/{invitation}":{"delete":{"tags":["Workspaces"],"operationId":"workspace.invitations.destroy","summary":"Delete — Invitation","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"invitation","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/members":{"get":{"tags":["Workspaces"],"operationId":"workspace.members.index","summary":"List — Member","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/members/{member}":{"patch":{"tags":["Workspaces"],"operationId":"workspace.members.update","summary":"Update — Member","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"member","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"enum":["admin","consultant"]}},"required":["role"]}}}}},"delete":{"tags":["Workspaces"],"operationId":"workspace.members.destroy","summary":"Delete — Member","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"member","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/message-templates":{"get":{"tags":["Engagements"],"operationId":"workspace.message-templates.index","summary":"Workspace Index — Message Template","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/message-templates/{kind}/{locale}":{"get":{"tags":["Engagements"],"operationId":"workspace.message-templates.show","summary":"Workspace Show — Message Template","security":[{"bearerAuth":["read"]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"put":{"tags":["Engagements"],"operationId":"workspace.message-templates.update","summary":"Workspace Update — Message Template","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string","maxLength":255},"body_markdown":{"type":"string","maxLength":20000}},"required":["subject","body_markdown"]}}}}},"delete":{"tags":["Engagements"],"operationId":"workspace.message-templates.destroy","summary":"Workspace Destroy — Message Template","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string"}},{"name":"locale","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/purge-runs":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.purge-runs","summary":"Runs — Retention","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/raw-access-logs":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.raw-access-logs","summary":"List — Raw Access Log","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/retention":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.retention","summary":"Overview — Retention","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/support-grants":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.support-grants.index","summary":"List — Support Grant","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/support-grants/operators":{"get":{"tags":["Privacy"],"operationId":"privacy.workspace.support-grants.operators","summary":"Operators — Support Grant","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/support-grants/{grant}":{"delete":{"tags":["Privacy"],"operationId":"privacy.workspace.support-grants.destroy","summary":"Delete — Support Grant","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"grant","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/alerts":{"get":{"tags":["Usage"],"operationId":"usage.alerts","summary":"Alerts — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/alerts/{alert}/acknowledge":{"post":{"tags":["Usage"],"operationId":"usage.alerts.acknowledge","summary":"Acknowledge — Usage","security":[{"bearerAuth":["write"]}],"parameters":[{"name":"alert","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Created (or 200/202 for actions and asynchronous jobs).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/budget":{"get":{"tags":["Usage"],"operationId":"usage.budget","summary":"Budget — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}},"put":{"tags":["Usage"],"operationId":"usage.budget.save","summary":"Save Budget — Usage","security":[{"bearerAuth":["write"]}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monthly_amount":{"type":"number","minimum":1,"maximum":1000000},"warning_ratio":{"type":"number","minimum":0,"maximum":0},"include_tests":{"type":"boolean"}},"required":["monthly_amount"]}}}}},"delete":{"tags":["Usage"],"operationId":"usage.budget.delete","summary":"Delete Budget — Usage","security":[{"bearerAuth":["write"]}],"responses":{"204":{"description":"Deleted."},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/dashboard":{"get":{"tags":["Usage"],"operationId":"usage.dashboard","summary":"Dashboard — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/entries":{"get":{"tags":["Usage"],"operationId":"usage.entries","summary":"Entries — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/export":{"get":{"tags":["Usage"],"operationId":"usage.export","summary":"Export — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/options":{"get":{"tags":["Usage"],"operationId":"usage.options","summary":"Options — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspace/usage/summary":{"get":{"tags":["Usage"],"operationId":"usage.summary","summary":"Summary — Usage","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspaces/enums/roles":{"get":{"tags":["Workspaces"],"operationId":"workspaces.enums.roles","summary":"Roles — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/workspaces/enums/statuses":{"get":{"tags":["Workspaces"],"operationId":"workspaces.enums.statuses","summary":"Statuses — Enum","security":[{"bearerAuth":["read"]}],"parameters":[{"$ref":"#/components/parameters/cursor"},{"$ref":"#/components/parameters/limit"}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"$ref":"#/components/responses/Unauthenticated"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/ValidationFailed"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal API token (`pat_…`, created in the web app) or OAuth 2.1 access token (authorization code + PKCE, see /.well-known/oauth-authorization-server). Scopes: `read` (GET only) or `write`."}},"parameters":{"cursor":{"name":"cursor","in":"query","required":false,"description":"Opaque cursor from `meta.next_cursor` (paginated lists only).","schema":{"type":"string"}},"limit":{"name":"limit","in":"query","required":false,"description":"Page size (paginated lists only).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}},"schemas":{"Envelope":{"type":"object","properties":{"data":{"description":"The resource, or a list of resources."},"meta":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"prev_cursor":{"type":["string","null"]},"limit":{"type":"integer"}}}}},"Error":{"type":"object","required":["code","message","details"],"properties":{"code":{"type":"string","description":"Stable error code, e.g. `engagement.not_launchable`."},"message":{"type":"string","description":"Translated message (Accept-Language)."},"details":{"type":"object"}}}},"responses":{"Unauthenticated":{"description":"Missing, invalid, revoked or expired token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The member role, the policy or the token scope does not allow this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Unknown resource, or outside this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ValidationFailed":{"description":"Invalid input (`validation.failed`, `details.errors`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Too many requests for this token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}