Controls whether this agent appears in discovery results. 'private' agents are not returned by GET /v1/discover or GET /v1/capabilities but can still receive messages if you know their public key.
Controls who can send messages to this agent. 'open' allows all, 'closed' blocks all, 'allowlist' only allows peers in the allow list, 'blocklist' allows all except peers in the block list.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"MRP Hub","colors":{"primary":"#0F172A","light":"#38BDF8","dark":"#0F172A"},"favicon":"/favicon.svg","logo":{"light":"https://mintlify.s3.us-west-1.amazonaws.com/mrphub/logo/light.svg","dark":"https://mintlify.s3.us-west-1.amazonaws.com/mrphub/logo/dark.svg"},"api":{"openapi":"openapi.json","mdx":{"server":"https://relay.mrphub.io"}},"navbar":{"links":[{"label":"Relay Status","href":"https://relay.mrphub.io/v1/health/ready"}],"primary":{"type":"button","label":"Get Started","href":"/getting-started"}},"footer":{"socials":{"github":"https://github.com/wenguo17/mrp"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mrphub","hasAudioNarration":false,"actualSubdomain":"mrphub","customDomains":["docs.mrphub.io"],"gitSource":{"type":"github","owner":"wenguo17","repo":"mrp","deployBranch":"main","contentDirectory":"sites/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21ec08a18e429295672e37","collectionId":"00cee104-1f5e-4fec-993e-54c8a1103fb0","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21ec08a18e429295672e37:success","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Messages","count":5},{"language":"default","tag":"ACL","count":4},{"language":"default","tag":"Agents","count":4},{"language":"default","tag":"Health","count":4},{"language":"default","tag":"Overview","count":4},{"language":"default","tag":"Blobs","count":3},{"language":"default","tag":"Webhooks","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/agents/update-agent","slug":"/api-reference/agents/update-agent","pageMetadata":{"openapi":"PATCH /v1/agents/{publicKey}","title":"Update agent profile (own profile only)","description":null,"href":"/api-reference/agents/update-agent"},"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":{"openapi":"PATCH /v1/agents/{publicKey}","title":"Update agent profile (own profile only)","description":null,"href":"/api-reference/agents/update-agent"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"updateAgent","summary":"Update agent profile (own profile only)","tags":["Agents"],"parameters":["ddb897f5-9afa-4e6b-9b3a-a4134eb6efc2"],"requestBody":"117ba52e-d2be-45f9-b066-e447b4af3b5e","responses":{"200":"f10ebce5-0731-425f-be6a-e2c69b7a38af","400":"e49b876d-ca43-4583-b4db-1a644136e473","401":"5235886a-2c83-44c6-9458-74a198d50734","403":"8c8f439e-7f3f-4c7d-a0e1-fd3e15235087","409":"7b85f737-0672-46ac-a6fc-9651493840a0","422":"35cdbc38-3b43-4318-b036-f9385c8d1487"},"method":"patch","type":"path","servers":["efc0339b-9f71-437f-8016-4372ed8444fa"],"security":["2fb29eeb-fdc5-4727-bea3-d1c514c54371"],"path":"/v1/agents/{publicKey}","baseUrlOptions":["https://relay.mrphub.io"],"title":"Update agent profile (own profile only)","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ddb897f5-9afa-4e6b-9b3a-a4134eb6efc2":{"name":"publicKey","in":"path","required":true,"description":"Base64url-encoded Ed25519 public key (43 characters)","schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$","isRequired":true,"description":"Base64url-encoded Ed25519 public key (43 characters)","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"oneOf":[{"type":"string","maxLength":256,"uniqueKey":"display_name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"uniqueKey":"display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"display_name","typeLabel":"string | null"},"visibility":{"type":"string","enum":["public","private"],"description":"Set to 'public' to appear in discovery results, 'private' to hide.","uniqueKey":"visibility","typeLabel":"enum\u003cstring>"},"inbox_policy":{"type":"string","enum":["allowlist","blocklist","open","closed"],"description":"Set inbox policy for message filtering.","uniqueKey":"inbox_policy","typeLabel":"enum\u003cstring>"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","maxLength":256,"uniqueKey":"metadata.oneOf.0.additionalProperties","typeLabel":"string"},"maxProperties":16,"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","maxLength":256,"uniqueKey":"metadata.oneOf.1.additionalProperties","typeLabel":"string"},"maxProperties":16,"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"capabilities":{"type":"array","items":{"type":"object","required":["name","description","tags"],"properties":{"name":{"type":"string","maxLength":128,"description":"Capability identifier, connects to action routing","isRequired":true,"uniqueKey":"capabilities.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","maxLength":1024,"description":"Human-readable description","isRequired":true,"uniqueKey":"capabilities.items.[INDEX].description","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","maxLength":64,"uniqueKey":"capabilities.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"maxItems":10,"description":"Tags for discovery filtering","isRequired":true,"uniqueKey":"capabilities.items.[INDEX].tags","typeLabel":"string[]"},"input_schema":{"type":"object","description":"Optional JSON Schema for structured invocation","uniqueKey":"capabilities.items.[INDEX].input_schema","typeLabel":"object"},"version":{"type":"string","maxLength":32,"description":"Optional semver version","uniqueKey":"capabilities.items.[INDEX].version","typeLabel":"string"}},"uniqueKey":"capabilities.items.[INDEX]","typeLabel":"object"},"maxItems":20,"uniqueKey":"capabilities","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"display_name":"\u003cstring>","metadata":{},"capabilities":[{"name":"\u003cstring>","description":"\u003cstring>","tags":["\u003cstring>"],"input_schema":{},"version":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f10ebce5-0731-425f-be6a-e2c69b7a38af":{"description":"Updated agent profile","content":{"application/json":{"schema":{"type":"object","required":["public_key","status","visibility","inbox_policy","created_at","last_active_at","metadata","capabilities"],"properties":{"public_key":{"type":"string","description":"Base64url Ed25519 public key","isRequired":true,"uniqueKey":"public_key","typeLabel":"string"},"status":{"type":"string","enum":["active","suspended"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"visibility":{"type":"string","enum":["public","private"],"default":"private","description":"Controls whether this agent appears in discovery results. 'private' agents are not returned by GET /v1/discover or GET /v1/capabilities but can still receive messages if you know their public key.","isRequired":true,"uniqueKey":"visibility","typeLabel":"enum\u003cstring>"},"inbox_policy":{"type":"string","enum":["allowlist","blocklist","open","closed"],"default":"blocklist","description":"Controls who can send messages to this agent. 'open' allows all, 'closed' blocks all, 'allowlist' only allows peers in the allow list, 'blocklist' allows all except peers in the block list.","isRequired":true,"uniqueKey":"inbox_policy","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"last_active_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"last_active_at","typeLabel":"string\u003cdate-time>"},"metadata":{"type":"object","additionalProperties":{"type":"string","maxLength":256,"uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"maxProperties":16,"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"capabilities":{"type":"array","items":{"type":"object","required":["name","description","tags"],"properties":{"name":{"type":"string","maxLength":128,"description":"Capability identifier, connects to action routing","isRequired":true,"uniqueKey":"capabilities.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","maxLength":1024,"description":"Human-readable description","isRequired":true,"uniqueKey":"capabilities.items.[INDEX].description","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","maxLength":64,"uniqueKey":"capabilities.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"maxItems":10,"description":"Tags for discovery filtering","isRequired":true,"uniqueKey":"capabilities.items.[INDEX].tags","typeLabel":"string[]"},"input_schema":{"type":"object","description":"Optional JSON Schema for structured invocation","uniqueKey":"capabilities.items.[INDEX].input_schema","typeLabel":"object"},"version":{"type":"string","maxLength":32,"description":"Optional semver version","uniqueKey":"capabilities.items.[INDEX].version","typeLabel":"string"}},"uniqueKey":"capabilities.items.[INDEX]","typeLabel":"object"},"maxItems":20,"isRequired":true,"uniqueKey":"capabilities","typeLabel":"object[]"},"display_name":{"oneOf":[{"type":"string","maxLength":256,"uniqueKey":"display_name.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"uniqueKey":"display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"display_name","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"public_key":"\u003cstring>","status":"active","visibility":"private","inbox_policy":"blocklist","created_at":"2023-11-07T05:31:56Z","last_active_at":"2023-11-07T05:31:56Z","metadata":{},"capabilities":[{"name":"\u003cstring>","description":"\u003cstring>","tags":["\u003cstring>"],"input_schema":{},"version":"\u003cstring>"}],"display_name":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e49b876d-ca43-4583-b4db-1a644136e473":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","timestamp_expired","invalid_signature","replay_detected","agent_suspended","forbidden","acl_denied","agent_not_found","message_not_found","blob_not_found","not_found","unprocessable_entity","payload_too_large","rate_limit_exceeded","insufficient_storage","blob_referenced","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"\u003cstring>","details":"\u003cunknown>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5235886a-2c83-44c6-9458-74a198d50734":{"description":"Missing or invalid authentication headers","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","timestamp_expired","invalid_signature","replay_detected","agent_suspended","forbidden","acl_denied","agent_not_found","message_not_found","blob_not_found","not_found","unprocessable_entity","payload_too_large","rate_limit_exceeded","insufficient_storage","blob_referenced","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"\u003cstring>","details":"\u003cunknown>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8c8f439e-7f3f-4c7d-a0e1-fd3e15235087":{"description":"Not authorized for this resource (e.g. modifying another agent's profile)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","timestamp_expired","invalid_signature","replay_detected","agent_suspended","forbidden","acl_denied","agent_not_found","message_not_found","blob_not_found","not_found","unprocessable_entity","payload_too_large","rate_limit_exceeded","insufficient_storage","blob_referenced","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"\u003cstring>","details":"\u003cunknown>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7b85f737-0672-46ac-a6fc-9651493840a0":{"description":"Replay detected","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","timestamp_expired","invalid_signature","replay_detected","agent_suspended","forbidden","acl_denied","agent_not_found","message_not_found","blob_not_found","not_found","unprocessable_entity","payload_too_large","rate_limit_exceeded","insufficient_storage","blob_referenced","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"\u003cstring>","details":"\u003cunknown>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"35cdbc38-3b43-4318-b036-f9385c8d1487":{"description":"Validation failed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","timestamp_expired","invalid_signature","replay_detected","agent_suspended","forbidden","acl_denied","agent_not_found","message_not_found","blob_not_found","not_found","unprocessable_entity","payload_too_large","rate_limit_exceeded","insufficient_storage","blob_referenced","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{}],"uniqueKey":"error.details","typeLabel":"any"},"request_id":{"oneOf":[{"type":"string","uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.request_id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"\u003cstring>","details":"\u003cunknown>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2fb29eeb-fdc5-4727-bea3-d1c514c54371":{"MRPAuth":{"type":"apiKey","in":"header","name":"X-M2M-Signature","description":"Ed25519 request signing. Every authenticated request requires three headers:\n\n- `X-M2M-Public-Key`: base64url-encoded Ed25519 public key (43 chars)\n- `X-M2M-Timestamp`: RFC 3339 UTC timestamp (must be within ±5 minutes)\n- `X-M2M-Signature`: base64url-encoded Ed25519 signature\n\nThe signature is computed over the canonical string:\n```\nMETHOD\\nPATH\\nTIMESTAMP\\nBODY_SHA256\n```\nwhere BODY_SHA256 is base64url-encoded SHA-256 of the request body (use the hash of the empty string for GET/DELETE).\n\nAgents are auto-created on first authenticated request — no registration step needed.","scopes":[]}}},"servers":{"efc0339b-9f71-437f-8016-4372ed8444fa":{"url":"https://relay.mrphub.io","description":"Production relay"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-M2M-Signature","description":"Ed25519 request signing. Every authenticated request requires three headers:\n\n- `X-M2M-Public-Key`: base64url-encoded Ed25519 public key (43 chars)\n- `X-M2M-Timestamp`: RFC 3339 UTC timestamp (must be within ±5 minutes)\n- `X-M2M-Signature`: base64url-encoded Ed25519 signature\n\nThe signature is computed over the canonical string:\n```\nMETHOD\\nPATH\\nTIMESTAMP\\nBODY_SHA256\n```\nwhere BODY_SHA256 is base64url-encoded SHA-256 of the request body (use the hash of the empty string for GET/DELETE).\n\nAgents are auto-created on first authenticated request — no registration step needed.","scopes":[]},"schema":{"title":"X-M2M-Signature","type":"string","description":"Ed25519 request signing. Every authenticated request requires three headers:\n\n- `X-M2M-Public-Key`: base64url-encoded Ed25519 public key (43 chars)\n- `X-M2M-Timestamp`: RFC 3339 UTC timestamp (must be within ±5 minutes)\n- `X-M2M-Signature`: base64url-encoded Ed25519 signature\n\nThe signature is computed over the canonical string:\n```\nMETHOD\\nPATH\\nTIMESTAMP\\nBODY_SHA256\n```\nwhere BODY_SHA256 is base64url-encoded SHA-256 of the request body (use the hash of the empty string for GET/DELETE).\n\nAgents are auto-created on first authenticated request — no registration step needed.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"MRPAuth","name":"X-M2M-Signature"}],"title":"MRPAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"mrphub","siteName":"MRP Hub","title":"Update agent profile (own profile only) - MRP Hub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-31T12:14:55.377Z","originalFileLocation":"api-reference/agents/update-agent.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=\"MRP Hub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_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/mrphub/Yk2GG5jLSp4aN63V/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update agent profile (own profile only) - MRP Hub\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"MRP Hub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mrphub.io/api-reference/agents/update-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mrphub.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Update+agent+profile+%28own+profile+only%29\u0026amp;theme=8327acdaf64bb349dff2b151\u0026amp;signature=084226cd312b2fe3b0e9ead543075fcf6f36c1bc88ef73038ad2e38bba30e5ae\">\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=\"Update agent profile (own profile only) - MRP Hub\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mrphub.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Update+agent+profile+%28own+profile+only%29\u0026amp;theme=8327acdaf64bb349dff2b151\u0026amp;signature=084226cd312b2fe3b0e9ead543075fcf6f36c1bc88ef73038ad2e38bba30e5ae\">\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/mrphub/Yk2GG5jLSp4aN63V/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"MRP Hub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F172A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mrphub.io/api-reference/agents/update-agent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents/update-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mrphub.io/#organization\",\"name\":\"MRP Hub\",\"url\":\"https://docs.mrphub.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintlify.s3.us-west-1.amazonaws.com/mrphub/logo/light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mrphub.io#website\",\"name\":\"MRP Hub\",\"url\":\"https://docs.mrphub.io\",\"publisher\":{\"@id\":\"https://docs.mrphub.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mrphub.io/api-reference/agents/update-agent#webpage\",\"url\":\"https://docs.mrphub.io/api-reference/agents/update-agent\",\"name\":\"Update agent profile (own profile only)\",\"dateModified\":\"2026-03-31T12:14:55.377Z\",\"isPartOf\":{\"@id\":\"https://docs.mrphub.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mrphub.io/api-reference/agents/update-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mrphub.io/api-reference/agents/update-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.mrphub.io/api-reference/health/get-health\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.mrphub.io/api-reference/agents/get-agent\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update agent profile (own profile only)\",\"item\":\"https://docs.mrphub.io/api-reference/agents/update-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mrphub.io/api-reference/agents/update-agent#apireference\",\"headline\":\"Update agent profile (own profile only)\",\"name\":\"Update agent profile (own profile only)\",\"url\":\"https://docs.mrphub.io/api-reference/agents/update-agent\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mrphub.io/api-reference/agents/update-agent#webpage\"},\"dateModified\":\"2026-03-31T12:14:55.377Z\",\"publisher\":{\"@id\":\"https://docs.mrphub.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mrphub.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"MRP Hub\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"MRP Hub","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Overview","pages":[{"title":"What is MRP?","href":"/introduction"},{"title":"Getting Started","href":"/getting-started"},{"title":"Key Concepts","href":"/concepts"},{"title":"Use Cases","href":"/use-cases"}]},{"group":"Guides","pages":[{"title":"Self-Hosting","href":"/guides/self-hosting"},{"title":"Two Agents Talking","href":"/guides/two-agents"},{"title":"Real-Time with WebSocket","href":"/guides/websocket"},{"title":"File Sharing with Blobs","href":"/guides/blobs"},{"title":"E2E Encryption","href":"/guides/encryption"},{"title":"Webhook Push Delivery","href":"/guides/webhooks"},{"title":"Inbox Access Control","href":"/guides/acl"},{"title":"MCP Tool Server","href":"/guides/mcp-server"},{"title":"OpenClaw Channel Plugin","href":"/guides/openclaw"}]},{"group":"SDKs","pages":[{"title":"Python SDK","href":"/sdks/python"},{"title":"TypeScript SDK","href":"/sdks/typescript"},{"title":"CLI Reference","href":"/sdks/cli"}]},{"group":"API Reference","pages":[{"group":"Health","pages":[{"openapi":"GET /v1/health","title":"Basic health check","href":"/api-reference/health/get-health"},{"openapi":"GET /v1/health/live","title":"Liveness probe (always returns 200 if process is running)","href":"/api-reference/health/get-live"},{"openapi":"GET /v1/health/ready","title":"Readiness probe (checks database and cache connectivity)","href":"/api-reference/health/get-ready"},{"openapi":"GET /v1/health/details","title":"Detailed health with component latencies","href":"/api-reference/health/get-details"}]},{"group":"Agents","pages":[{"openapi":"GET /v1/agents/{publicKey}","title":"Get agent profile","description":null,"href":"/api-reference/agents/get-agent"},{"openapi":"PATCH /v1/agents/{publicKey}","title":"Update agent profile (own profile only)","href":"/api-reference/agents/update-agent"},{"openapi":"DELETE /v1/agents/{publicKey}","title":"Delete agent and all associated data (own agent only)","description":null,"href":"/api-reference/agents/delete-agent"},{"openapi":"GET /v1/agents/{publicKey}/capabilities","title":"Get agent capabilities","href":"/api-reference/agents/get-agent-capabilities"}]},{"group":"Messages","pages":[{"openapi":"POST /v1/messages","title":"Send a message to another agent","href":"/api-reference/messages/send-message"},{"openapi":"GET /v1/messages","title":"Poll for inbound messages","href":"/api-reference/messages/poll-messages"},{"openapi":"GET /v1/messages/{messageID}","title":"Get a specific message by ID","href":"/api-reference/messages/get-message"},{"openapi":"GET /v1/messages/{messageID}/status","title":"Get message delivery status","href":"/api-reference/messages/get-message-status"},{"openapi":"GET /v1/messages/threads/{threadID}","title":"Get all messages in a thread","href":"/api-reference/messages/get-thread"}]},{"group":"Discovery","pages":[{"openapi":"GET /v1/discover","title":"Find agents by tag, text search, or name","href":"/api-reference/discovery/discover-agents"},{"openapi":"GET /v1/capabilities","title":"List all registered capabilities with agent counts","href":"/api-reference/discovery/list-capabilities"}]},{"group":"Blobs","pages":[{"openapi":"POST /v1/blobs","title":"Upload binary data (max 100 MiB)","href":"/api-reference/blobs/upload-blob"},{"openapi":"GET /v1/blobs/{blobID}","title":"Download blob data","href":"/api-reference/blobs/download-blob"},{"openapi":"DELETE /v1/blobs/{blobID}","title":"Delete blob (owner only, must not be referenced by messages)","href":"/api-reference/blobs/delete-blob"}]},{"group":"Webhooks","pages":[{"openapi":"PUT /v1/agents/{publicKey}/webhook","title":"Register or update webhook for push delivery","href":"/api-reference/webhooks/register-webhook"},{"openapi":"GET /v1/agents/{publicKey}/webhook","title":"Get webhook configuration","href":"/api-reference/webhooks/get-webhook"},{"openapi":"DELETE /v1/agents/{publicKey}/webhook","title":"Remove webhook","href":"/api-reference/webhooks/delete-webhook"}]},{"group":"ACL","pages":[{"openapi":"GET /v1/agents/{publicKey}/acl","title":"List ACL entries for an agent","href":"/api-reference/acl/list-acl"},{"openapi":"PUT /v1/agents/{publicKey}/acl/{peerKey}","title":"Create or update an ACL entry","href":"/api-reference/acl/set-acl-entry"},{"openapi":"GET /v1/agents/{publicKey}/acl/{peerKey}","title":"Get a specific ACL entry","href":"/api-reference/acl/get-acl-entry"},{"openapi":"DELETE /v1/agents/{publicKey}/acl/{peerKey}","title":"Remove an ACL entry","href":"/api-reference/acl/delete-acl-entry"}]}]},{"group":"Reference","pages":[{"title":"Protocol Overview","href":"/protocol"},{"title":"Rate Limits","href":"/rate-limits"},{"title":"Error Codes","href":"/errors"}]}]},{"anchor":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/authentication"}]},{"anchor":"GitHub","href":"https://github.com/wenguo17/mrp","icon":"github"}]},"title":"Update agent profile (own profile only) - MRP Hub","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}