{"version":1,"digest":"efc8c6161e240a0e8533f918ae27398550e35c949a0563f21f961eefd76292dc","basePath":"/api/foundations","availability":{"databaseBinding":true,"fileBinding":true,"imageBinding":true,"feedbackConfigured":true,"integratedWebsite":true},"instructions":"/instructions","instructionsMarkdown":"/instructions?format=markdown","catalogue":"/catalogue","validation":"Generated input shapes. Server refinements, registered-property checks, authorization, current revisions and domain invariants remain mandatory; see /instructions.","limits":{"jsonBytes":65536,"assetBytes":10485760,"relatedScopes":20,"readRowsPerFamilyPerPage":100,"readScopes":1000,"validationGraphBytes":8388608,"retentionDays":30,"feedback":{"perHour":20,"perDay":100,"reviewPerHour":60,"pageSize":20,"bodyBytes":32768}},"operations":[{"name":"submitFeedback","method":"POST","path":"/feedback","access":"human or feedback grant; configured maintainer queue","schema":"/contract/submitFeedback"},{"name":"reviewFeedback","method":"POST","path":"/feedback-review/{feedbackId}","access":"configured human maintainer only","schema":"/contract/reviewFeedback"},{"name":"startAgentAuthorization","method":"POST","path":"/oauth/device_authorization","access":"public; starts a pending request only","contentType":"application/x-www-form-urlencoded","schema":"/contract/startAgentAuthorization"},{"name":"collectAgentCredential","method":"POST","path":"/oauth/token","access":"requesting device secret; prior human approval","contentType":"application/x-www-form-urlencoded","schema":"/contract/collectAgentCredential"},{"name":"decideAgentAuthorization","method":"POST","path":"/agent-connections/decision","access":"human; same-origin browser","schema":"/contract/decideAgentAuthorization"},{"name":"cancelAgentApproval","method":"POST","path":"/agent-connections/cancel","access":"human; own pending approval","schema":"/contract/cancelAgentApproval"},{"name":"createTrip","method":"POST","path":"/trips","access":"create_trip","schema":"/contract/createTrip"},{"name":"setWaypoints","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setWaypoints"},{"name":"setRelatedPlace","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setRelatedPlace"},{"name":"setAccommodation","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setAccommodation"},{"name":"describePlace","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/describePlace"},{"name":"linkPersonToSelf","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/linkPersonToSelf"},{"name":"editDestination","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/editDestination"},{"name":"editDay","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/editDay"},{"name":"setExperiencePresentation","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setExperiencePresentation"},{"name":"setParent","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setParent"},{"name":"assignStayNight","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/assignStayNight"},{"name":"setMapOverview","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setMapOverview"},{"name":"setSubject","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setSubject"},{"name":"setChoice","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setChoice"},{"name":"setRating","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setRating"},{"name":"setBooking","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setBooking"},{"name":"setMoney","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setMoney"},{"name":"setNote","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setNote"},{"name":"setAnnotation","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setAnnotation"},{"name":"setResourceLink","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setResourceLink"},{"name":"setLocation","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setLocation"},{"name":"addEvidence","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/addEvidence"},{"name":"linkEvidence","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/linkEvidence"},{"name":"proposeFact","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/proposeFact"},{"name":"resolveProposal","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/resolveProposal"},{"name":"askClarification","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/askClarification"},{"name":"answerClarification","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/answerClarification"},{"name":"placePhoto","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/placePhoto"},{"name":"selectPhoto","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/selectPhoto"},{"name":"setPlanningWindow","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setPlanningWindow"},{"name":"setDuration","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setDuration"},{"name":"createPlace","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/createPlace"},{"name":"createPerson","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/createPerson"},{"name":"editPlace","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/editPlace"},{"name":"editPerson","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/editPerson"},{"name":"createDestination","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/createDestination"},{"name":"createDay","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/createDay"},{"name":"createExperience","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/createExperience"},{"name":"editExperience","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/editExperience"},{"name":"setMovement","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setMovement"},{"name":"clearStructure","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/clearStructure"},{"name":"setVenue","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setVenue"},{"name":"setSchedule","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setSchedule"},{"name":"setJourney","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setJourney"},{"name":"setParticipation","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/setParticipation"},{"name":"placeExperience","method":"POST","path":"/trips/{tripId}","access":"edit","schema":"/contract/placeExperience"},{"name":"editTrip","method":"POST","path":"/trips/{tripId}/metadata","access":"edit; trip owner","schema":"/contract/editTrip"},{"name":"stageAsset","method":"POST","path":"/assets","access":"upload","schema":"/contract/stageAsset"},{"name":"createDerivative","method":"POST","path":"/assets/{assetId}/derivatives","access":"read and upload; current scope edit rights","schema":"/contract/createDerivative"},{"name":"recoverContent","method":"POST","path":"/trips/{tripId}/recovery","access":"delete or restore; current edit rights","schema":"/contract/recoverContent"},{"name":"restoreTripMetadata","method":"POST","path":"/trips/{tripId}/restore-metadata","access":"restore; trip owner","schema":"/contract/restoreTripMetadata"},{"name":"tripLifecycle","method":"POST","path":"/trips/{tripId}/lifecycle","access":"delete or restore; trip owner","schema":"/contract/tripLifecycle"},{"name":"assetLifecycle","method":"POST","path":"/assets/{assetId}/lifecycle","access":"delete or restore","schema":"/contract/assetLifecycle"},{"name":"preparePublication","method":"POST","path":"/trips/{tripId}/prepare-publication","access":"trip owner; human or allowPublishing connection with current source read access","schema":"/contract/preparePublication"},{"name":"activatePublication","method":"POST","path":"/trips/{tripId}/publish","access":"trip owner; human or allowPublishing connection with current candidate scope access","schema":"/contract/activatePublication"},{"name":"unpublish","method":"POST","path":"/trips/{tripId}/unpublish","access":"trip owner; human or allowPublishing connection with current trip/edition scope access","schema":"/contract/unpublish"},{"name":"issueDelegation","method":"POST","path":"/delegations","access":"human","schema":"/contract/issueDelegation"},{"name":"revokeDelegation","method":"POST","path":"/delegations/revoke","access":"human","schema":"/contract/revokeDelegation"},{"name":"updateDelegation","method":"POST","path":"/delegations/update","access":"human; active owned connection; revision guard","schema":"/contract/updateDelegation"},{"name":"manageCollaboration","method":"POST","path":"/trips/{tripId}/collaboration","access":"human","schema":"/contract/manageCollaboration"},{"name":"acceptInvitation","method":"POST","path":"/invitations/accept","access":"human recipient","schema":"/contract/acceptInvitation"},{"name":"updateCollection","method":"POST","path":"/collections","access":"human or collections + edit; private targets also require read and current scope access; setProfile human-only","schema":"/contract/updateCollection"},{"name":"setPublicationConsent","method":"POST","path":"/publication-consent","access":"human material owner","schema":"/contract/setPublicationConsent"},{"name":"purgeRecord","method":"POST","path":"/trips/{tripId}/purge","access":"human material owner","schema":"/contract/purgeRecord"}],"reads":[{"method":"GET","path":"/feedback?status=…&cursor=…","access":"human or feedback grant; own account reports"},{"method":"GET","path":"/feedback/{feedbackId}?beforeRevision=…","access":"same feedback visibility; paginated review history"},{"method":"GET","path":"/feedback-review?status=…&cursor=…","access":"configured human maintainer only"},{"method":"GET","path":"/feedback-review/{feedbackId}?beforeRevision=…","access":"configured human maintainer only; paginated review history"},{"method":"GET","path":"/account","access":"human or bearer; bearer sees only its own current safe connection permissions"},{"method":"GET","path":"/trips?cursor=…","access":"read"},{"method":"GET","path":"/trips/{tripId}?cursor=…","access":"read; append record families until nextCursor is null"},{"method":"GET","path":"/trips/{tripId}/history?scopeId=…&cursor=…","access":"read"},{"method":"GET","path":"/trips/{tripId}/recycle-bin?scopeId=…&cursor=…","access":"read"},{"method":"GET","path":"/recycle-bin?cursor=…","access":"owned trips; read"},{"method":"GET","path":"/trips/{tripId}/custody?cursor=…","access":"own material; read; paginated"},{"method":"GET","path":"/assets/{assetId}","access":"read; private attachment"},{"method":"GET","path":"/assets/{assetId}/preview?size=card|display","access":"read; private image preview; imageBinding required; no-store"},{"method":"GET","path":"/delegations?cursor=…","access":"human; paginated"},{"method":"GET","path":"/agent-connections/request?user_code=…","access":"human"},{"method":"GET","path":"/agent-connections/scopes?cursor=…","access":"human; paginated"},{"method":"GET","path":"/agent-connections/pending?cursor=…","access":"human; own uncollected approvals"},{"method":"GET","path":"/collections","access":"human or collections + read; private trip references filtered by current scope access"},{"method":"GET","path":"/collections/profile","access":"human or collections + read; own profile"},{"method":"GET","path":"/collections/status?tripIds=…&userIds=…","access":"human or collections + read; at most 20 distinct IDs per family; public eligibility only"},{"method":"GET","path":"/collections/trips?view=bookmarked|following&q=…&sort=…&cursor=…","access":"human or collections + read; currently public cards only"},{"method":"GET","path":"/collections/people?cursor=…","access":"human or collections + read; discoverable followed profiles"},{"method":"GET","path":"/trips/{tripId}/collaboration","access":"human"},{"method":"GET","path":"/publication-consent/{scopeId}","access":"human material owner"},{"method":"GET","path":"/profiles?cursor=…","access":"public"},{"method":"GET","path":"/profiles/{username}","access":"public"},{"method":"GET","path":"/public/trips?q=…&sort=title|shortest|longest&username=…&cursor=…","access":"public; sealed card metadata, query-bound pages of 20"},{"method":"GET","path":"/public/trips/{idOrSlug}","access":"public"},{"method":"GET","path":"/public/editions/{editionId}/media/{derivativeId}","access":"public; current edition gate"},{"method":"GET","path":"/trips/{tripId}/publication","access":"trip owner; human or allowPublishing connection; current status, eligible preparation inputs and explicit photo blockers"},{"method":"GET","path":"/trips/{tripId}/prepared/{editionId}","access":"trip owner; human or allowPublishing connection; all candidate scopes currently readable; current candidate only"},{"method":"GET","path":"/trips/{tripId}/prepared/{editionId}/media/{derivativeId}","access":"trip owner; human or allowPublishing connection; all candidate scopes currently readable; current candidate only"}],"upload":{"method":"PUT","path":"/assets/{assetId}","access":"upload; current scope edit rights","body":"exact reserved bytes","headers":["Authorization","Content-Type","Idempotency-Key","X-Scope-Revision"]},"publicDocumentSchema":"/contract/publicDocument"}