Name of the agent doing the writing (e.g. 'sales-research-bot'). Becomes the connector the items land under (custom:mcp-). Omit for OAuth MCP clients — their client type is used.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Adapter","colors":{"primary":"#8765F0","light":"#8765F0","dark":"#8765F0"},"logo":{"light":"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/logo/light.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=459bd6410eb825d264414176cd7eba07","dark":"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/logo/dark.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=0bed0f3d3311b99106ba98e43a63d5e2"},"favicon":"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/favicon.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=83406b22c16edb6994e5b28b146a7446","api":{"openapi":"api-reference/openapi.json","playground":{}},"background":{"color":{"light":"#F2F2F0","dark":"#171717"}},"navbar":{"links":[{"href":"mailto:support@adapter.com","label":"Support"}],"primary":{"type":"button","label":"Sign In","href":"https://mind.adapter.com"}},"footer":{"socials":{"x":"https://x.com/adapter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adapter","hasAudioNarration":false,"actualSubdomain":"adapter","customDomains":["docs.beta.adapter.com"],"gitSource":{"type":"github","owner":"adapter-group","repo":"adapter-platform","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec51a807f9eeebb29390ba","collectionId":"33ac3ffe-6006-447c-b555-ea6ea8b7bcae","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec51a807f9eeebb29390ba"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec51a807f9eeebb29390ba","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Reference","count":40},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Knowledge","count":11},{"language":"default","tag":"Triggers","count":10},{"language":"default","tag":"Core Concepts","count":7},{"language":"default","tag":"Ingestion","count":6},{"language":"default","tag":"Custom Connectors","count":5},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Connectors","count":3},{"language":"default","tag":"Data","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/writeback/write-back","slug":"/api-reference/writeback/write-back","pageMetadata":{"title":"Write agent output back into the workspace","openapi":"POST /v1/writeback","description":null,"href":"/api-reference/writeback/write-back"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Write agent output back into the workspace","openapi":"POST /v1/writeback","description":null,"href":"/api-reference/writeback/write-back"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["writeback"],"summary":"Write agent output back into the workspace","operationId":"write_back","requestBody":"14fa6379-5856-4801-b506-6b64f2b67584","responses":{"200":"b0c84b19-4eff-44b2-a095-77cd52adfa7a","402":"ca885707-f3b0-4a6e-a157-9e66bc0d6646","422":"225ca981-11bd-4b7f-a242-3a259ec1a3e3","429":"a26a3d8a-4dfb-400a-82c4-9438229e14ca"},"method":"post","type":"path","servers":["b45a6dfc-eec4-42ae-a72a-9361a1098054"],"security":[],"path":"/v1/writeback","baseUrlOptions":["http://localhost:8080"],"title":"Write agent output back into the workspace","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"properties":{"kind":{"type":"string","enum":["note","decision","summary","task_outcome","fact","document"],"title":"Kind","description":"What this is; see KIND_GUIDE / the tool docs.","examples":["decision"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"title":{"type":"string","maxLength":300,"minLength":1,"title":"Title","description":"Short, specific headline.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].title","typeLabel":"string"},"content":{"type":"string","maxLength":200000,"minLength":1,"title":"Content","description":"The body. Markdown is fine.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].content","typeLabel":"string"},"external_id":{"oneOf":[{"type":"string","title":"External Id","description":"Stable id to update the same item later. Omit for a new item (one is minted).","maxLength":200,"uniqueKey":"\\items.items.[INDEX].external_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"External Id","description":"Stable id to update the same item later. Omit for a new item (one is minted).","uniqueKey":"\\items.items.[INDEX].external_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].external_id","typeLabel":"string | null"},"timestamp":{"oneOf":[{"type":"string","title":"Timestamp","description":"When it happened (ISO 8601). Defaults to now.","format":"date-time","uniqueKey":"\\items.items.[INDEX].timestamp.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Timestamp","description":"When it happened (ISO 8601). Defaults to now.","uniqueKey":"\\items.items.[INDEX].timestamp.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].timestamp","typeLabel":"string\u003cdate-time> | null"},"related_urns":{"items":{"type":"string","uniqueKey":"\\items.items.[INDEX].related_urns.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":50,"title":"Related Urns","description":"Adapter urns this was derived from (search_knowledge hits, trigger deliveries).","uniqueKey":"\\items.items.[INDEX].related_urns","typeLabel":"string[]"},"tags":{"items":{"type":"string","uniqueKey":"\\items.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"type":"array","maxItems":20,"title":"Tags","description":"Free-form labels.","uniqueKey":"\\items.items.[INDEX].tags","typeLabel":"string[]"},"metadata":{"oneOf":[{"type":"object","title":"Metadata","description":"Extra string key/values for filtering.","additionalProperties":{"type":"string","uniqueKey":"\\items.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"string"},"uniqueKey":"\\items.items.[INDEX].metadata.oneOf.0","typeLabel":"Metadata · object"},{"type":"null","title":"Metadata","description":"Extra string key/values for filtering.","uniqueKey":"\\items.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].metadata","typeLabel":"Metadata · object | null"}},"type":"object","required":["kind","title","content"],"title":"WritebackItem","uniqueKey":"\\items.items.[INDEX]","typeLabel":"WritebackItem · object"},"type":"array","maxItems":100,"minItems":1,"title":"Items","isRequired":true,"uniqueKey":"\\items","typeLabel":"WritebackItem · object[]"},"agent":{"oneOf":[{"type":"string","title":"Agent","description":"Name of the agent doing the writing (e.g. 'sales-research-bot'). Becomes the connector the items land under (custom:mcp-\u003cagent>). Omit for OAuth MCP clients — their client type is used.","maxLength":60,"uniqueKey":"agent.oneOf.0","typeLabel":"string"},{"type":"null","title":"Agent","description":"Name of the agent doing the writing (e.g. 'sales-research-bot'). Becomes the connector the items land under (custom:mcp-\u003cagent>). Omit for OAuth MCP clients — their client type is used.","uniqueKey":"agent.oneOf.1","typeLabel":"null"}],"uniqueKey":"agent","typeLabel":"string | null"},"force":{"type":"boolean","title":"Force","description":"Re-publish items whose content is unchanged.","default":false,"uniqueKey":"force","typeLabel":"boolean"}},"type":"object","required":["items"],"title":"WritebackRequest","uniqueKey":"","typeLabel":"WritebackRequest · object"},"examples":{"Example":{"title":"Example","value":{"items":[{"kind":"decision","title":"\u003cstring>","content":"\u003cstring>","external_id":"\u003cstring>","timestamp":"2023-11-07T05:31:56Z","related_urns":["\u003cstring>"],"tags":["\u003cstring>"],"metadata":{}}],"agent":"\u003cstring>","force":false}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"b0c84b19-4eff-44b2-a095-77cd52adfa7a":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"connector_id":{"type":"string","title":"Connector Id","isRequired":true,"uniqueKey":"connector_id","typeLabel":"string"},"source":{"type":"string","title":"Source","isRequired":true,"uniqueKey":"source","typeLabel":"string"},"agent":{"type":"string","title":"Agent","isRequired":true,"uniqueKey":"agent","typeLabel":"string"},"items":{"items":{"properties":{"external_id":{"type":"string","title":"External Id","isRequired":true,"uniqueKey":"\\items.items.[INDEX].external_id","typeLabel":"string"},"status":{"type":"string","enum":["saved","unchanged","rejected"],"title":"Status","isRequired":true,"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"reason":{"oneOf":[{"type":"string","title":"Reason","uniqueKey":"\\items.items.[INDEX].reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Reason","uniqueKey":"\\items.items.[INDEX].reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].reason","typeLabel":"string | null"}},"type":"object","required":["external_id","status"],"title":"WritebackResultItem","uniqueKey":"\\items.items.[INDEX]","typeLabel":"WritebackResultItem · object"},"type":"array","title":"Items","isRequired":true,"uniqueKey":"\\items","typeLabel":"WritebackResultItem · object[]"}},"type":"object","required":["connector_id","source","agent","items"],"title":"WritebackResponse","uniqueKey":"","typeLabel":"WritebackResponse · object"},"examples":{"Example":{"title":"Example","value":{"connector_id":"\u003cstring>","source":"\u003cstring>","agent":"\u003cstring>","items":[{"external_id":"\u003cstring>","status":"saved","reason":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"ca885707-f3b0-4a6e-a157-9e66bc0d6646":{"description":"Ingest fully rejected — the workspace is over a tier quota (the object limit or the per-document size). Partial batches instead return 200 with a `rejected` list. Not transient, and deleting data doesn't give back object headroom; upgrade rather than retry.","content":{"application/json":{"schema":{"properties":{"error_code":{"type":"string","const":"quota_exceeded","title":"Error Code","default":"quota_exceeded","uniqueKey":"error_code","typeLabel":"string"},"message":{"type":"string","title":"Message","default":"Ingest rejected: this workspace is over its plan quota.","uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","description":"Carries `rejected`: the refused items as `{external_id, resource, reason}` (resource ∈ documents/doc_size).","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","description":"Carries `rejected`: the refused items as `{external_id, resource, reason}` (resource ∈ documents/doc_size).","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"type":"object","title":"QuotaExceededErrorModel","uniqueKey":"","typeLabel":"QuotaExceededErrorModel · object"},"examples":{"Example":{"title":"Example","value":{"error_code":"quota_exceeded","message":"Ingest rejected: this workspace is over its plan quota.","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"225ca981-11bd-4b7f-a242-3a259ec1a3e3":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a26a3d8a-4dfb-400a-82c4-9438229e14ca":{"description":"Rate limit exceeded for the caller's tier. RFC 9457 problem+json body; IETF RateLimit-* headers and Retry-After are set.","headers":{"Retry-After":{"description":"Seconds to wait before retrying (RFC 9110).","schema":{"type":"integer"}},"RateLimit-Limit":{"description":"Requests allowed per window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Delta-seconds until the window resets.","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"Active policy, e.g. '5;w=60'.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"properties":{"type":{"type":"string","title":"Type","description":"Stable problem-type URI, e.g. '{api_base_url}/errors/rate_limit_exceeded'.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"type":"string","title":"Detail","description":"Human-readable explanation, including the retry hint.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"endpoint":{"type":"string","title":"Endpoint","description":"Logical endpoint the limit applies to (e.g. 'ask', 'search').","isRequired":true,"uniqueKey":"endpoint","typeLabel":"string"},"tier":{"type":"string","title":"Tier","description":"The caller's billing tier (e.g. 'flex').","isRequired":true,"uniqueKey":"tier","typeLabel":"string"},"limit":{"type":"integer","title":"Limit","description":"Requests allowed per window for this tier + endpoint.","isRequired":true,"uniqueKey":"limit","typeLabel":"integer"},"remaining":{"type":"integer","title":"Remaining","description":"Requests remaining in the current window (0 when blocked).","isRequired":true,"uniqueKey":"remaining","typeLabel":"integer"},"window_seconds":{"type":"integer","title":"Window Seconds","description":"Length of the fixed rate-limit window, in seconds.","isRequired":true,"uniqueKey":"window_seconds","typeLabel":"integer"},"retry_after":{"type":"integer","title":"Retry After","description":"Seconds to wait before retrying (mirrors the Retry-After header).","isRequired":true,"uniqueKey":"retry_after","typeLabel":"integer"},"title":{"type":"string","const":"Too Many Requests","title":"Title","default":"Too Many Requests","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","const":429,"title":"Status","default":429,"uniqueKey":"status","typeLabel":"integer"},"error_code":{"type":"string","const":"rate_limit_exceeded","title":"Error Code","default":"rate_limit_exceeded","uniqueKey":"error_code","typeLabel":"string"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"The request path that was limited.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"The request path that was limited.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"type":"object","required":["type","detail","endpoint","tier","limit","remaining","window_seconds","retry_after"],"title":"RateLimitProblemDetail","description":"The 429 response body, exactly as ``RateLimitError.problem_detail`` renders it —\nRFC 9457 Problem Details, served as ``application/problem+json`` alongside the IETF\n``RateLimit-*`` headers and ``Retry-After``. (Distinct from the legacy\n``RateLimitErrorModel`` shape, which does not match what the handler emits.)","uniqueKey":"","typeLabel":"RateLimitProblemDetail · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","detail":"\u003cstring>","endpoint":"\u003cstring>","tier":"\u003cstring>","limit":123,"remaining":123,"window_seconds":123,"retry_after":123,"title":"Too Many Requests","status":429,"error_code":"rate_limit_exceeded","instance":"\u003cstring>"}}},"exampleType":"generated"},"application/json":{"schema":{"properties":{"type":{"type":"string","title":"Type","description":"Stable problem-type URI, e.g. '{api_base_url}/errors/rate_limit_exceeded'.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"type":"string","title":"Detail","description":"Human-readable explanation, including the retry hint.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"endpoint":{"type":"string","title":"Endpoint","description":"Logical endpoint the limit applies to (e.g. 'ask', 'search').","isRequired":true,"uniqueKey":"endpoint","typeLabel":"string"},"tier":{"type":"string","title":"Tier","description":"The caller's billing tier (e.g. 'flex').","isRequired":true,"uniqueKey":"tier","typeLabel":"string"},"limit":{"type":"integer","title":"Limit","description":"Requests allowed per window for this tier + endpoint.","isRequired":true,"uniqueKey":"limit","typeLabel":"integer"},"remaining":{"type":"integer","title":"Remaining","description":"Requests remaining in the current window (0 when blocked).","isRequired":true,"uniqueKey":"remaining","typeLabel":"integer"},"window_seconds":{"type":"integer","title":"Window Seconds","description":"Length of the fixed rate-limit window, in seconds.","isRequired":true,"uniqueKey":"window_seconds","typeLabel":"integer"},"retry_after":{"type":"integer","title":"Retry After","description":"Seconds to wait before retrying (mirrors the Retry-After header).","isRequired":true,"uniqueKey":"retry_after","typeLabel":"integer"},"title":{"type":"string","const":"Too Many Requests","title":"Title","default":"Too Many Requests","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","const":429,"title":"Status","default":429,"uniqueKey":"status","typeLabel":"integer"},"error_code":{"type":"string","const":"rate_limit_exceeded","title":"Error Code","default":"rate_limit_exceeded","uniqueKey":"error_code","typeLabel":"string"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"The request path that was limited.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"The request path that was limited.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"type":"object","required":["type","detail","endpoint","tier","limit","remaining","window_seconds","retry_after"],"title":"RateLimitProblemDetail","description":"The 429 response body, exactly as ``RateLimitError.problem_detail`` renders it —\nRFC 9457 Problem Details, served as ``application/problem+json`` alongside the IETF\n``RateLimit-*`` headers and ``Retry-After``. (Distinct from the legacy\n``RateLimitErrorModel`` shape, which does not match what the handler emits.)","uniqueKey":"","typeLabel":"RateLimitProblemDetail · object"},"examples":{"Example":{"title":"Example","value":{"type":"\u003cstring>","detail":"\u003cstring>","endpoint":"\u003cstring>","tier":"\u003cstring>","limit":123,"remaining":123,"window_seconds":123,"retry_after":123,"title":"Too Many Requests","status":429,"error_code":"rate_limit_exceeded","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"b45a6dfc-eec4-42ae-a72a-9361a1098054":{"url":"http://localhost:8080"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"adapter","siteName":"Adapter","title":"Write agent output back into the workspace - Adapter","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T19:26:56.132Z","originalFileLocation":"api-reference/writeback/write-back.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Adapter\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Write agent output back into the workspace - Adapter\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Adapter\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.beta.adapter.com/api-reference/writeback/write-back\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adapter.mintlify.site/_mintlify/api/og/v2?division=Writeback\u0026amp;title=Write+agent+output+back+into+the+workspace\u0026amp;theme=172df802757f1536c21dc595\u0026amp;signature=7f5ab14881b1f4744cfd7fd326866ebaaa954dd3e60cbfc283b3c396a2f91d84\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Write agent output back into the workspace - Adapter\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adapter.mintlify.site/_mintlify/api/og/v2?division=Writeback\u0026amp;title=Write+agent+output+back+into+the+workspace\u0026amp;theme=172df802757f1536c21dc595\u0026amp;signature=7f5ab14881b1f4744cfd7fd326866ebaaa954dd3e60cbfc283b3c396a2f91d84\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/adapter/QFVp-gltrPnIPgdk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Adapter\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8765F0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.beta.adapter.com/api-reference/writeback/write-back\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/writeback/write-back.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.beta.adapter.com/#organization\",\"name\":\"Adapter\",\"url\":\"https://docs.beta.adapter.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/adapter/J3Ydy4fSe61BUDTE/logo/light.svg?fit=max\u0026auto=format\u0026n=J3Ydy4fSe61BUDTE\u0026q=85\u0026s=459bd6410eb825d264414176cd7eba07\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.beta.adapter.com#website\",\"name\":\"Adapter\",\"url\":\"https://docs.beta.adapter.com\",\"publisher\":{\"@id\":\"https://docs.beta.adapter.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back#webpage\",\"url\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back\",\"name\":\"Write agent output back into the workspace\",\"dateModified\":\"2026-10-27T19:26:56.132Z\",\"isPartOf\":{\"@id\":\"https://docs.beta.adapter.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Adapter\",\"item\":\"https://docs.beta.adapter.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Write agent output back into the workspace\",\"item\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back#apireference\",\"headline\":\"Write agent output back into the workspace\",\"name\":\"Write agent output back into the workspace\",\"url\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back\",\"mainEntityOfPage\":{\"@id\":\"https://docs.beta.adapter.com/api-reference/writeback/write-back#webpage\"},\"dateModified\":\"2026-10-27T19:26:56.132Z\",\"publisher\":{\"@id\":\"https://docs.beta.adapter.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.beta.adapter.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Adapter\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Adapter","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/getting-started/mcp"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Overview","href":"/api-reference/introduction"}]},{"group":"Connectors","expanded":false,"pages":[{"title":"List Connections","openapi":"GET /v1/connections","href":"/api-reference/connectors/list-connections"},{"title":"Get Connection","openapi":"GET /v1/connections/{connection_id}","href":"/api-reference/connectors/get-connection"},{"title":"List Resource Facets","openapi":"GET /v1/connections/{connection_id}/resources/{resource}/facets/{facet_name}","href":"/api-reference/connectors/list-resource-facets"}]},{"group":"Custom Connectors","expanded":false,"pages":[{"title":"List custom connectors","openapi":"GET /v1/custom-connectors","href":"/api-reference/custom-connectors/list-custom-connectors"},{"title":"Create a custom connector","openapi":"POST /v1/custom-connectors","href":"/api-reference/custom-connectors/create-custom-connector"},{"title":"Get a custom connector","openapi":"GET /v1/custom-connectors/{connector_id}","href":"/api-reference/custom-connectors/get-custom-connector"},{"title":"Update a custom connector","openapi":"PATCH /v1/custom-connectors/{connector_id}","href":"/api-reference/custom-connectors/update-custom-connector"},{"title":"Deactivate a custom connector","openapi":"DELETE /v1/custom-connectors/{connector_id}","href":"/api-reference/custom-connectors/delete-custom-connector"}]},{"group":"Data","expanded":false,"pages":[{"title":"Download Document Raw","openapi":"GET /v1/data/{connection_id}/{resource}/raw/{external_id}","href":"/api-reference/data/download-document-raw"},{"title":"Get Document Detail","openapi":"GET /v1/data/{connection_id}/{resource}/{external_id}","href":"/api-reference/data/get-document-detail"}]},{"group":"Documents","expanded":false,"pages":[{"title":"Get Document By Urn","openapi":"GET /v1/documents/{urn}","href":"/api-reference/documents/get-document-by-urn"},{"title":"Download Document By Urn","openapi":"GET /v1/documents/{urn}/raw","href":"/api-reference/documents/download-document-by-urn"}]},{"group":"Ingestion","expanded":false,"pages":[{"title":"Ingest generic JSON events","openapi":"POST /v1/custom-connectors/{connector_id}/ingest","href":"/api-reference/ingestion/ingest-custom"},{"title":"Upload a binary as a generic event","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/upload","href":"/api-reference/ingestion/ingest-custom-upload"},{"title":"Start a presigned video upload","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/video/upload-url","href":"/api-reference/ingestion/ingest-video-upload-url"},{"title":"Finalize a presigned video upload","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/video/complete","href":"/api-reference/ingestion/ingest-video-complete"},{"title":"Ingest typed first-party events","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/typed","href":"/api-reference/ingestion/ingest-typed"},{"title":"Upload a binary as a typed event","openapi":"POST /v1/custom-connectors/{connector_id}/ingest/typed/upload","href":"/api-reference/ingestion/ingest-typed-upload"}]},{"group":"Knowledge","expanded":false,"pages":[{"title":"Search","openapi":"POST /v1/knowledge/search","href":"/api-reference/knowledge/search"},{"title":"Ask","openapi":"POST /v1/knowledge/ask","href":"/api-reference/knowledge/ask"},{"title":"Ask Stream","openapi":"POST /v1/knowledge/ask/stream","href":"/api-reference/knowledge/ask-stream"},{"title":"List Ask Jobs","openapi":"GET /v1/knowledge/ask/jobs","href":"/api-reference/knowledge/list-ask-jobs"},{"title":"Create Ask Job","openapi":"POST /v1/knowledge/ask/jobs","href":"/api-reference/knowledge/create-ask-job"},{"title":"Get Ask Job","openapi":"GET /v1/knowledge/ask/jobs/{job_id}","href":"/api-reference/knowledge/get-ask-job"},{"title":"Get Entity","openapi":"GET /v1/knowledge/entities/{entity_id}","href":"/api-reference/knowledge/get-entity"},{"title":"Refresh Context","openapi":"POST /v1/knowledge/refresh","href":"/api-reference/knowledge/refresh-context"},{"title":"Context Status","openapi":"GET /v1/knowledge/status","href":"/api-reference/knowledge/context-status"},{"title":"Get Knowledge Settings","openapi":"GET /v1/knowledge/settings","href":"/api-reference/knowledge/get-knowledge-settings"},{"title":"Update Knowledge Settings","openapi":"PATCH /v1/knowledge/settings","href":"/api-reference/knowledge/update-knowledge-settings"}]},{"group":"Triggers","expanded":false,"pages":[{"title":"List triggers","openapi":"GET /v1/triggers","href":"/api-reference/Triggers/list-triggers"},{"title":"Create trigger","openapi":"POST /v1/triggers","href":"/api-reference/Triggers/create-trigger"},{"title":"List trigger registry","openapi":"GET /v1/triggers/kinds","href":"/api-reference/Triggers/list-trigger-kinds"},{"title":"Get delivery counts","openapi":"GET /v1/triggers/deliveries/summary","href":"/api-reference/Triggers/get-trigger-delivery-summary"},{"title":"Get trigger details","openapi":"GET /v1/triggers/{trigger_id}","href":"/api-reference/Triggers/get-trigger"},{"title":"Update trigger","openapi":"PATCH /v1/triggers/{trigger_id}","href":"/api-reference/Triggers/update-trigger"},{"title":"Delete trigger","openapi":"DELETE /v1/triggers/{trigger_id}","href":"/api-reference/Triggers/delete-trigger"},{"title":"List deliveries","openapi":"GET /v1/triggers/{trigger_id}/deliveries","description":null,"href":"/api-reference/Triggers/list-trigger-deliveries"}]},{"group":"Writeback","expanded":false,"pages":[{"title":"Write agent output back into the workspace","openapi":"POST /v1/writeback","href":"/api-reference/writeback/write-back"},{"title":"Recently written-back items","openapi":"GET /v1/writeback/recent","description":"What agents have already saved here, newest first — the check to make before saving\nsomething that may already exist. For content search use the knowledge search endpoints with\n``metadata: {\"writeback\": \"mcp\"}``.","href":"/api-reference/writeback/recent-writebacks"}]}]}]},"basePath":"","title":"Write agent output back into the workspace - Adapter","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}