{"items":[{"type":"link","label":"Okta for AI Agents","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers","content":{"contentType":"overview","meta":{"name":"Okta for AI Agents"},"children":[{"nodeType":"container","panels":[{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"java","title":"Java","lang":"Java"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"go","title":"Go","lang":"Go"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com","description":"The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains."}}}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Okta for AI Agents","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"APIs for registering, managing, and securing AI agents and their connections to resources in your Okta org."}],"sectionId":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers"},{"nodeType":"external-docs","url":"https://developer.okta.com/","description":"Okta developer documentation and API reference"}],"sectionId":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers"}]}]}},{"type":"separator","label":"Resource Servers","content":null},{"type":"group","label":"Agent-to-Agent Server Registrations","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration","items":[{"label":"List all A2A servers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/lista2aservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/lista2aservers","metadata":{"seo":{"title":"List all A2A servers","description":"BetaOAuth 2.0 scope:okta.aiAgents.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listA2AServers","name":"List all A2A servers","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all A2A servers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all A2A servers in your org. An A2A server is automatically created when an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/okta-management/management/tag/AIAgentRegistration/"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI agent"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is registered with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and automatically deleted when the AI agent is deleted."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"search","in":"query","schemaId":"schema_1976","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Searches for A2A servers with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sw"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/a2a-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"search","in":"query","example":"resourceUrl eq \"https://demo-agent.example.com\"","schemaId":"schema_1976"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","429"],"pointer":"/resource-servers/api/v1/a2a-servers","href":"a2aserverregistration/lista2aservers","openApiOperationId":"listA2AServers","summary":"List all A2A servers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1977","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/200/content/application~1json/examples/List of A2A servers"]}},"schemaId":"schema_1977","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/200/content/application~1json/examples/List of A2A servers"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1977","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/200/content/application~1json/examples/List of A2A servers"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1977","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/200/content/application~1json/examples/List of A2A servers"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/a2a-servers"},{"label":"Retrieve an A2A server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/geta2aserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/geta2aserver","metadata":{"seo":{"title":"Retrieve an A2A server","description":"BetaOAuth 2.0 scope:okta.aiAgents.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getA2AServer","name":"Retrieve an A2A server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an A2A server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves an A2A server by its unique identifier"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"a2aServerId","in":"path","schemaId":"schema_1978","description":"ID of an A2A server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/a2a-servers/{a2aServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"a2aServerId","in":"path","required":true,"example":"wlpx9jQ16k9V8IFEL0g3","schemaId":"schema_1978"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/a2a-servers/{a2aServerId}","href":"a2aserverregistration/geta2aserver","openApiOperationId":"getA2AServer","summary":"Retrieve an A2A server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/A2AServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/200/content/application~1json/examples/A2A server"]}},"schemaId":"components/schemas/A2AServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/200/content/application~1json/examples/A2A server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/A2AServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/200/content/application~1json/examples/A2A server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/A2AServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/200/content/application~1json/examples/A2A server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/a2a-servers/{a2aServerId}"},{"label":"List all authorization servers for an A2A server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/lista2aserverauthorizationservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/lista2aserverauthorizationservers","metadata":{"seo":{"title":"List all authorization servers for an A2A server","description":"BetaOAuth 2.0 scope:okta.aiAgents.readokta.authorizationServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listA2AServerAuthorizationServers","name":"List all authorization servers for an A2A server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all authorization servers for an A2A server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.authorizationServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all authorization servers for the specified A2A server"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"a2aServerId","in":"path","schemaId":"schema_1978","description":"ID of an A2A server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"filter","in":"query","schemaId":"schema_1979","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters the results with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"a2aServerId","in":"path","required":true,"example":"wlpx9jQ16k9V8IFEL0g3","schemaId":"schema_1978"}],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"filter","in":"query","example":"status eq \"ACTIVE\"","schemaId":"schema_1979"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers","href":"a2aserverregistration/lista2aserverauthorizationservers","openApiOperationId":"listA2AServerAuthorizationServers","summary":"List all authorization servers for an A2A server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1980","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an A2A server"]}},"schemaId":"schema_1980","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an A2A server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1980","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an A2A server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1980","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an A2A server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers"},{"label":"Add an authorization server to an A2A server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/adda2aserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/adda2aserverauthorizationserver","metadata":{"seo":{"title":"Add an authorization server to an A2A server","description":"BetaOAuth 2.0 scope:okta.aiAgents.manageokta.authorizationServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addA2AServerAuthorizationServer","name":"Add an authorization server to an A2A server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add an authorization server to an A2A server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.authorizationServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/okta-oauth/oauth/customas"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Okta custom authorization server"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to an A2A server."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of an existing Okta custom authorization server in your org."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Okta validates that the authorization server exists and resolves its metadata automatically."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"a2aServerId","in":"path","schemaId":"schema_1978","description":"ID of an A2A server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1981","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server"]}},"schemaId":"schema_1981","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server"],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"a2aServerId","in":"path","required":true,"example":"wlpx9jQ16k9V8IFEL0g3","schemaId":"schema_1978"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_1981","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server"]}},"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers","href":"a2aserverregistration/adda2aserverauthorizationserver","openApiOperationId":"addA2AServerAuthorizationServer","summary":"Add an authorization server to an A2A server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"schema_1981","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1981","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1982"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers"},{"label":"Retrieve an authorization server for an A2A server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/geta2aserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/geta2aserverauthorizationserver","metadata":{"seo":{"title":"Retrieve an authorization server for an A2A server","description":"BetaOAuth 2.0 scope:okta.aiAgents.readokta.authorizationServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getA2AServerAuthorizationServer","name":"Retrieve an authorization server for an A2A server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an authorization server for an A2A server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.authorizationServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves an authorization server that is associated to an A2A server by the authorization server's ID"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"a2aServerId","in":"path","schemaId":"schema_1978","description":"ID of an A2A server","required":true},{"name":"authorizationServerId","in":"path","schemaId":"schema_1983","description":"ID of an authorization server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"a2aServerId","in":"path","required":true,"example":"wlpx9jQ16k9V8IFEL0g3","schemaId":"schema_1978"},{"name":"authorizationServerId","in":"path","required":true,"example":"aus5rb5mt2H3d1TJd0h7","schemaId":"schema_1983"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}","href":"a2aserverregistration/geta2aserverauthorizationserver","openApiOperationId":"getA2AServerAuthorizationServer","summary":"Retrieve an authorization server for an A2A server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/Okta custom authorization server"]}},"schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/Okta custom authorization server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/Okta custom authorization server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/Okta custom authorization server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}"},{"label":"Remove an authorization server from an A2A server","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/removea2aserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/a2aserverregistration/removea2aserverauthorizationserver","metadata":{"seo":{"title":"Remove an authorization server from an A2A server","description":"BetaOAuth 2.0 scope:okta.aiAgents.manageokta.authorizationServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeA2AServerAuthorizationServer","name":"Remove an authorization server from an A2A server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove an authorization server from an A2A server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.authorizationServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes the association between an authorization server and an A2A server. This doesn't delete the authorization server from Okta."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"a2aServerId","in":"path","schemaId":"schema_1978","description":"ID of an A2A server","required":true},{"name":"authorizationServerId","in":"path","schemaId":"schema_1983","description":"ID of an authorization server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"a2aServerId","in":"path","required":true,"example":"wlpx9jQ16k9V8IFEL0g3","schemaId":"schema_1978"},{"name":"authorizationServerId","in":"path","required":true,"example":"aus5rb5mt2H3d1TJd0h7","schemaId":"schema_1983"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}","href":"a2aserverregistration/removea2aserverauthorizationserver","openApiOperationId":"removeA2AServerAuthorizationServer","summary":"Remove an authorization server from an A2A server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1982"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}"}],"content":{"contentType":"group","meta":{"name":"A2AServerRegistration"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Agent-to-Agent Server Registrations","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Agent-to-Agent (A2A) Server Registrations API provides read-only operations for A2A servers and management operations for their associated authorization servers. An A2A server represents the resource server identity of an AI agent in agent-to-agent deployments, which are identified by a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API, which is available as a Beta release, is only available if you're subscribed to Okta for AI Agents. Contact Okta Support for more information."},"children":[]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/resource-servers/api/v1/a2a-servers","summary":"List all A2A servers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/a2aserverregistration/lista2aservers","deprecated":false},{"title":"/resource-servers/api/v1/a2a-servers/{a2aServerId}","summary":"Retrieve an A2A server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/a2aserverregistration/geta2aserver","deprecated":false},{"title":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers","summary":"List all authorization servers for an A2A server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/a2aserverregistration/lista2aserverauthorizationservers","deprecated":false},{"title":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers","summary":"Add an authorization server to an A2A server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/a2aserverregistration/adda2aserverauthorizationserver","deprecated":false},{"title":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}","summary":"Retrieve an authorization server for an A2A server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/a2aserverregistration/geta2aserverauthorizationserver","deprecated":false},{"title":"/resource-servers/api/v1/a2a-servers/{a2aServerId}/authorization-servers/{authorizationServerId}","summary":"Remove an authorization server from an A2A server","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/a2aserverregistration/removea2aserverauthorizationserver","deprecated":false}]}]}]}]}},{"type":"group","label":"API Server Registrations","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration","items":[{"label":"List all API servers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/listapiservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/listapiservers","metadata":{"seo":{"title":"List all API servers","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listApiServers","name":"List all API servers","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all API servers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all registered third-party API servers"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"search","in":"query","schemaId":"schema_1984","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Searches for API servers with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sw"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"metadata.displayName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/api-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"search","in":"query","example":"metadata.displayName sw \"Example\" and status eq \"ACTIVE\"","schemaId":"schema_1984"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","429"],"pointer":"/resource-servers/api/v1/api-servers","href":"apiserverregistration/listapiservers","openApiOperationId":"listApiServers","summary":"List all API servers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1985","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/200/content/application~1json/examples/List of API servers"]}},"schemaId":"schema_1985","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/200/content/application~1json/examples/List of API servers"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1985","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/200/content/application~1json/examples/List of API servers"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1985","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/200/content/application~1json/examples/List of API servers"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers"},{"label":"Register an API server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/registerapiserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/registerapiserver","metadata":{"seo":{"title":"Register an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"registerApiServer","name":"Register an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Register an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Registers a third-party API server as a resource server"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateApiServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server"]}},"schemaId":"components/schemas/CreateApiServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server"],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/api-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateApiServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server"]}},"responseCodes":["202","400","403","429"],"pointer":"/resource-servers/api/v1/api-servers","href":"apiserverregistration/registerapiserver","openApiOperationId":"registerApiServer","summary":"Register an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/CreateApiServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateApiServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers"},{"label":"Retrieve an API server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/getapiserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/getapiserver","metadata":{"seo":{"title":"Retrieve an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getApiServer","name":"Retrieve an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a third-party API server by ID"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/api-servers/{apiServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}","href":"apiserverregistration/getapiserver","openApiOperationId":"getApiServer","summary":"Retrieve an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Active API server","paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Inactive API server"]}},"schemaId":"components/schemas/ApiServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Active API server","paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Inactive API server"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ApiServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Active API server","paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Inactive API server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ApiServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Active API server","paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Inactive API server"]}}},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}"},{"label":"Update an API server","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/updateapiserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/updateapiserver","metadata":{"seo":{"title":"Update an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateApiServer","name":"Update an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a third-party API server. Use this request to perform partial updates on API server properties."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"]}},"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/resource-servers/api/v1/api-servers/{apiServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/merge-patch+json":{"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"]}},"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}","href":"apiserverregistration/updateapiserver","openApiOperationId":"updateApiServer","summary":"Update an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"],"mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}"},{"label":"Delete an API server","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/deleteapiserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/deleteapiserver","metadata":{"seo":{"title":"Delete an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteApiServer","name":"Delete an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes a registered third-party API server. The API server can't be in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to be deleted. Deleting the API Server deletes all the associated authorization servers and client authentication settings in Okta."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/resource-servers/api/v1/api-servers/{apiServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}","href":"apiserverregistration/deleteapiserver","openApiOperationId":"deleteApiServer","summary":"Delete an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}"},{"label":"List all authorization servers for an API server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/listapiserverauthorizationservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/listapiserverauthorizationservers","metadata":{"seo":{"title":"List all authorization servers for an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listApiServerAuthorizationServers","name":"List all authorization servers for an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all authorization servers for an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all authorization servers for a third-party API server"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"filter","in":"query","schemaId":"schema_1979","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters the results with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"filter","in":"query","example":"status eq \"ACTIVE\"","schemaId":"schema_1979"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers","href":"apiserverregistration/listapiserverauthorizationservers","openApiOperationId":"listApiServerAuthorizationServers","summary":"List all authorization servers for an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1989","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an API server"]}},"schemaId":"schema_1989","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an API server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1989","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an API server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1989","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an API server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers"},{"label":"Add an authorization server to an API server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/addapiserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/addapiserverauthorizationserver","metadata":{"seo":{"title":"Add an authorization server to an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addApiServerAuthorizationServer","name":"Add an authorization server to an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add an authorization server to an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds an authorization server to a third-party API server"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1990","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server"]}},"schemaId":"schema_1990","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server"],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_1990","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server"]}},"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers","href":"apiserverregistration/addapiserverauthorizationserver","openApiOperationId":"addApiServerAuthorizationServer","summary":"Add an authorization server to an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"schema_1990","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_1990","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers"},{"label":"Retrieve an authorization server for an API server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/getapiserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/getapiserverauthorizationserver","metadata":{"seo":{"title":"Retrieve an authorization server for an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getApiServerAuthorizationServer","name":"Retrieve an authorization server for an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an authorization server for an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves an authorization server linked to an API server by its ID"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true},{"name":"authorizationServerId","in":"path","schemaId":"schema_1991","description":"ID of an authorization server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"},{"name":"authorizationServerId","in":"path","required":true,"example":"eas8nUa7p0g4zrZbs2f4","schemaId":"schema_1991"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","href":"apiserverregistration/getapiserverauthorizationserver","openApiOperationId":"getApiServerAuthorizationServer","summary":"Retrieve an authorization server for an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/External authorization server"]}},"schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/External authorization server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/External authorization server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/A2AServerAuthorizationServer","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/External authorization server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}"},{"label":"Update an authorization server for an API server","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/updateapiserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/updateapiserverauthorizationserver","metadata":{"seo":{"title":"Update an authorization server for an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateApiServerAuthorizationServer","name":"Update an authorization server for an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an authorization server for an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates an authorization server for a third-party API server. Use this request to perform partial updates on authorization server properties. You can't change the issuer."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true},{"name":"authorizationServerId","in":"path","schemaId":"schema_1991","description":"ID of an authorization server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"schema_1992","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints"]}},"schemaId":"schema_1992","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints"],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"},{"name":"authorizationServerId","in":"path","required":true,"example":"eas8nUa7p0g4zrZbs2f4","schemaId":"schema_1991"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/merge-patch+json":{"schemaId":"schema_1992","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints"]}},"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","href":"apiserverregistration/updateapiserverauthorizationserver","openApiOperationId":"updateApiServerAuthorizationServer","summary":"Update an authorization server for an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"schema_1992","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints"],"mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"schema_1992","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}"},{"label":"Remove an authorization server from an API server","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/removeapiserverauthorizationserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/removeapiserverauthorizationserver","metadata":{"seo":{"title":"Remove an authorization server from an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"removeApiServerAuthorizationServer","name":"Remove an authorization server from an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Remove an authorization server from an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes an authorization server from a third-party API server. If you remove the authorization server associated to the API server, the associated client authentication settings are also deleted in Okta."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true},{"name":"authorizationServerId","in":"path","schemaId":"schema_1991","description":"ID of an authorization server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"},{"name":"authorizationServerId","in":"path","required":true,"example":"eas8nUa7p0g4zrZbs2f4","schemaId":"schema_1991"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","href":"apiserverregistration/removeapiserverauthorizationserver","openApiOperationId":"removeApiServerAuthorizationServer","summary":"Remove an authorization server from an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}"},{"label":"Activate an API server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/activateapiserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/activateapiserver","metadata":{"seo":{"title":"Activate an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"activateApiServer","name":"Activate an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Activate an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Activates a third-party API server, transitioning it from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The API server must be in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to be activated."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/activate","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/activate","href":"apiserverregistration/activateapiserver","openApiOperationId":"activateApiServer","summary":"Activate an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/activate"},{"label":"Deactivate an API server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/deactivateapiserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/apiserverregistration/deactivateapiserver","metadata":{"seo":{"title":"Deactivate an API server","description":"BetaOAuth 2.0 scope:okta.resourceServers.apiServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deactivateApiServer","name":"Deactivate an API server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Deactivate an API server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deactivates a third-party API server, transitioning it from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The API server must be in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to be deactivated."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"apiServerId","in":"path","schemaId":"schema_1987","description":"ID of an API server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/deactivate","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"apiServerId","in":"path","required":true,"example":"api8nUa7p0g4zrZbs2f4","schemaId":"schema_1987"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/deactivate","href":"apiserverregistration/deactivateapiserver","openApiOperationId":"deactivateApiServer","summary":"Deactivate an API server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/deactivate"}],"content":{"contentType":"group","meta":{"name":"ApiServerRegistration"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"API Server Registrations","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The API Server Registrations API provides registration and management operations for third-party API servers as resource servers. An API server is a third-party REST API that AI agents can authenticate to and access as a resource server."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API, which is available as a Beta release, is only available if you're subscribed to Okta for AI Agents. Contact Okta Support for more information."},"children":[]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/resource-servers/api/v1/api-servers","summary":"List all API servers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/apiserverregistration/listapiservers","deprecated":false},{"title":"/resource-servers/api/v1/api-servers","summary":"Register an API server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/apiserverregistration/registerapiserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}","summary":"Retrieve an API server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/apiserverregistration/getapiserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}","summary":"Update an API server","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/apiserverregistration/updateapiserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}","summary":"Delete an API server","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/apiserverregistration/deleteapiserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers","summary":"List all authorization servers for an API server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/apiserverregistration/listapiserverauthorizationservers","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers","summary":"Add an authorization server to an API server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/apiserverregistration/addapiserverauthorizationserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","summary":"Retrieve an authorization server for an API server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/apiserverregistration/getapiserverauthorizationserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","summary":"Update an authorization server for an API server","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/apiserverregistration/updateapiserverauthorizationserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/authorization-servers/{authorizationServerId}","summary":"Remove an authorization server from an API server","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/apiserverregistration/removeapiserverauthorizationserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/activate","summary":"Activate an API server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/apiserverregistration/activateapiserver","deprecated":false},{"title":"/resource-servers/api/v1/api-servers/{apiServerId}/lifecycle/deactivate","summary":"Deactivate an API server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/apiserverregistration/deactivateapiserver","deprecated":false}]}]}]}]}},{"type":"group","label":"MCP Server Registrations","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration","items":[{"label":"List all MCP servers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/listmcpservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/listmcpservers","metadata":{"seo":{"title":"List all MCP servers","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listMCPServers","name":"List all MCP servers","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all MCP servers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all registered third-party Model Context Protocol (MCP) servers"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"search","in":"query","schemaId":"schema_1993","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Searches for MCP servers with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sw"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"metadata.displayName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sw"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"detectedMetadata.resourceName"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/mcp-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"search","in":"query","example":"metadata.displayName sw \"GitHub\" and status eq \"ACTIVE\"","schemaId":"schema_1993"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","429"],"pointer":"/resource-servers/api/v1/mcp-servers","href":"mcpserverregistration/listmcpservers","openApiOperationId":"listMCPServers","summary":"List all MCP servers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1994","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/200/content/application~1json/examples/List of MCP servers"]}},"schemaId":"schema_1994","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/200/content/application~1json/examples/List of MCP servers"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1994","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/200/content/application~1json/examples/List of MCP servers"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1994","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/200/content/application~1json/examples/List of MCP servers"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers"},{"label":"Register an MCP server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/registermcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/registermcpserver","metadata":{"seo":{"title":"Register an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"registerMCPServer","name":"Register an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Register an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Registers a third-party Model Context Protocol (MCP) server"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateMCPServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server"]}},"schemaId":"components/schemas/CreateMCPServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server"],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/mcp-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateMCPServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server"]}},"responseCodes":["202","400","403","429"],"pointer":"/resource-servers/api/v1/mcp-servers","href":"mcpserverregistration/registermcpserver","openApiOperationId":"registerMCPServer","summary":"Register an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/CreateMCPServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateMCPServerRequest","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers"},{"label":"Retrieve an MCP server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/getmcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/getmcpserver","metadata":{"seo":{"title":"Retrieve an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMCPServer","name":"Retrieve an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a third-party Model Context Protocol (MCP) server by ID"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","400","403","404","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","href":"mcpserverregistration/getmcpserver","openApiOperationId":"getMCPServer","summary":"Retrieve an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MCPServer","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server with expanded counts","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Inactive MCP server ready to be activated","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Invalid MCP server (validation failed)"]}},"schemaId":"components/schemas/MCPServer","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server with expanded counts","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Inactive MCP server ready to be activated","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Invalid MCP server (validation failed)"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/MCPServer","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server with expanded counts","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Inactive MCP server ready to be activated","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Invalid MCP server (validation failed)"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/MCPServer","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server with expanded counts","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Inactive MCP server ready to be activated","paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Invalid MCP server (validation failed)"]}}},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}"},{"label":"Update an MCP server","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/updatemcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/updatemcpserver","metadata":{"seo":{"title":"Update an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateMCPServer","name":"Update an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a third-party Model Context Protocol (MCP) server. Use this request to perform partial updates on MCP server properties."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"]}},"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/merge-patch+json":{"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"]}},"responseCodes":["202","204","400","403","404","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","href":"mcpserverregistration/updatemcpserver","openApiOperationId":"updateMCPServer","summary":"Update an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"],"mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"schema_1988","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"204","description":"No Content. The request body was empty, so no changes were made."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"204"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}"},{"label":"Delete an MCP server","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/deletemcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/deletemcpserver","metadata":{"seo":{"title":"Delete an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteMCPServer","name":"Delete an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes a registered third-party Model Context Protocol (MCP) server. The MCP server can't be in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to be deleted."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","409","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","href":"mcpserverregistration/deletemcpserver","openApiOperationId":"deleteMCPServer","summary":"Delete an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/409/content/application~1json/examples/Conflict"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/409/content/application~1json/examples/Conflict"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"409","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/409/content/application~1json/examples/Conflict"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/409/content/application~1json/examples/Conflict"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}"},{"label":"List all authorization servers for an MCP server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/listmcpserverauthorizationservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/listmcpserverauthorizationservers","metadata":{"seo":{"title":"List all authorization servers for an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listMCPServerAuthorizationServers","name":"List all authorization servers for an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all authorization servers for an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all authorization servers for a third-party Model Context Protocol (MCP) server."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DISCOVERABLE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" MCP servers, authorization servers are automatically discovered from the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MCP server's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-protected-resource"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint and populated from the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-authorization-server"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint, and their operational status is managed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"automatically through that detection process."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"filter","in":"query","schemaId":"schema_1979","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters the results with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/authorization-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"filter","in":"query","example":"status eq \"ACTIVE\"","schemaId":"schema_1979"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/authorization-servers","href":"mcpserverregistration/listmcpserverauthorizationservers","openApiOperationId":"listMCPServerAuthorizationServers","summary":"List all authorization servers for an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1996","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an MCP server"]}},"schemaId":"schema_1996","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an MCP server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1996","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an MCP server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_1996","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an MCP server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/authorization-servers"},{"label":"Activate an MCP server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/activatemcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/activatemcpserver","metadata":{"seo":{"title":"Activate an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"activateMCPServer","name":"Activate an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Activate an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Activates a third-party Model Context Protocol (MCP) server, transitioning it from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The MCP server must be in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to be activated."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/activate","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","409","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/activate","href":"mcpserverregistration/activatemcpserver","openApiOperationId":"activateMCPServer","summary":"Activate an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/409/content/application~1json/examples/Conflict"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/409/content/application~1json/examples/Conflict"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"409","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/409/content/application~1json/examples/Conflict"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/409/content/application~1json/examples/Conflict"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/activate"},{"label":"Deactivate an MCP server","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/deactivatemcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/deactivatemcpserver","metadata":{"seo":{"title":"Deactivate an MCP server","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deactivateMCPServer","name":"Deactivate an MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Deactivate an MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deactivates a third-party Model Context Protocol (MCP) server, transitioning it from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The MCP server must be in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status to be deactivated."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/deactivate","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","409","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/deactivate","href":"mcpserverregistration/deactivatemcpserver","openApiOperationId":"deactivateMCPServer","summary":"Deactivate an MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"409","description":"Conflict","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/409/content/application~1json/examples/Conflict"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/409/content/application~1json/examples/Conflict"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"409","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/409/content/application~1json/examples/Conflict"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/409/content/application~1json/examples/Conflict"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/deactivate"},{"label":"Refresh the MCP server metadata","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/refreshmcpservermetadata","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/mcpserverregistration/refreshmcpservermetadata","metadata":{"seo":{"title":"Refresh the MCP server metadata","description":"BetaOAuth 2.0 scope:okta.resourceServers.mcpServers.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"refreshMCPServerMetadata","name":"Refresh the MCP server metadata","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Refresh the MCP server metadata","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refreshes metadata from the third-party Model Context Protocol (MCP) server's resource metadata URL."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This operation can be used to attempt recovery from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" states by re-validating the MCP server configuration and connectivity."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A manually registered MCP server may not refresh successfully if it doesn't expose discovery metadata."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"mcpServerId","in":"path","schemaId":"schema_1995","description":"ID of an MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/metadata/refresh","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"mcpServerId","in":"path","required":true,"example":"ems8nUa7p0g4zrZbs2f4","schemaId":"schema_1995"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["202","400","403","404","429"],"pointer":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/metadata/refresh","href":"mcpserverregistration/refreshmcpservermetadata","openApiOperationId":"refreshMCPServerMetadata","summary":"Refresh the MCP server metadata"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted","headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/metadata/refresh"}],"content":{"contentType":"group","meta":{"name":"MCPServerRegistration"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"MCP Server Registrations","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Model Context Protocol (MCP) Server Registrations API provides registration and lifecycle management operations for third-party MCP servers. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/mcp-servers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MCP Servers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API, which is available as a Beta release, is only available if you're subscribed to Okta for AI Agents. Contact Okta Support for more information."},"children":[]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/resource-servers/api/v1/mcp-servers","summary":"List all MCP servers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/mcpserverregistration/listmcpservers","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers","summary":"Register an MCP server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/mcpserverregistration/registermcpserver","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","summary":"Retrieve an MCP server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/mcpserverregistration/getmcpserver","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","summary":"Update an MCP server","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/mcpserverregistration/updatemcpserver","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}","summary":"Delete an MCP server","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/mcpserverregistration/deletemcpserver","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/authorization-servers","summary":"List all authorization servers for an MCP server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/mcpserverregistration/listmcpserverauthorizationservers","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/activate","summary":"Activate an MCP server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/mcpserverregistration/activatemcpserver","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/lifecycle/deactivate","summary":"Deactivate an MCP server","prefix":{"name":"post","color":"post"},"badges":[],"link":"/mcpserverregistration/deactivatemcpserver","deprecated":false},{"title":"/resource-servers/api/v1/mcp-servers/{mcpServerId}/metadata/refresh","summary":"Refresh the MCP server metadata","prefix":{"name":"post","color":"post"},"badges":[],"link":"/mcpserverregistration/refreshmcpservermetadata","deprecated":false}]}]}]}]}},{"type":"group","label":"Client Authentication Settings","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings","items":[{"label":"List all client authentication settings","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/listclientauthsettings","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/listclientauthsettings","metadata":{"seo":{"title":"List all client authentication settings","description":"BetaOAuth 2.0 scope:okta.resourceServers.clientAuthSettings.readokta.resourceServers.mcpServers.readokta.resourceServers.virtualMcpServers.readokta.resourceServers.apiServers.readokta.resourceServers.readokta.aiAgents.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listClientAuthSettings","name":"List all client authentication settings","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all client authentication settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.clientAuthSettings.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all configured client authentication settings. Each entry includes the purpose array, protocol, and configuration details. Optionally, you can filter by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceOrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and/or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" using a SCIM filter expression."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"after"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" link in the response."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"Number of results to return."},{"name":"search","in":"query","schemaId":"schema_1997","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Searches for client authentication settings with a filtering expression. This supports the following operator:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceOrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" properties"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter expressions can be combined using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"and"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" logical operator."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Query parameter percent encoding is required."},"children":[]}]}]}]}],"examples":{"filterByTargetOrn":{"summary":"Search by target Orn","description":"Search client authentication settings that reference a specific target entity by its ORN","value":"resourceOrn eq \"orn:okta:idp:00o1n8sbwArJ7OQRw406:apps:github:0oa1gjh63g214q0Hq0g4\""},"filterByPurpose":{"summary":"Search by purpose","description":"Search client authentication settings whose purpose matches the given value","value":"purpose eq \"STS\""},"filterByTargetOrnAndPurpose":{"summary":"Search by target Orn and purpose","description":"Search client authentication settings that match both a specific target ORN and a specific purpose","value":"resourceOrn eq \"orn:okta:idp:00o1n8sbwArJ7OQRw406:apps:github:0oa1gjh63g214q0Hq0g4\" and purpose eq \"STS\""}}}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/client-auth-settings","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"after","in":"query","required":false,"schemaId":"schema_1974"},{"name":"limit","in":"query","required":false,"schemaId":"schema_1975"},{"name":"search","in":"query","required":false,"example":"resourceOrn eq \"orn:okta:idp:00o1n8sbwArJ7OQRw406:apps:github:0oa1gjh63g214q0Hq0g4\"","schemaId":"schema_1997"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","429"],"pointer":"/resource-servers/api/v1/client-auth-settings","href":"resourceserverclientauthsettings/listclientauthsettings","openApiOperationId":"listClientAuthSettings","summary":"List all client authentication settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A list of client authentication settings","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettingsList","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/200/content/application~1json/examples/List client authentication settings with both STS and AGENT_IMPORT types"]}},"schemaId":"components/schemas/ClientAuthSettingsList","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/200/content/application~1json/examples/List client authentication settings with both STS and AGENT_IMPORT types"],"headers":{"Link":{"required":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A link to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"self"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present if there is another page of results."},"children":[]}]}]}]}],"schema":{"type":"string"}},"X-Rate-Limit-Limit":{"required":true,"description":"The rate-limit ceiling for the current request","schema":{"type":"integer","minimum":1,"example":60}},"X-Rate-Limit-Remaining":{"required":true,"description":"The number of requests left for the current rate-limit window","schema":{"type":"integer","minimum":0,"example":60}},"X-Rate-Limit-Reset":{"required":true,"description":"The time when the rate limit resets, specified in UTC epoch time (in seconds)","schema":{"type":"integer","minimum":0,"example":1609459200}}},"headerSchemaId":"schema_1998"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ClientAuthSettingsList","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/200/content/application~1json/examples/List client authentication settings with both STS and AGENT_IMPORT types"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettingsList","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/200/content/application~1json/examples/List client authentication settings with both STS and AGENT_IMPORT types"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/client-auth-settings"},{"label":"Create a client authentication settings","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/createclientauthsettings","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/createclientauthsettings","metadata":{"seo":{"title":"Create a client authentication settings","description":"BetaOAuth 2.0 scope:okta.resourceServers.clientAuthSettings.manageokta.resourceServers.mcpServers.manageokta.resourceServers.virtualMcpServers.manageokta.resourceServers.apiServers.manageokta.resourceServers.manageokta.aiAgents.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createClientAuthSettings","name":"Create a client authentication settings","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a client authentication settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.clientAuthSettings.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates client authentication settings for a resource server. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceOrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must reference an entity that supports client authentication settings. After it's created, you can only modify the client secret and OAuth scopes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"registrationMethod"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" determines how the OAuth client credentials are obtained:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATIC"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default): You supply the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"clientCredentials"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The settings are created synchronously and the response is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"201"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DCR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Okta registers the client with the resource's authorization server on your behalf through "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://datatracker.ietf.org/doc/html/rfc7591"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Client Registration"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Creation runs asynchronously: the response is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"202"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header referencing an operation to poll for completion."},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ClientAuthSettingsCreatable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR"]}},"schemaId":"components/schemas/ClientAuthSettingsCreatable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR"],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/resource-servers/api/v1/client-auth-settings","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/ClientAuthSettingsCreatable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR"]}},"responseCodes":["201","202","400","403","429"],"pointer":"/resource-servers/api/v1/client-auth-settings","href":"resourceserverclientauthsettings/createclientauthsettings","openApiOperationId":"createClientAuthSettings","summary":"Create a client authentication settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/ClientAuthSettingsCreatable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ClientAuthSettingsCreatable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Client authentication settings successfully created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for agent import"]}},"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for agent import"]},{"code":"202","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepted. The client authentication settings are being created asynchronously (for example, when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"registrationMethod"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DCR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Poll the operation referenced by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header for completion."},"children":[]}]}]}],"headers":{"Location":{"required":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","format":"uri"},"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"headerSchemaId":"schema_1986"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for agent import"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for agent import"]}}},{"code":"202"},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/client-auth-settings"},{"label":"Get client authentication settings","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/getclientauthsettings","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/getclientauthsettings","metadata":{"seo":{"title":"Get client authentication settings","description":"BetaOAuth 2.0 scope:okta.resourceServers.clientAuthSettings.readokta.resourceServers.mcpServers.readokta.resourceServers.virtualMcpServers.readokta.resourceServers.apiServers.readokta.resourceServers.readokta.aiAgents.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getClientAuthSettings","name":"Get client authentication settings","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get client authentication settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.clientAuthSettings.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.read"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves client authentication settings for a resource server. The response will include everything except secrets."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"clientAuthSettingsId","in":"path","schemaId":"schema_1999","description":"ID of the client authentication settings","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"clientAuthSettingsId","in":"path","required":true,"example":"con1a2b3c4d5e6f7g8h9","schemaId":"schema_1999"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","href":"resourceserverclientauthsettings/getclientauthsettings","openApiOperationId":"getClientAuthSettings","summary":"Get client authentication settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful client authentication settings retrieval","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for agent import"]}},"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for agent import"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for agent import"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for agent import"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}"},{"label":"Update client authentication settings","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/updateclientauthsettings","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/updateclientauthsettings","metadata":{"seo":{"title":"Update client authentication settings","description":"BetaOAuth 2.0 scope:okta.resourceServers.clientAuthSettings.manageokta.resourceServers.mcpServers.manageokta.resourceServers.virtualMcpServers.manageokta.resourceServers.apiServers.manageokta.resourceServers.manageokta.aiAgents.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateClientAuthSettings","name":"Update client authentication settings","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update client authentication settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.clientAuthSettings.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates mutable fields of the client authentication settings. Currently supports updating the name, client credentials, and the OAuth protocol configuration."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"clientAuthSettingsId","in":"path","schemaId":"schema_1999","description":"ID of the client authentication settings","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"components/schemas/ClientAuthSettingsPatchable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together"]}},"schemaId":"components/schemas/ClientAuthSettingsPatchable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together"],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"clientAuthSettingsId","in":"path","required":true,"example":"con1a2b3c4d5e6f7g8h9","schemaId":"schema_1999"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/merge-patch+json":{"schemaId":"components/schemas/ClientAuthSettingsPatchable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together"]}},"responseCodes":["200","400","403","404","429"],"pointer":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","href":"resourceserverclientauthsettings/updateclientauthsettings","openApiOperationId":"updateClientAuthSettings","summary":"Update client authentication settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/ClientAuthSettingsPatchable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together"],"mediaTypes":["application/merge-patch+json"],"mediaTypeSchemas":{"application/merge-patch+json":{"schemaId":"components/schemas/ClientAuthSettingsPatchable","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Client authentication settings successfully updated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for agent import"]}},"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for agent import"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for agent import"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClientAuthSettings","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)","paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for agent import"]}}},{"code":"400","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/400/content/application~1json/examples/API Validation Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/400/content/application~1json/examples/API Validation Failed"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}"},{"label":"Delete client authentication settings","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/deleteclientauthsettings","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/resourceserverclientauthsettings/deleteclientauthsettings","metadata":{"seo":{"title":"Delete client authentication settings","description":"BetaOAuth 2.0 scope:okta.resourceServers.clientAuthSettings.manageokta.resourceServers.mcpServers.manageokta.resourceServers.virtualMcpServers.manageokta.resourceServers.apiServers.manageokta.resourceServers.manageokta.aiAgents.manageAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteClientAuthSettings","name":"Delete client authentication settings","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete client authentication settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.clientAuthSettings.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.mcpServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.apiServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.manage"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.aiAgents.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes client authentication settings for a resource server"},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"clientAuthSettingsId","in":"path","schemaId":"schema_1999","description":"ID of the client authentication settings","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"clientAuthSettingsId","in":"path","required":true,"example":"con1a2b3c4d5e6f7g8h9","schemaId":"schema_1999"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["204","403","404","429"],"pointer":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","href":"resourceserverclientauthsettings/deleteclientauthsettings","openApiOperationId":"deleteClientAuthSettings","summary":"Delete client authentication settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Client authentication settings successfully deleted"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}"}],"content":{"contentType":"group","meta":{"name":"ResourceServerClientAuthSettings"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Client Authentication Settings","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Client Authentication Settings API provides management of client configuration for authenticating to third-party authorization servers. This can include the configuration of scopes that are requested from the third-party authorization server that the user must provide consent to, as well as the client credentials that are used to complete the authorization code flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API, which is available as a Beta release, is only available if you're subscribed to Okta for AI Agents. Contact Okta Support for more information."},"children":[]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/resource-servers/api/v1/client-auth-settings","summary":"List all client authentication settings","prefix":{"name":"get","color":"get"},"badges":[],"link":"/resourceserverclientauthsettings/listclientauthsettings","deprecated":false},{"title":"/resource-servers/api/v1/client-auth-settings","summary":"Create a client authentication settings","prefix":{"name":"post","color":"post"},"badges":[],"link":"/resourceserverclientauthsettings/createclientauthsettings","deprecated":false},{"title":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","summary":"Get client authentication settings","prefix":{"name":"get","color":"get"},"badges":[],"link":"/resourceserverclientauthsettings/getclientauthsettings","deprecated":false},{"title":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","summary":"Update client authentication settings","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/resourceserverclientauthsettings/updateclientauthsettings","deprecated":false},{"title":"/resource-servers/api/v1/client-auth-settings/{clientAuthSettingsId}","summary":"Delete client authentication settings","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/resourceserverclientauthsettings/deleteclientauthsettings","deprecated":false}]}]}]}]}},{"type":"group","label":"Virtual MCP Servers","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource","items":[{"label":"List all virtual MCP servers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/listvirtualmcpservers","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/listvirtualmcpservers","metadata":{"seo":{"title":"List all virtual MCP servers","description":"OAuth 2.0 scope:okta.resourceServers.virtualMcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listVirtualMCPServers","name":"List all virtual MCP servers","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all virtual MCP servers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all virtual MCP servers"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"x-lifecycle","attrs":{"className":"research"}},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"filter","in":"query","schemaId":"schema_2000","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filters virtual MCP servers with a filtering expression. This supports the following operators:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sw"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"co"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"eq"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operator for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile.displayName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This operation requires "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL encoding"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#special-characters"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Special characters"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"name":"expand","in":"query","schemaId":"schema_2001","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If specified, additional data is included on each item under an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_embedded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" attribute. The parameter accepts multiple values; repeat the parameter to request more than one (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=connectedResources&expand=attachedAgents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"connectedResources"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Adds "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_embedded.connectedResources"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a summary of the resource connections currently bound to the virtual MCP server. Full details are available at the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/VirtualMCPConnections/operation/listVirtualMCPConnections"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"connections list endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"attachedAgents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Adds "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_embedded.attachedAgents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a summary of the AI agents allow-listed to call the virtual MCP server. Full agent details are available at the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/AgentRegistration/operation/getAIAgent"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI agent get endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/virtual-mcp-servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"filter","in":"query","example":"profile.displayName sw \"Production\" and status eq \"ACTIVE\"","schemaId":"schema_2000"},{"name":"expand","in":"query","schemaId":"schema_2001"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","429"],"pointer":"/resource-servers/api/v1/virtual-mcp-servers","href":"virtualmcpserverresource/listvirtualmcpservers","openApiOperationId":"listVirtualMCPServers","summary":"List all virtual MCP servers"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2002","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/200/content/application~1json/examples/List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)"]}},"schemaId":"schema_2002","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/200/content/application~1json/examples/List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_2002","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/200/content/application~1json/examples/List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2002","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/200/content/application~1json/examples/List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/virtual-mcp-servers"},{"label":"Retrieve a virtual MCP server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/getvirtualmcpserver","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/getvirtualmcpserver","metadata":{"seo":{"title":"Retrieve a virtual MCP server","description":"OAuth 2.0 scope:okta.resourceServers.virtualMcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getVirtualMCPServer","name":"Retrieve a virtual MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a virtual MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a virtual MCP server by ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"x-lifecycle","attrs":{"className":"research"}},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"virtualMcpServerId","in":"path","schemaId":"schema_2003","description":"ID of a virtual MCP","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"virtualMcpServerId","in":"path","required":true,"example":"wlp1aB2cD3eF4gH5iJ6k","schemaId":"schema_2003"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}","href":"virtualmcpserverresource/getvirtualmcpserver","openApiOperationId":"getVirtualMCPServer","summary":"Retrieve a virtual MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VirtualMCPServerResource","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Active virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Inactive virtual MCP server"]}},"schemaId":"components/schemas/VirtualMCPServerResource","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Active virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Inactive virtual MCP server"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/VirtualMCPServerResource","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Active virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Inactive virtual MCP server"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VirtualMCPServerResource","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Active virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Inactive virtual MCP server"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}"},{"label":"List all tools for a virtual MCP server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/listvirtualmcpservertools","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/listvirtualmcpservertools","metadata":{"seo":{"title":"List all tools for a virtual MCP server","description":"OAuth 2.0 scope:okta.resourceServers.virtualMcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listVirtualMCPServerTools","name":"List all tools for a virtual MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all tools for a virtual MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all tools for a virtual MCP server."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=inputSchema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to embed the tool's input schema inline."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"x-lifecycle","attrs":{"className":"research"}},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"virtualMcpServerId","in":"path","schemaId":"schema_2003","description":"ID of a virtual MCP","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"after","in":"query","schemaId":"schema_1974","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The cursor to use for pagination. It is an opaque string that specifies your current location in the list and is obtained from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Link"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response header. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#pagination"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/#link-header"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link header"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"limit","in":"query","schemaId":"schema_1975","description":"A limit on the number of objects to return"},{"name":"expand","in":"query","schemaId":"schema_2004","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional expand parameter. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inputSchema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to embed the tool's input schema inline using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_embedded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property."},"children":[]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"virtualMcpServerId","in":"path","required":true,"example":"wlp1aB2cD3eF4gH5iJ6k","schemaId":"schema_2003"}],"query":[{"name":"after","in":"query","schemaId":"schema_1974"},{"name":"limit","in":"query","schemaId":"schema_1975"},{"name":"expand","in":"query","schemaId":"schema_2004"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools","href":"virtualmcpserverresource/listvirtualmcpservertools","openApiOperationId":"listVirtualMCPServerTools","summary":"List all tools for a virtual MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2005","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server with inputSchema expanded"]}},"schemaId":"schema_2005","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server with inputSchema expanded"],"headers":{"Link":{"required":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A link to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"self"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present if there is another page of results."},"children":[]}]}]}]}],"schema":{"type":"string"}}},"headerSchemaId":"schema_2006"},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_2005","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server with inputSchema expanded"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2005","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server with inputSchema expanded"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools"},{"label":"Retrieve a specific tool for a virtual MCP server","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/getvirtualmcpservertool","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/virtualmcpserverresource/getvirtualmcpservertool","metadata":{"seo":{"title":"Retrieve a specific tool for a virtual MCP server","description":"OAuth 2.0 scope:okta.resourceServers.virtualMcpServers.readAdmin roles:SUPER_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getVirtualMCPServerTool","name":"Retrieve a specific tool for a virtual MCP server","isWebhook":false,"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a specific tool for a virtual MCP server","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.resourceServers.virtualMcpServers.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"SUPER_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a single specific tool by its ID."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=inputSchema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to embed the tool's input schema inline."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"x-lifecycle","attrs":{"className":"research"}},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"virtualMcpServerId","in":"path","schemaId":"schema_2003","description":"ID of a virtual MCP","required":true},{"name":"capabilityId","in":"path","schemaId":"schema_2007","description":"ID of a specific capability on the virtual MCP server","required":true}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"expand","in":"query","schemaId":"schema_2004","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional expand parameter. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inputSchema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to embed the tool's input schema inline using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"_embedded"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property."},"children":[]}]}]}]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools/{capabilityId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"virtualMcpServerId","in":"path","required":true,"example":"wlp1aB2cD3eF4gH5iJ6k","schemaId":"schema_2003"},{"name":"capabilityId","in":"path","required":true,"example":"vsc1aB2cD3eF4gH5iJ6k","schemaId":"schema_2007"}],"query":[{"name":"expand","in":"query","schemaId":"schema_2004"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","403","404","429"],"pointer":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools/{capabilityId}","href":"virtualmcpserverresource/getvirtualmcpservertool","openApiOperationId":"getVirtualMCPServerTool","summary":"Retrieve a specific tool for a virtual MCP server"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2008","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server with inputSchema expanded"]}},"schemaId":"schema_2008","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server with inputSchema expanded"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/403/content/application~1json/examples/Access Denied"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/403/content/application~1json/examples/Access Denied"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_2008","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server with inputSchema expanded"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_2008","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server","paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server with inputSchema expanded"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/403/content/application~1json/examples/Access Denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/403/content/application~1json/examples/Access Denied"]}}},{"code":"404","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools/{capabilityId}"}],"content":{"contentType":"group","meta":{"name":"VirtualMCPServerResource"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Virtual MCP Servers","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Virtual MCP Servers API provides operations for read access for virtual MCP servers registered as resource servers. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/mcp-servers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MCP Servers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" This API, which is available as a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/release-lifecycle/#research-release"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Research Release"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", is only available if you're subscribed to Okta for AI Agents. Contact Okta Support for more information."},"children":[]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/resource-servers/api/v1/virtual-mcp-servers","summary":"List all virtual MCP servers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/virtualmcpserverresource/listvirtualmcpservers","deprecated":false},{"title":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}","summary":"Retrieve a virtual MCP server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/virtualmcpserverresource/getvirtualmcpserver","deprecated":false},{"title":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools","summary":"List all tools for a virtual MCP server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/virtualmcpserverresource/listvirtualmcpservertools","deprecated":false},{"title":"/resource-servers/api/v1/virtual-mcp-servers/{virtualMcpServerId}/tools/{capabilityId}","summary":"Retrieve a specific tool for a virtual MCP server","prefix":{"name":"get","color":"get"},"badges":[],"link":"/virtualmcpserverresource/getvirtualmcpservertool","deprecated":false}]}]}]}]}},{"type":"separator","label":"STS Authorization","content":null},{"type":"group","label":"STSAuthorization","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/stsauthorization","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/stsauthorization","items":[{"label":"Handle the STS authorization response","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/stsauthorization/stsauthorizecallback","routeSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers/stsauthorization/stsauthorizecallback","metadata":{"seo":{"title":"Handle the STS authorization response","description":"Beta"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"stsAuthorizeCallback","name":"Handle the STS authorization response","isWebhook":false,"pointer":"/paths/~1oauth2~1v1~1sts~1callback/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Handle the STS authorization response","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Handles the authorization response from the external OAuth 2.0 authorization server in the Security Token Service (STS) authorization flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint is the OAuth 2.0 redirection endpoint for the STS flow and must be registered as a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"redirect_uri"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at the external authorization server."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The external authorization server redirects the user agent to this endpoint, with either an authorization "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Okta validates the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter, then exchanges the code for tokens to complete the STS connection."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requests to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/oauth2/v1/sts/callback"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint are browser redirects from the external authorization server. You can't use AJAX with this endpoint."},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"state","in":"query","schemaId":"schema_1974","description":"OAuth 2.0 state parameter for CSRF protection and session binding","required":true},{"name":"code","in":"query","schemaId":"schema_1974","description":"OAuth 2.0 authorization code returned on successful authorization"},{"name":"error","in":"query","schemaId":"schema_1974","description":"OAuth 2.0 error code returned on authorization failure"},{"name":"error_description","in":"query","schemaId":"schema_1974","description":"Human-readable description of the OAuth 2.0 error"},{"name":"error_uri","in":"query","schemaId":"schema_1974","description":"URI identifying a human-readable web page with information about the OAuth 2.0 error"}],"pointer":"/paths/~1oauth2~1v1~1sts~1callback/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/oauth2/v1/sts/callback","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"state","in":"query","required":true,"schemaId":"schema_1974"},{"name":"code","in":"query","required":false,"schemaId":"schema_1974"},{"name":"error","in":"query","required":false,"schemaId":"schema_1974"},{"name":"error_description","in":"query","required":false,"schemaId":"schema_1974"},{"name":"error_uri","in":"query","required":false,"schemaId":"schema_1974"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","429"],"pointer":"/oauth2/v1/sts/callback","href":"stsauthorization/stsauthorizecallback","openApiOperationId":"stsAuthorizeCallback","summary":"Handle the STS authorization response"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"HTML page rendered to the browser that indicates the result of the STS authorization callback.","mediaType":"text/html","mediaTypes":["text/html"],"mediaTypeContent":{"text/html":{"schemaId":"schema_1974"}},"schemaId":"schema_1974"},{"code":"429","description":"Too Many Requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1oauth2~1v1~1sts~1callback/get/responses/429/content/application~1json/examples/Too Many Requests"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1oauth2~1v1~1sts~1callback/get/responses/429/content/application~1json/examples/Too Many Requests"]}],"pointer":"/paths/~1oauth2~1v1~1sts~1callback/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_1974","mediaTypes":["text/html"],"mediaTypeContent":{"text/html":{"schemaId":"schema_1974"}}},{"code":"429","schemaId":"components/schemas/Error","exampleIds":["paths/~1oauth2~1v1~1sts~1callback/get/responses/429/content/application~1json/examples/Too Many Requests"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1oauth2~1v1~1sts~1callback/get/responses/429/content/application~1json/examples/Too Many Requests"]}}}],"examples":[]}]}]}]},"httpPath":"/oauth2/v1/sts/callback"}],"content":{"contentType":"group","meta":{"name":"STSAuthorization"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"STSAuthorization","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/oauth2/v1/sts/callback","summary":"Handle the STS authorization response","prefix":{"name":"get","color":"get"},"badges":[],"link":"/stsauthorization/stsauthorizecallback","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/A2AServer":{"id":"components/schemas/A2AServer","kind":"json-schema","title":"A2AServer","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An A2A server represents the resource server identity of an AI agent in agent-to-agent deployments, identified by a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (resource URL). A2A servers are automatically created when an "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/openapi/okta-management/management/tag/AIAgentRegistration/"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI agent"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is registered with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourceUrl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and automatically deleted when the AI agent is deleted."},"children":[]}]}]}],"type":"object","properties":{"a2aServerId":{"type":"string","description":"Unique ID for the A2A server. This is the same as the associated AI agent ID.","readOnly":true,"example":"wlpx9jQ16k9V8IFEL0g3"},"created":{"type":"string","format":"date-time","description":"Timestamp when the A2A server was created","readOnly":true,"example":"2025-01-27T08:00:00Z"},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the A2A server was last updated","readOnly":true,"example":"2025-01-29T10:00:00Z"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the A2A server. The A2A server shares the same primary key as its associated AI agent."},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:directory:00o5rb5mt2H3d1TJd0h7:resource-servers:a2a:wlpx9jQ16k9V8IFEL0g3"},"resourceUrl":{"type":"string","description":"The resource URL for the A2A server","readOnly":true,"example":"https://demo-agent.example.com"},"_links":{"$ref":"#/components/schemas/A2AServerLinks"}},"required":["a2aServerId","orn","resourceUrl","created","lastUpdated","_links"]}},"components/schemas/A2AServerAuthorizationServer":{"id":"components/schemas/A2AServerAuthorizationServer","kind":"json-schema","title":"A2AServerAuthorizationServer","data":{"allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServer"},{"additionalProperties":true,"type":"object"}]}},"components/schemas/A2AServerHrefObjectAIAgentLink":{"id":"components/schemas/A2AServerHrefObjectAIAgentLink","kind":"json-schema","title":"A2AServerHrefObjectAIAgentLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the associated AI agent"}]}},"components/schemas/A2AServerHrefObjectAuthorizationServersLink":{"id":"components/schemas/A2AServerHrefObjectAuthorizationServersLink","kind":"json-schema","title":"A2AServerHrefObjectAuthorizationServersLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the authorization servers for the A2A server"}]}},"components/schemas/A2AServerHrefObjectParentLink":{"id":"components/schemas/A2AServerHrefObjectParentLink","kind":"json-schema","title":"A2AServerHrefObjectParentLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the parent A2A server"}]}},"components/schemas/A2AServerLinks":{"id":"components/schemas/A2AServerLinks","kind":"json-schema","title":"A2AServerLinks","data":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"type":"object","properties":{"ai-agent":{"$ref":"#/components/schemas/A2AServerHrefObjectAIAgentLink"},"authorization-servers":{"$ref":"#/components/schemas/A2AServerHrefObjectAuthorizationServersLink"}}}]}},"components/schemas/AddA2AServerAuthorizationServerRequest":{"id":"components/schemas/AddA2AServerAuthorizationServerRequest","kind":"json-schema","title":"AddA2AServerAuthorizationServerRequest","data":{"description":"Request to add an Okta custom authorization server. Provide the ORN of an existing\ncustom authorization server in your org. Okta resolves metadata automatically.","type":"object","properties":{"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of an existing Okta custom authorization server"},"children":[]}]}]}],"example":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"type":{"type":"string","enum":["OKTA"],"x-enumDescriptions":{"OKTA":"An Okta custom authorization server resolved from the org"},"example":"OKTA"}},"required":["type","orn"]}},"components/schemas/AddApiServerAuthorizationServerRequest":{"id":"components/schemas/AddApiServerAuthorizationServerRequest","kind":"json-schema","title":"AddApiServerAuthorizationServerRequest","data":{"description":"Request to add an external authorization server. Provide the issuer URI\nand all required endpoint metadata manually.","type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri","description":"URL of the authorization endpoint","example":"https://auth.external.com/oauth/authorize"},"grantTypesSupported":{"type":"array","description":"OAuth 2.0 grant types supported by this authorization server","items":{"type":"string"},"example":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"issuer":{"type":"string","format":"uri","description":"OAuth 2.0 issuer identifier for the authorization server","example":"https://auth.external.com"},"tokenEndpoint":{"type":"string","format":"uri","description":"URL of the token endpoint","example":"https://auth.external.com/oauth/token"},"type":{"type":"string","enum":["MANUAL"],"x-enumDescriptions":{"MANUAL":"An external authorization server with manually provided metadata"},"example":"MANUAL"}},"required":["type","issuer","authorizationEndpoint","tokenEndpoint"]}},"components/schemas/AddAuthorizationServerRequest":{"id":"components/schemas/AddAuthorizationServerRequest","kind":"json-schema","title":"AddAuthorizationServerRequest","data":{"oneOf":[{"$ref":"#/components/schemas/AddOktaAuthorizationServerRequest"},{"$ref":"#/components/schemas/AddDiscoverableAuthorizationServerRequest"},{"$ref":"#/components/schemas/AddManualAuthorizationServerRequest"}],"discriminator":{"propertyName":"type","mapping":{"OKTA":"#/components/schemas/AddOktaAuthorizationServerRequest","DISCOVERABLE":"#/components/schemas/AddDiscoverableAuthorizationServerRequest","MANUAL":"#/components/schemas/AddManualAuthorizationServerRequest"}}}},"components/schemas/AddDiscoverableAuthorizationServerRequest":{"id":"components/schemas/AddDiscoverableAuthorizationServerRequest","kind":"json-schema","title":"AddDiscoverableAuthorizationServerRequest","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to add a discoverable authorization server. Provide the issuer URI, and Okta"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"auto-resolves metadata from the issuer's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-authorization-server"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"type":"object","properties":{"issuer":{"type":"string","format":"uri","description":"OAuth 2.0 issuer identifier for the authorization server","example":"https://auth.example.com"},"type":{"type":"string","enum":["DISCOVERABLE"],"x-enumDescriptions":{"DISCOVERABLE":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An authorization server whose metadata is resolved automatically through the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" discovery endpoint"},"children":[]}]}]}]},"example":"DISCOVERABLE"}},"required":["type","issuer"]}},"components/schemas/AddMCPServerAuthorizationServerRequest":{"id":"components/schemas/AddMCPServerAuthorizationServerRequest","kind":"json-schema","title":"AddMCPServerAuthorizationServerRequest","data":{"allOf":[{"$ref":"#/components/schemas/AddManualAuthorizationServerRequest"},{"type":"object"}]}},"components/schemas/AddManualAuthorizationServerRequest":{"id":"components/schemas/AddManualAuthorizationServerRequest","kind":"json-schema","title":"AddManualAuthorizationServerRequest","data":{"description":"Request to add an external authorization server. Provide the issuer URI\nand all required endpoint metadata manually.","type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri","description":"URL of the authorization endpoint","example":"https://auth.external.com/oauth/authorize"},"grantTypesSupported":{"type":"array","description":"OAuth 2.0 grant types supported by this authorization server","items":{"type":"string"},"example":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"issuer":{"type":"string","format":"uri","description":"OAuth 2.0 issuer identifier for the authorization server","example":"https://auth.external.com"},"tokenEndpoint":{"type":"string","format":"uri","description":"URL of the token endpoint","example":"https://auth.external.com/oauth/token"},"type":{"type":"string","enum":["MANUAL"],"x-enumDescriptions":{"MANUAL":"An external authorization server with manually provided metadata"},"example":"MANUAL"}},"required":["type","issuer","authorizationEndpoint","tokenEndpoint"]}},"components/schemas/AddOktaAuthorizationServerRequest":{"id":"components/schemas/AddOktaAuthorizationServerRequest","kind":"json-schema","title":"AddOktaAuthorizationServerRequest","data":{"description":"Request to add an Okta custom authorization server. Provide the ORN of an existing\ncustom authorization server in your org. Okta resolves metadata automatically.","type":"object","properties":{"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of an existing Okta custom authorization server"},"children":[]}]}]}],"example":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"type":{"type":"string","enum":["OKTA"],"x-enumDescriptions":{"OKTA":"An Okta custom authorization server resolved from the org"},"example":"OKTA"}},"required":["type","orn"]}},"components/schemas/AddVirtualMCPServerAuthorizationServerRequest":{"id":"components/schemas/AddVirtualMCPServerAuthorizationServerRequest","kind":"json-schema","title":"AddVirtualMCPServerAuthorizationServerRequest","data":{"description":"Request to add an Okta custom authorization server. Provide the ORN of an existing\ncustom authorization server in your org. Okta resolves metadata automatically.","type":"object","properties":{"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of an existing Okta custom authorization server"},"children":[]}]}]}],"example":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"type":{"type":"string","enum":["OKTA"],"x-enumDescriptions":{"OKTA":"An Okta custom authorization server resolved from the org"},"example":"OKTA"}},"required":["type","orn"]}},"components/schemas/AgentSettings":{"id":"components/schemas/AgentSettings","kind":"json-schema","title":"AgentSettings","data":{"type":"object","properties":{"features":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enabled feature indicators for this domain. Values might be added or removed without notice. Clients "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" build business logic that depends on the presence of specific values."},"children":[]}]}]}],"items":{"type":"string"}},"maxAgents":{"type":"integer","description":"Maximum number of AI agents allowed for this org"},"supportedConnectionTypes":{"type":"array","items":{"type":"string"}},"supportedPlatforms":{"type":"array","items":{"type":"string"}}}}},"components/schemas/ApiServer":{"id":"components/schemas/ApiServer","kind":"json-schema","title":"ApiServer","data":{"description":"Third-party API server","type":"object","properties":{"created":{"type":"string","format":"date-time","description":"Timestamp when the API server was created","readOnly":true,"example":"2025-01-29T10:00:00.000Z"},"id":{"type":"string","description":"Unique identifier for the API server","readOnly":true,"example":"api8nUa7p0g4zrZbs2f4"},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the API server was last updated","readOnly":true,"example":"2025-01-29T10:00:00.000Z"},"metadata":{"$ref":"#/components/schemas/ApiServerMetadata"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the API server"},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4"},"resourceUrl":{"type":"string","format":"uri","description":"The URL of the API server","example":"https://api.example.com"},"status":{"$ref":"#/components/schemas/ResourceServerStatus"},"_embedded":{"readOnly":true,"type":"object","description":"Embedded resources associated with the API server","properties":{"counts":{"type":"object","description":"Counts of resources associated with the API server","readOnly":true,"properties":{"authorizationServers":{"type":"integer","format":"int32","minimum":0,"description":"Number of authorization servers linked to the API server","readOnly":true,"example":2},"clientAuthSettings":{"type":"integer","format":"int32","minimum":0,"description":"Number of client authentication settings associated with the API server","readOnly":true,"example":5}}}}},"_links":{"$ref":"#/components/schemas/ApiServerLinks"}},"required":["id","orn","resourceUrl","status","created","lastUpdated","metadata","_links"]}},"components/schemas/ApiServerAuthorizationServer":{"id":"components/schemas/ApiServerAuthorizationServer","kind":"json-schema","title":"ApiServerAuthorizationServer","data":{"allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServer"},{"additionalProperties":true,"type":"object"}]}},"components/schemas/ApiServerHrefObjectAuthorizationServersLink":{"id":"components/schemas/ApiServerHrefObjectAuthorizationServersLink","kind":"json-schema","title":"ApiServerHrefObjectAuthorizationServersLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the authorization servers for the resource"}]}},"components/schemas/ApiServerHrefObjectParentLink":{"id":"components/schemas/ApiServerHrefObjectParentLink","kind":"json-schema","title":"ApiServerHrefObjectParentLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the parent resource"}]}},"components/schemas/ApiServerLinks":{"id":"components/schemas/ApiServerLinks","kind":"json-schema","title":"ApiServerLinks","data":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"type":"object","properties":{"authorization-servers":{"$ref":"#/components/schemas/ApiServerHrefObjectAuthorizationServersLink"}}}]}},"components/schemas/ApiServerMetadata":{"id":"components/schemas/ApiServerMetadata","kind":"json-schema","title":"ApiServerMetadata","data":{"description":"Metadata about the resource server. Includes admin-editable fields and, for discovered\nservers, auto-detected read-only fields.","type":"object","properties":{"description":{"$ref":"#/components/schemas/ResourceServerDescription"},"displayName":{"$ref":"#/components/schemas/ResourceServerDisplayName"}}}},"components/schemas/ApiServersSettings":{"id":"components/schemas/ApiServersSettings","kind":"json-schema","title":"ApiServersSettings","data":{"type":"object","properties":{"features":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enabled feature indicators for this domain. Values might be added or removed without notice. Clients "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" build business logic that depends on the presence of specific values."},"children":[]}]}]}],"items":{"type":"string"}},"maxApiServers":{"type":"integer","description":"Maximum number of API servers allowed for this org"},"maxAuthServersPerApiServer":{"type":"integer","description":"Maximum number of authorization servers per API server"},"maxClientAuthSettingsPerApiServer":{"type":"integer","description":"Maximum number of client authentication settings per API server"}}}},"components/schemas/AppResourceAuthorizationServer":{"id":"components/schemas/AppResourceAuthorizationServer","kind":"json-schema","title":"AppResourceAuthorizationServer","data":{"description":"The external authorization server created for the app instance","type":"object","properties":{"issuer":{"type":"string","format":"uri","description":"OAuth 2.0 issuer identifier for the authorization server","readOnly":true,"example":"https://auth.example.com"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the external authorization server"},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4"},"status":{"type":"string","description":"Current status of the authorization server","readOnly":true,"example":"ACTIVE"},"_links":{"$ref":"#/components/schemas/LinksSelf"}},"required":["orn","issuer","status","_links"]}},"components/schemas/AppResourceAuthorizationServerRequest":{"id":"components/schemas/AppResourceAuthorizationServerRequest","kind":"json-schema","title":"AppResourceAuthorizationServerRequest","data":{"description":"The external authorization server to create for the app instance","type":"object","properties":{"issuer":{"type":"string","format":"uri","description":"OAuth 2.0 issuer identifier for the authorization server","example":"https://auth.example.com"}},"required":["issuer"]}},"components/schemas/AppResourceRegistration":{"id":"components/schemas/AppResourceRegistration","kind":"json-schema","title":"AppResourceRegistration","data":{"description":"The external resource server and external authorization server registered for an app instance","type":"object","properties":{"authorizationServer":{"$ref":"#/components/schemas/AppResourceAuthorizationServer"},"resource":{"$ref":"#/components/schemas/AppResourceServer"},"tenantId":{"type":"string","description":"Tenant identifier for the app instance's authorization server","readOnly":true,"example":"tenant-123"},"_links":{"$ref":"#/components/schemas/LinksSelf"}},"required":["resource","authorizationServer","_links"]}},"components/schemas/AppResourceServer":{"id":"components/schemas/AppResourceServer","kind":"json-schema","title":"AppResourceServer","data":{"description":"The external resource server created for the app instance","type":"object","properties":{"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the resource server"},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4"},"resourceUrl":{"type":"string","format":"uri","description":"The URL of the resource server","readOnly":true,"example":"https://api.example.com"},"status":{"type":"string","description":"Current status of the resource server","readOnly":true,"example":"ACTIVE"},"type":{"$ref":"#/components/schemas/AppResourceServerType"},"_links":{"$ref":"#/components/schemas/LinksSelf"}},"required":["type","orn","resourceUrl","status","_links"]}},"components/schemas/AppResourceServerRequest":{"id":"components/schemas/AppResourceServerRequest","kind":"json-schema","title":"AppResourceServerRequest","data":{"description":"The external resource server to create for the app instance","type":"object","properties":{"resourceUrl":{"type":"string","format":"uri","description":"The URL of the resource server","example":"https://api.example.com"}},"required":["resourceUrl"]}},"components/schemas/AppResourceServerType":{"id":"components/schemas/AppResourceServerType","kind":"json-schema","title":"AppResourceServerType","data":{"description":"The type of resource server created for the app instance","example":"API_SERVER","type":"string","enum":["API_SERVER"],"x-enumDescriptions":{"API_SERVER":"An external API server"}}},"components/schemas/AuthorizationServerDetectedMetadata":{"id":"components/schemas/AuthorizationServerDetectedMetadata","kind":"json-schema","title":"AuthorizationServerDetectedMetadata","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Auto-detected metadata about the authorization server from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-authorization-server"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These fields are read-only and automatically populated during metadata refresh operations."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServerMetadata"},{"type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri","description":"URL of the authorization endpoint. This property is detected automatically.","readOnly":true,"example":"https://github.com/login/oauth/authorize"},"grantTypesSupported":{"type":"array","items":{"type":"string"},"description":"OAuth 2.0 grant types supported by this authorization server. This property is detected automatically.","readOnly":true,"example":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:token-exchange"]},"identityChainingRequestedTokenTypesSupported":{"type":"array","description":"Token types supported for identity chaining requested tokens. This property is detected automatically.","readOnly":true,"items":{"type":"string"},"example":["urn:ietf:params:oauth:token-type:id-jag"]},"registrationEndpoint":{"type":"string","format":"uri","description":"URL of the OAuth 2.0 Dynamic Client Registration endpoint. This property is detected automatically.","readOnly":true,"example":"https://github.com/login/oauth/register"},"tokenEndpoint":{"type":"string","format":"uri","description":"URL of the token endpoint. This property is detected automatically.","readOnly":true,"example":"https://github.com/login/oauth/access_token"},"tokenEndpointAuthMethodsSupported":{"type":"array","description":"Client authentication methods supported by the token endpoint. This property is detected automatically.","readOnly":true,"items":{"type":"string"},"example":["client_secret_basic","client_secret_post"]}}}]}},"components/schemas/AuthorizationServerType":{"id":"components/schemas/AuthorizationServerType","kind":"json-schema","title":"AuthorizationServerType","data":{"description":"The type of authorization server","type":"string","enum":["DISCOVERABLE","MANUAL","OKTA"],"x-enumDescriptions":{"OKTA":"An Okta authorization server resolved from the org","DISCOVERABLE":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An authorization server whose metadata is resolved automatically through the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" discovery endpoint"},"children":[]}]}]}],"MANUAL":"An external authorization server with manually provided metadata"}}},"components/schemas/ClientAuthSettings":{"id":"components/schemas/ClientAuthSettings","kind":"json-schema","title":"ClientAuthSettings","data":{"description":"Client authentication settings for resource servers","additionalProperties":false,"type":"object","properties":{"authorizationServerOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of an authorization server associated with the resource. This field is required for resources that may be associated with multiple authorization servers, such as MCP servers."},"children":[]}]}]}],"example":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4"},"clientCredentials":{"$ref":"#/components/schemas/ClientCredentialsResponse","description":"OAuth client credentials (the credential value is never returned)"},"created":{"type":"string","format":"date-time","description":"Timestamp when the client authentication settings were created","example":"2024-01-29T10:30:00.000Z","readOnly":true},"id":{"type":"string","description":"Unique identifier for the client authentication settings","example":"con1a2b3c4d5e6f7g8h9","readOnly":true},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the client authentication settings were last updated","example":"2024-01-29T10:30:00.000Z","readOnly":true},"name":{"$ref":"#/components/schemas/ClientAuthSettingsName"},"oauthConfiguration":{"type":"object","description":"OAuth protocol configuration for the connection.\nThis is present when the integration requires OAuth settings beyond client credentials, such as scopes.","properties":{"scopes":{"type":"array","items":{"type":"string"},"description":"OAuth scopes to request when obtaining tokens. Required if the integration supports scopes.","example":["api:read","api:write"]}}},"protocol":{"$ref":"#/components/schemas/ClientAuthSettingsProtocol"},"purpose":{"$ref":"#/components/schemas/ClientAuthSettingsPurpose"},"registrationMethod":{"$ref":"#/components/schemas/ClientAuthSettingsRegistrationMethod"},"resourceOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the target entity. This entity both provides authorization server resolution information and represents the consumer of the resultant OAuth tokens. Only entities which support STS connections or agent import may be referenced."},"children":[]}]}]}],"example":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7"},"_links":{"type":"object","description":"Specifies link relations available for the client authentication settings","required":["self"],"properties":{"self":{"$ref":"#/components/schemas/HrefObjectSelfLink","description":"Link to the client authentication settings"}}}},"required":["id","purpose","protocol","resourceOrn","registrationMethod","created","lastUpdated","_links"]}},"components/schemas/ClientAuthSettingsCreatable":{"id":"components/schemas/ClientAuthSettingsCreatable","kind":"json-schema","title":"ClientAuthSettingsCreatable","data":{"description":"Create new client authentication settings","type":"object","properties":{"authorizationServerOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of an authorization server associated with the resource. This field is required for resources that may be associated with multiple authorization servers, such as MCP servers."},"children":[]}]}]}],"example":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4"},"clientCredentials":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth client credentials. Required for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"STATIC"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" registration. When present, both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"clientId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"clientSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be supplied."},"children":[]}]}]}],"required":["clientId","clientSecret"],"properties":{"clientId":{"type":"string","description":"OAuth client ID","example":"0oa1gjh63g214q0Hq0g4"},"clientSecret":{"type":"string","format":"password","writeOnly":true,"description":"OAuth client secret (write-only, never returned in responses)","example":"secret-string-that-will-not-be-returned-in-responses"}}},"name":{"$ref":"#/components/schemas/ClientAuthSettingsName"},"oauthConfiguration":{"type":"object","description":"OAuth protocol configuration for the connection.\nThis is required for integrations that need OAuth settings beyond client credentials, such as scopes.\nOmit for integrations that don't require additional protocol configuration.","properties":{"scopes":{"type":"array","nullable":true,"minItems":1,"items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth scopes to request when obtaining tokens. If provided, the array must contain at least one scope."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to clear scopes (only valid for integrations that don't require scopes)."},"children":[]}]}]}],"example":["api:read","api:write"]}}},"protocol":{"$ref":"#/components/schemas/ClientAuthSettingsProtocol"},"purpose":{"$ref":"#/components/schemas/ClientAuthSettingsPurpose"},"registrationMethod":{"$ref":"#/components/schemas/ClientAuthSettingsRegistrationMethod"},"resourceOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the target entity. This entity both provides authorization server resolution information and represents the consumer of the resultant OAuth tokens. Only entities which support STS connections or agent import may be referenced."},"children":[]}]}]}],"example":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7"}},"required":["purpose","protocol","resourceOrn"]}},"components/schemas/ClientAuthSettingsList":{"id":"components/schemas/ClientAuthSettingsList","kind":"json-schema","title":"ClientAuthSettingsList","data":{"type":"object","properties":{"data":{"type":"array","description":"Array of client authentication settings","items":{"$ref":"#/components/schemas/ClientAuthSettings"}},"_links":{"type":"object","description":"Specifies link relations for pagination","properties":{"self":{"$ref":"#/components/schemas/HrefObjectSelfLink","description":"Link to the current page"},"next":{"$ref":"#/components/schemas/HrefObjectNextLink","description":"Link to the next page (if available)"}}}},"required":["data"]}},"components/schemas/ClientAuthSettingsName":{"id":"components/schemas/ClientAuthSettingsName","kind":"json-schema","title":"ClientAuthSettingsName","data":{"description":"A human-readable name for this client authentication settings connection. Once set, the name cannot be cleared or set to null. This is required for MCP server and API server resources.","minLength":1,"maxLength":256,"example":"My Server Connection","type":"string"}},"components/schemas/ClientAuthSettingsPatchable":{"id":"components/schemas/ClientAuthSettingsPatchable","kind":"json-schema","title":"ClientAuthSettingsPatchable","data":{"description":"Partial update for client authentication settings. Mutable fields include the name, client credentials, and the OAuth protocol configuration.","type":"object","properties":{"clientCredentials":{"$ref":"#/components/schemas/ClientCredentialsPatchable"},"name":{"$ref":"#/components/schemas/ClientAuthSettingsName"},"oauthConfiguration":{"type":"object","nullable":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth protocol configuration for the connection."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to remove the configuration entirely."},"children":[]}]}]}],"properties":{"scopes":{"type":"array","nullable":true,"minItems":1,"items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth scopes to request when obtaining tokens. If provided, the array must contain at least one scope."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to clear scopes (only valid for integrations that don't require scopes)."},"children":[]}]}]}],"example":["api:read","api:write"]}}}}}},"components/schemas/ClientAuthSettingsProtocol":{"id":"components/schemas/ClientAuthSettingsProtocol","kind":"json-schema","title":"ClientAuthSettingsProtocol","data":{"description":"The authentication protocol used for this connection. Currently only OAuth 2.0 is supported. This field is immutable and can't be changed after creation.","type":"string","enum":["OAUTH2"],"x-enumDescriptions":{"OAUTH2":"OAuth 2.0 protocol for client authentication"}}},"components/schemas/ClientAuthSettingsPurpose":{"id":"components/schemas/ClientAuthSettingsPurpose","kind":"json-schema","title":"ClientAuthSettingsPurpose","data":{"description":"The purpose of the client authentication settings. Currently, this is constrained to a single value. This field is immutable and cannot be changed after creation.","minItems":1,"maxItems":1,"items":{"type":"string","enum":["STS","AGENT_IMPORT"],"x-enumDescriptions":{"STS":"Security Token Service (STS). Okta obtains tokens on behalf of end users and vends them to other clients.","AGENT_IMPORT":"Agent import. Okta acts as a client to import agents from third-party systems."}},"type":"array"}},"components/schemas/ClientAuthSettingsRegistrationMethod":{"id":"components/schemas/ClientAuthSettingsRegistrationMethod","kind":"json-schema","title":"ClientAuthSettingsRegistrationMethod","data":{"description":"How the OAuth client credentials for this connection are registered. This field is immutable and can't be changed after creation.","default":"STATIC","type":"string","enum":["DCR","STATIC"],"x-enumDescriptions":{"STATIC":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The admin supplies the client credentials obtained from the provider. Creation is synchronous and returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"201"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"DCR":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Okta obtains the credentials on the admin's behalf through "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://datatracker.ietf.org/doc/html/rfc7591"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dynamic Client Registration"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" against the resource's authorization server. Creation is asynchronous and returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"202"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header to poll for completion."},"children":[]}]}]}]}}},"components/schemas/ClientAuthSettingsStatus":{"id":"components/schemas/ClientAuthSettingsStatus","kind":"json-schema","title":"ClientAuthSettingsStatus","data":{"description":"Status of the client authentication settings","type":"string","enum":["ACTIVE","INACTIVE"]}},"components/schemas/ClientCredentialsPatchable":{"id":"components/schemas/ClientCredentialsPatchable","kind":"json-schema","title":"ClientCredentialsPatchable","data":{"description":"Client credentials for updating the client secret","type":"object","properties":{"clientSecret":{"type":"string","format":"password","writeOnly":true,"description":"The new OAuth client secret. This property is write-only and is never returned in responses.","example":"new-rotated-secret-value"}},"required":["clientSecret"]}},"components/schemas/ClientCredentialsResponse":{"id":"components/schemas/ClientCredentialsResponse","kind":"json-schema","title":"ClientCredentialsResponse","data":{"description":"Client credentials in response (no secrets returned)","type":"object","properties":{"clientId":{"type":"string","description":"OAuth client ID","example":"0oa1gjh63g214q0Hq0g4"}},"required":["clientId"]}},"components/schemas/CreateApiServerRequest":{"id":"components/schemas/CreateApiServerRequest","kind":"json-schema","title":"CreateApiServerRequest","data":{"allOf":[{"$ref":"#/components/schemas/CreateResourceServerRequestBase"},{"type":"object"}]}},"components/schemas/CreateMCPServerRequest":{"id":"components/schemas/CreateMCPServerRequest","kind":"json-schema","title":"CreateMCPServerRequest","data":{"allOf":[{"$ref":"#/components/schemas/CreateResourceServerRequestBase"},{"type":"object","required":[]}]}},"components/schemas/CreateResourceServerRequestBase":{"id":"components/schemas/CreateResourceServerRequestBase","kind":"json-schema","title":"CreateResourceServerRequestBase","data":{"description":"Base properties for registering a third-party resource server","type":"object","properties":{"description":{"$ref":"#/components/schemas/ResourceServerDescription"},"displayName":{"$ref":"#/components/schemas/ResourceServerDisplayName"},"resourceUrl":{"type":"string","format":"uri","description":"The URL of the resource server","example":"https://api.example.com"}},"required":["resourceUrl"]}},"components/schemas/DiscoverMCPServerClientAuthRequest":{"id":"components/schemas/DiscoverMCPServerClientAuthRequest","kind":"json-schema","title":"DiscoverMCPServerClientAuthRequest","data":{"description":"Request to discover MCP server capabilities using OAuth client authentication","type":"object","properties":{"clientAuthSettingsOrn":{"type":"string","description":"The Okta Resource Name (ORN) of the client auth settings to use for OAuth authentication when connecting to the MCP server","example":"orn:okta:idp:00o1n8sbwArJ7OQRw406:client_auth_settings:rsc2c8xwvBn4h2Ry50g7"},"type":{"type":"string","enum":["CLIENT_AUTH_SETTINGS"],"x-enumDescriptions":{"CLIENT_AUTH_SETTINGS":"OAuth-based authentication using configured client auth settings"},"description":"Authentication type discriminator","example":"CLIENT_AUTH_SETTINGS"}},"required":["type","clientAuthSettingsOrn"]}},"components/schemas/DiscoverMCPServerIdentityAssertionRequest":{"id":"components/schemas/DiscoverMCPServerIdentityAssertionRequest","kind":"json-schema","title":"DiscoverMCPServerIdentityAssertionRequest","data":{"description":"Request to discover MCP server capabilities using identity assertion","type":"object","properties":{"type":{"type":"string","enum":["IDENTITY_ASSERTION"],"x-enumDescriptions":{"IDENTITY_ASSERTION":"Direct identity assertion without additional OAuth configuration"},"description":"Authentication type discriminator","example":"IDENTITY_ASSERTION"}},"required":["type"]}},"components/schemas/DiscoverMCPServerRequest":{"id":"components/schemas/DiscoverMCPServerRequest","kind":"json-schema","title":"DiscoverMCPServerRequest","data":{"description":"Request to initiate discovery for an MCP server","oneOf":[{"$ref":"#/components/schemas/DiscoverMCPServerClientAuthRequest"},{"$ref":"#/components/schemas/DiscoverMCPServerIdentityAssertionRequest"}],"discriminator":{"propertyName":"type","mapping":{"CLIENT_AUTH_SETTINGS":"#/components/schemas/DiscoverMCPServerClientAuthRequest","IDENTITY_ASSERTION":"#/components/schemas/DiscoverMCPServerIdentityAssertionRequest"}}}},"components/schemas/Error":{"id":"components/schemas/Error","kind":"json-schema","title":"Error","data":{"title":"Error","type":"object","properties":{"errorCauses":{"type":"array","items":{"$ref":"#/components/schemas/ErrorCause"}},"errorCode":{"type":"string","description":"An Okta code for this type of error"},"errorId":{"type":"string","description":"A unique identifier for this error. This can be used by Okta Support to help with troubleshooting."},"errorLink":{"type":"string","description":"An Okta code for this type of error"},"errorSummary":{"type":"string","description":"A short description of what caused this error. Sometimes this contains dynamically-generated information about your specific error."}}}},"components/schemas/ErrorCause":{"id":"components/schemas/ErrorCause","kind":"json-schema","title":"ErrorCause","data":{"type":"object","properties":{"errorSummary":{"type":"string"}}}},"components/schemas/HrefHints":{"id":"components/schemas/HrefHints","kind":"json-schema","title":"HrefHints","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Describes allowed HTTP verbs for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"href"},"children":[]}]}]}],"type":"object","properties":{"allow":{"type":"array","items":{"$ref":"#/components/schemas/HttpMethod"}}}}},"components/schemas/HrefObject":{"id":"components/schemas/HrefObject","kind":"json-schema","title":"Link Object","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"title":"Link Object","additionalProperties":true,"type":"object","properties":{"hints":{"$ref":"#/components/schemas/HrefHints","readOnly":true},"href":{"type":"string","description":"Link URI"},"name":{"type":"string","description":"Link name","readOnly":true},"templated":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the link object's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"href"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property is a URI template."},"children":[]}]}]}],"readOnly":true},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The media type of the link. If omitted, it is implicitly "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"readOnly":true}},"required":["href"]}},"components/schemas/HrefObjectActivateLink":{"id":"components/schemas/HrefObjectActivateLink","kind":"json-schema","title":"HrefObjectActivateLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to activate the resource"}]}},"components/schemas/HrefObjectAppLink":{"id":"components/schemas/HrefObjectAppLink","kind":"json-schema","title":"HrefObjectAppLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the app resource"}]}},"components/schemas/HrefObjectAssigneeLink":{"id":"components/schemas/HrefObjectAssigneeLink","kind":"json-schema","title":"HrefObjectAssigneeLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the assignee resource"}]}},"components/schemas/HrefObjectAuthorizationServersLink":{"id":"components/schemas/HrefObjectAuthorizationServersLink","kind":"json-schema","title":"HrefObjectAuthorizationServersLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the authorization servers for the resource"}]}},"components/schemas/HrefObjectBindingLink":{"id":"components/schemas/HrefObjectBindingLink","kind":"json-schema","title":"HrefObjectBindingLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the binding resource"}]}},"components/schemas/HrefObjectBindingsLink":{"id":"components/schemas/HrefObjectBindingsLink","kind":"json-schema","title":"HrefObjectBindingsLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the bindings resource"}]}},"components/schemas/HrefObjectClientLink":{"id":"components/schemas/HrefObjectClientLink","kind":"json-schema","title":"HrefObjectClientLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the client resource"}]}},"components/schemas/HrefObjectDeactivateLink":{"id":"components/schemas/HrefObjectDeactivateLink","kind":"json-schema","title":"HrefObjectDeactivateLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to deactivate the resource"}]}},"components/schemas/HrefObjectDeleteLink":{"id":"components/schemas/HrefObjectDeleteLink","kind":"json-schema","title":"HrefObjectDeleteLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to delete the resource"}]}},"components/schemas/HrefObjectDiscoveryLink":{"id":"components/schemas/HrefObjectDiscoveryLink","kind":"json-schema","title":"HrefObjectDiscoveryLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the per-credential discovery records for the resource"}]}},"components/schemas/HrefObjectGroupLink":{"id":"components/schemas/HrefObjectGroupLink","kind":"json-schema","title":"HrefObjectGroupLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the group resource"}]}},"components/schemas/HrefObjectLogoLink":{"id":"components/schemas/HrefObjectLogoLink","kind":"json-schema","title":"HrefObjectLogoLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the logo resource"}]}},"components/schemas/HrefObjectMappingsLink":{"id":"components/schemas/HrefObjectMappingsLink","kind":"json-schema","title":"HrefObjectMappingsLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the mappings resource"}]}},"components/schemas/HrefObjectMemberLink":{"id":"components/schemas/HrefObjectMemberLink","kind":"json-schema","title":"HrefObjectMemberLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the member resource"}]}},"components/schemas/HrefObjectMembersLink":{"id":"components/schemas/HrefObjectMembersLink","kind":"json-schema","title":"HrefObjectMembersLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the members resource"}]}},"components/schemas/HrefObjectNextLink":{"id":"components/schemas/HrefObjectNextLink","kind":"json-schema","title":"HrefObjectNextLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the next resource"}]}},"components/schemas/HrefObjectParentLink":{"id":"components/schemas/HrefObjectParentLink","kind":"json-schema","title":"HrefObjectParentLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the parent resource"}]}},"components/schemas/HrefObjectPermissionsLink":{"id":"components/schemas/HrefObjectPermissionsLink","kind":"json-schema","title":"HrefObjectPermissionsLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the permissions resource"}]}},"components/schemas/HrefObjectRefreshMetadataLink":{"id":"components/schemas/HrefObjectRefreshMetadataLink","kind":"json-schema","title":"HrefObjectRefreshMetadataLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to refresh metadata for the resource"}]}},"components/schemas/HrefObjectResourceSetLink":{"id":"components/schemas/HrefObjectResourceSetLink","kind":"json-schema","title":"HrefObjectResourceSetLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the resource set resource"}]}},"components/schemas/HrefObjectResourceSetResourcesLink":{"id":"components/schemas/HrefObjectResourceSetResourcesLink","kind":"json-schema","title":"HrefObjectResourceSetResourcesLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to resource set resources"}]}},"components/schemas/HrefObjectRoleLink":{"id":"components/schemas/HrefObjectRoleLink","kind":"json-schema","title":"HrefObjectRoleLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the role resource"}]}},"components/schemas/HrefObjectRulesLink":{"id":"components/schemas/HrefObjectRulesLink","kind":"json-schema","title":"HrefObjectRulesLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the rules resource"}]}},"components/schemas/HrefObjectSelfLink":{"id":"components/schemas/HrefObjectSelfLink","kind":"json-schema","title":"HrefObjectSelfLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the resource (self)"}]}},"components/schemas/HrefObjectSuspendLink":{"id":"components/schemas/HrefObjectSuspendLink","kind":"json-schema","title":"HrefObjectSuspendLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to suspend the resource"}]}},"components/schemas/HrefObjectToolsLink":{"id":"components/schemas/HrefObjectToolsLink","kind":"json-schema","title":"HrefObjectToolsLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the discovered tools for the resource"}]}},"components/schemas/HrefObjectUnsuspendLink":{"id":"components/schemas/HrefObjectUnsuspendLink","kind":"json-schema","title":"HrefObjectUnsuspendLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to unsuspend the resource"}]}},"components/schemas/HrefObjectUserLink":{"id":"components/schemas/HrefObjectUserLink","kind":"json-schema","title":"HrefObjectUserLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the user resource"}]}},"components/schemas/HrefObjectWebLink":{"id":"components/schemas/HrefObjectWebLink","kind":"json-schema","title":"HrefObjectWebLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the resource in the Okta Admin Console"}]}},"components/schemas/HttpMethod":{"id":"components/schemas/HttpMethod","kind":"json-schema","title":"HttpMethod","data":{"type":"string","enum":["DELETE","GET","POST","PUT"]}},"components/schemas/LinksNext":{"id":"components/schemas/LinksNext","kind":"json-schema","title":"LinksNext","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies link relations (see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://www.rfc-editor.org/rfc/rfc8288"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Web Linking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") available for the current status of an application using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://datatracker.ietf.org/doc/html/draft-kelly-json-hal-06"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON Hypertext Application Language"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" specification. Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"LinksNext"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object for dynamic discovery of related resources and lifecycle operations."},"children":[]}]}]}],"type":"object","properties":{"next":{"$ref":"#/components/schemas/HrefObjectNextLink"}},"readOnly":true}},"components/schemas/LinksSelf":{"id":"components/schemas/LinksSelf","kind":"json-schema","title":"LinksSelf","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies link relations (see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://www.rfc-editor.org/rfc/rfc8288"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Web Linking"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") available using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://datatracker.ietf.org/doc/html/draft-kelly-json-hal-06"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JSON Hypertext Application Language"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" specification. This object is used for dynamic discovery of related resources and lifecycle operations."},"children":[]}]}]}],"type":"object","properties":{"self":{"$ref":"#/components/schemas/HrefObjectSelfLink"}},"readOnly":true}},"components/schemas/LinksSelfAndLifecycle":{"id":"components/schemas/LinksSelfAndLifecycle","kind":"json-schema","title":"LinksSelfAndLifecycle","data":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"type":"object","properties":{"activate":{"$ref":"#/components/schemas/HrefObjectActivateLink"},"deactivate":{"$ref":"#/components/schemas/HrefObjectDeactivateLink"}}}]}},"components/schemas/MCPServer":{"id":"components/schemas/MCPServer","kind":"json-schema","title":"MCPServer","data":{"description":"Model Context Protocol (MCP) server resource","type":"object","properties":{"authorizationServerCount":{"type":"integer","description":"Number of authorization servers linked to this MCP server","readOnly":true,"example":2},"created":{"type":"string","format":"date-time","description":"Timestamp when the MCP server was created","readOnly":true,"example":"2025-01-29T10:00:00.000Z"},"detectedMetadata":{"$ref":"#/components/schemas/MCPServerDetectedMetadata"},"id":{"type":"string","description":"Unique identifier for the MCP server","readOnly":true,"example":"ems8nUa7p0g4zrZbs2f4"},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the MCP server was last updated","readOnly":true,"example":"2025-01-29T10:00:00.000Z"},"metadata":{"$ref":"#/components/schemas/MCPServerMetadata"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the MCP server"},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4"},"resourceUrl":{"type":"string","format":"uri","description":"The URL of the MCP server resource","example":"https://api.githubcopilot.com/mcp"},"status":{"$ref":"#/components/schemas/ResourceServerStatus"},"_links":{"$ref":"#/components/schemas/MCPServerLinks"}},"required":["id","orn","resourceUrl","status","created","lastUpdated","authorizationServerCount","metadata","_links"]}},"components/schemas/MCPServerAuthorizationServer":{"id":"components/schemas/MCPServerAuthorizationServer","kind":"json-schema","title":"MCPServerAuthorizationServer","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authorization server linked to an MCP server. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DISCOVERABLE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" authorization servers are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"automatically discovered from the MCP server's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-protected-resource"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"detectedMetadata"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DISCOVERABLE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServerBase"},{"type":"object","properties":{"detectedMetadata":{"$ref":"#/components/schemas/AuthorizationServerDetectedMetadata"},"metadata":{"$ref":"#/components/schemas/MCPServerAuthorizationServerMetadata"},"status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current status of the authorization server in its lifecycle."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DISCOVERABLE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" authorization servers, the status is managed automatically through the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-authorization-server"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint detection process."},"children":[]}]}]}],"enum":["INACTIVE","ACTIVE","INVALID"],"x-enumDescriptions":{"INACTIVE":"Server is inactive and ready to be activated","ACTIVE":"Server is active and operational with verified connectivity","INVALID":"Server configuration is invalid or validation failed"},"example":"ACTIVE"}}}]}},"components/schemas/MCPServerAuthorizationServerMetadata":{"id":"components/schemas/MCPServerAuthorizationServerMetadata","kind":"json-schema","title":"MCPServerAuthorizationServerMetadata","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Metadata about the authorization server. For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MANUAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" authorization servers, these fields are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"provided as input."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServerMetadata"},{"type":"object"}]}},"components/schemas/MCPServerCatalogAuthorizationServer":{"id":"components/schemas/MCPServerCatalogAuthorizationServer","kind":"json-schema","title":"MCPServerCatalogAuthorizationServer","data":{"description":"Suggested authorization server configuration for the catalog entry","type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri-template","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the authorization endpoint. May contain templated placeholders (for example,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{instance}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") that correspond to entries in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orgConfigProperties"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://{instance}.auth.okta.com"},"authorizationServerGlobalId":{"type":"string","description":"Global identifier of the authorization server in the catalog source","example":"8a2c1e4f-9b3d-4c7a-b1e5-6f0d3a8c2e7d"},"issuer":{"type":"string","format":"uri-template","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the issuer endpoint. May contain templated placeholders (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{instance}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that correspond to entries in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orgConfigProperties"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://{instance}.okta.com"},"tokenEndpoint":{"type":"string","format":"uri-template","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the token endpoint. May contain templated placeholders (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{instance}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that correspond to entries in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orgConfigProperties"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://{instance}.token.okta.com"}},"required":["issuer","tokenEndpoint","authorizationEndpoint","authorizationServerGlobalId"]}},"components/schemas/MCPServerCatalogEntry":{"id":"components/schemas/MCPServerCatalogEntry","kind":"json-schema","title":"MCPServerCatalogEntry","data":{"description":"Suggested MCP server and authorization server configuration resolved from a catalog source","type":"object","properties":{"authorizationServers":{"type":"array","description":"Suggested authorization servers for the catalog entry","items":{"$ref":"#/components/schemas/MCPServerCatalogAuthorizationServer"}},"orgConfigProperties":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Definitions of the org-configured properties referenced by templated placeholders (for example,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{instance}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") in the catalog entry's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"issuer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"tokenEndpoint"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authorizationEndpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fields. These are property definitions only (labels and help text); the admin supplies the actual"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"values when registering the MCP server."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/MCPServerCatalogOrgConfigProperty"}},"resourceServer":{"$ref":"#/components/schemas/MCPServerCatalogResourceServer"}},"required":["resourceServer","authorizationServers","orgConfigProperties"]}},"components/schemas/MCPServerCatalogOrgConfigProperty":{"id":"components/schemas/MCPServerCatalogOrgConfigProperty","kind":"json-schema","title":"MCPServerCatalogOrgConfigProperty","data":{"description":"Definition of an org-configured property referenced by templated placeholders in a catalog entry","type":"object","properties":{"helpText":{"type":"string","description":"Help text describing the property, displayed to the admin","example":"help text"},"label":{"type":"string","description":"Human-readable label for the property","example":"Instance"},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Property name used as the templated placeholder (for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}],"example":"instance"},"required":{"type":"boolean","description":"Whether a value for this property must be supplied to complete registration","example":true}},"required":["name","label","required"]}},"components/schemas/MCPServerCatalogResourceServer":{"id":"components/schemas/MCPServerCatalogResourceServer","kind":"json-schema","title":"MCPServerCatalogResourceServer","data":{"description":"Suggested resource server configuration for the catalog entry","type":"object","properties":{"description":{"type":"string","description":"Suggested description for the resource server","example":"Okta description"},"name":{"type":"string","description":"Suggested display name for the resource server","example":"Okta"},"resource":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Suggested resource URL for the resource server. May contain templated placeholders"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(for example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{instance}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") that correspond to entries in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orgConfigProperties"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://{instance}.okta.com/mcp"},"resourceServerGlobalId":{"type":"string","description":"Global identifier of the resource server in the catalog source","example":"4f6e56a1-6b1e-4b8e-9c3a-2d6f8a1c9e4b"}},"required":["name","resource","resourceServerGlobalId"]}},"components/schemas/MCPServerCatalogType":{"id":"components/schemas/MCPServerCatalogType","kind":"json-schema","title":"MCPServerCatalogType","data":{"description":"The catalog source to look up the MCP server entry from","example":"OIN","type":"string","enum":["OIN"],"x-enumDescriptions":{"OIN":"Resolves catalog entries from Okta Integration Network (OIN) app definitions"}}},"components/schemas/MCPServerDetectedMetadata":{"id":"components/schemas/MCPServerDetectedMetadata","kind":"json-schema","title":"MCPServerDetectedMetadata","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Auto-detected metadata about the MCP server from the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".well-known/oauth-protected-resource"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These fields are read-only and automatically populated during metadata refresh operations."},"children":[]}]}]}],"type":"object","properties":{"lastRefreshedAt":{"type":"string","format":"date-time","description":"Timestamp when the metadata was last refreshed from the MCP server","readOnly":true,"example":"2025-01-29T10:00:00.000Z"},"resourceName":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Canonical resource name of the MCP server as reported by the server itself (auto-detected). This is distinct from the admin-editable "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"displayName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property."},"children":[]}]}]}],"readOnly":true,"example":"GitHub Copilot MCP"}},"required":["lastRefreshedAt","scopesSupported"]}},"components/schemas/MCPServerDiscovery":{"id":"components/schemas/MCPServerDiscovery","kind":"json-schema","title":"MCPServerDiscovery","data":{"description":"Discovery metadata containing the credentials used to discover tools on an MCP server","type":"object","properties":{"credential":{"$ref":"#/components/schemas/MCPServerToolCredential"},"errorReason":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-readable reason for the discovery failure. Only present when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ERROR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"readOnly":true,"example":"Connection to MCP server timed out"},"id":{"type":"string","description":"Unique identifier for the discovery","readOnly":true,"example":"emd1a2b3c4d5e6f7g8h9"},"lastDiscoveredAt":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp when this discovery last completed successfully. Only present when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"READY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"readOnly":true,"example":"2025-01-29T12:00:00.000Z"},"mcpServerId":{"type":"string","description":"ID of the MCP server this discovery belongs to","readOnly":true,"example":"ems8nUa7p0g4zrZbs2f4"},"status":{"type":"string","description":"Current status of this discovery run","readOnly":true,"enum":["POPULATING","READY","ERROR"],"x-enumDescriptions":{"POPULATING":"Discovery is currently in progress","READY":"Discovery completed successfully and tools are available","ERROR":"Discovery failed"},"example":"READY"},"toolsCount":{"type":"integer","format":"int32","minimum":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of tools found during this discovery. Zero when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"READY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"readOnly":true,"example":12},"_links":{"type":"object","readOnly":true,"required":["self","mcpServer","tools"],"properties":{"self":{"$ref":"#/components/schemas/HrefObject"},"mcpServer":{"$ref":"#/components/schemas/HrefObject"},"clientAuthSettings":{"$ref":"#/components/schemas/HrefObject"},"tools":{"$ref":"#/components/schemas/HrefObject"}}}},"required":["id","mcpServerId","credential","status","toolsCount","_links"]}},"components/schemas/MCPServerLinks":{"id":"components/schemas/MCPServerLinks","kind":"json-schema","title":"MCPServerLinks","data":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"type":"object","properties":{"authorization-servers":{"$ref":"#/components/schemas/HrefObjectAuthorizationServersLink"},"discovery":{"$ref":"#/components/schemas/HrefObjectDiscoveryLink"},"refresh-metadata":{"$ref":"#/components/schemas/HrefObjectRefreshMetadataLink"},"tools":{"$ref":"#/components/schemas/HrefObjectToolsLink"}}}]}},"components/schemas/MCPServerMetadata":{"id":"components/schemas/MCPServerMetadata","kind":"json-schema","title":"MCPServerMetadata","data":{"description":"Metadata about the resource server. Includes admin-editable fields and, for discovered\nservers, auto-detected read-only fields.","type":"object","properties":{"description":{"$ref":"#/components/schemas/ResourceServerDescription"},"displayName":{"$ref":"#/components/schemas/ResourceServerDisplayName"}}}},"components/schemas/MCPServerTool":{"id":"components/schemas/MCPServerTool","kind":"json-schema","title":"MCPServerTool","data":{"description":"A tool discovered from an MCP server","type":"object","properties":{"created":{"type":"string","format":"date-time","description":"Timestamp when the tool was first discovered","readOnly":true,"example":"2025-01-29T12:00:00.000Z"},"credential":{"$ref":"#/components/schemas/MCPServerToolCredential"},"description":{"type":"string","description":"Human-readable description of what the tool does","readOnly":true,"example":"Creates a new pull request in a GitHub repository"},"id":{"type":"string","description":"Unique identifier for the MCP server tool","readOnly":true,"example":"emt1a2b3c4d5e6f7g8h9"},"inputSchema":{"type":"object","description":"JSON Schema describing the tool's input parameters","readOnly":true,"additionalProperties":true},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the tool was last updated","readOnly":true,"example":"2025-01-29T12:00:00.000Z"},"name":{"type":"string","description":"Name of the tool as reported by the MCP server","readOnly":true,"example":"create_pull_request"},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/HrefObjectParentLink"}}}]}},"required":["id","name","created","lastUpdated","_links"]}},"components/schemas/MCPServerToolCredential":{"id":"components/schemas/MCPServerToolCredential","kind":"json-schema","title":"MCPServerToolCredential","data":{"description":"The credential used for the discovery run that produced this tool","type":"object","properties":{"authType":{"type":"string","description":"Authentication type used for discovery","readOnly":true,"enum":["CLIENT_AUTH_SETTINGS","IDENTITY_ASSERTION"],"x-enumDescriptions":{"CLIENT_AUTH_SETTINGS":"Discovery was performed using OAuth client authentication settings","IDENTITY_ASSERTION":"Discovery was performed using identity assertion"},"example":"CLIENT_AUTH_SETTINGS"},"clientAuthSettingsId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the client auth settings used for discovery. Omitted when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"IDENTITY_ASSERTION"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"readOnly":true,"example":"rsc2c8xwvBn4h2Ry50g7"}},"required":["authType"],"readOnly":true}},"components/schemas/MCPToolDefinition":{"id":"components/schemas/MCPToolDefinition","kind":"json-schema","title":"MCPToolDefinition","data":{"description":"MCP tool definition","x-property-order":["description","title","input_schema","output_schema","annotations","execution"],"type":"object","properties":{"annotations":{"$ref":"#/components/schemas/ToolAnnotations"},"description":{"type":"string","maxLength":1024,"description":"Human-readable description of the tool","example":"Lists all users in the organization with optional filters"},"execution":{"$ref":"#/components/schemas/ToolExecution"},"input_schema":{"type":"object","additionalProperties":true,"description":"JSON schema object defining expected parameters"},"output_schema":{"type":"object","additionalProperties":true,"description":"Optional JSON schema defining output structure"},"title":{"type":"string","maxLength":128,"description":"Human-readable display name","example":"List Users"}},"required":["input_schema"]}},"components/schemas/McpServersSettings":{"id":"components/schemas/McpServersSettings","kind":"json-schema","title":"McpServersSettings","data":{"type":"object","properties":{"features":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enabled feature indicators for this domain. Values might be added or removed without notice. Clients "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" build business logic that depends on the presence of specific values."},"children":[]}]}]}],"items":{"type":"string"}},"maxAuthServersPerMcpServer":{"type":"integer","description":"Maximum number of authorization servers per MCP server"},"maxClientAuthSettingsPerMcpServer":{"type":"integer","description":"Maximum number of client auth settings per MCP server"},"maxMcpServers":{"type":"integer","description":"Maximum number of MCP servers allowed for this org"}}}},"components/schemas/PatchApiServerAuthorizationServerRequest":{"id":"components/schemas/PatchApiServerAuthorizationServerRequest","kind":"json-schema","title":"PatchApiServerAuthorizationServerRequest","data":{"additionalProperties":false,"description":"JSON Merge Patch for a manually configured authorization server. Send only the fields to\nupdate. Use null to remove a value. You can't change the issuer.","type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri","nullable":true,"description":"URL of the authorization endpoint","example":"https://auth.external.com/oauth/authorize"},"grantTypesSupported":{"type":"array","nullable":true,"description":"OAuth 2.0 grant types supported by this authorization server","items":{"type":"string","enum":["authorization_code","refresh_token"]},"example":["authorization_code","refresh_token"]},"tokenEndpoint":{"type":"string","format":"uri","nullable":true,"description":"URL of the token endpoint","example":"https://auth.external.com/oauth/token"}}}},"components/schemas/PatchApiServerRequest":{"id":"components/schemas/PatchApiServerRequest","kind":"json-schema","title":"PatchApiServerRequest","data":{"description":"Base JSON Merge Patch properties for a resource server. Send only the fields to update. Use null to remove a value.","type":"object","properties":{"description":{"type":"string","nullable":true,"description":"Description of the resource server","minLength":1,"maxLength":2000,"example":"Example server description"},"displayName":{"type":"string","nullable":true,"description":"Human-readable display name for the resource server","minLength":1,"maxLength":255,"example":"My Server"}}}},"components/schemas/PatchAppResourceRequest":{"id":"components/schemas/PatchAppResourceRequest","kind":"json-schema","title":"PatchAppResourceRequest","data":{"description":"JSON Merge Patch for an app resource registration. Send only the properties to update. Use null to remove a value.","type":"object","properties":{"tenantId":{"type":"string","nullable":true,"description":"Tenant identifier for the app instance's authorization server","minLength":1,"maxLength":1024,"example":"tenant-123"}}}},"components/schemas/PatchMCPServerRequest":{"id":"components/schemas/PatchMCPServerRequest","kind":"json-schema","title":"PatchMCPServerRequest","data":{"description":"Base JSON Merge Patch properties for a resource server. Send only the fields to update. Use null to remove a value.","type":"object","properties":{"description":{"type":"string","nullable":true,"description":"Description of the resource server","minLength":1,"maxLength":2000,"example":"Example server description"},"displayName":{"type":"string","nullable":true,"description":"Human-readable display name for the resource server","minLength":1,"maxLength":255,"example":"My Server"}}}},"components/schemas/PatchManualAuthorizationServerRequest":{"id":"components/schemas/PatchManualAuthorizationServerRequest","kind":"json-schema","title":"PatchManualAuthorizationServerRequest","data":{"additionalProperties":false,"description":"JSON Merge Patch for a manually configured authorization server. Send only the fields to\nupdate. Use null to remove a value. You can't change the issuer.","type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri","nullable":true,"description":"URL of the authorization endpoint","example":"https://auth.external.com/oauth/authorize"},"grantTypesSupported":{"type":"array","nullable":true,"description":"OAuth 2.0 grant types supported by this authorization server","items":{"type":"string","enum":["authorization_code","refresh_token"]},"example":["authorization_code","refresh_token"]},"tokenEndpoint":{"type":"string","format":"uri","nullable":true,"description":"URL of the token endpoint","example":"https://auth.external.com/oauth/token"}}}},"components/schemas/PatchResourceServerRequestBase":{"id":"components/schemas/PatchResourceServerRequestBase","kind":"json-schema","title":"PatchResourceServerRequestBase","data":{"description":"Base JSON Merge Patch properties for a resource server. Send only the fields to update. Use null to remove a value.","type":"object","properties":{"description":{"type":"string","nullable":true,"description":"Description of the resource server","minLength":1,"maxLength":2000,"example":"Example server description"},"displayName":{"type":"string","nullable":true,"description":"Human-readable display name for the resource server","minLength":1,"maxLength":255,"example":"My Server"}}}},"components/schemas/Principal":{"id":"components/schemas/Principal","kind":"json-schema","title":"Principal","data":{"x-property-order":["client_id","display_name"],"type":"object","properties":{"client_id":{"type":"string","maxLength":2048,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The OAuth client id exactly as it appears in the access token the caller presents to the Agent Gateway (equals actor.id on agent_gateway events). This may be a standard client id OR a CIMD client-metadata URL."},"children":[]}]}]}],"example":"https://claude.ai/oauth/claude-code-client-metadata"},"display_name":{"type":"string","maxLength":256,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-friendly name of the delegating principal — the AI agent's name or the app instance's label."},"children":[]}]}]}],"example":"Claude Code"}},"required":["client_id","display_name"]}},"components/schemas/RegisterAppResourceRequest":{"id":"components/schemas/RegisterAppResourceRequest","kind":"json-schema","title":"RegisterAppResourceRequest","data":{"description":"Request to register an app instance as an external resource server","type":"object","properties":{"appInstanceOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the app instance to register as a resource server"},"children":[]}]}]}],"example":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:apps:saml:0oa1gjh63g214q0Hq0g4"},"authorizationServer":{"$ref":"#/components/schemas/AppResourceAuthorizationServerRequest"},"resource":{"$ref":"#/components/schemas/AppResourceServerRequest"},"tenantId":{"type":"string","description":"Tenant identifier for the app instance's authorization server","minLength":1,"maxLength":1024,"example":"tenant-123"}},"required":["appInstanceOrn","resource","authorizationServer"]}},"components/schemas/ResourceServerAuthorizationServer":{"id":"components/schemas/ResourceServerAuthorizationServer","kind":"json-schema","title":"ResourceServerAuthorizationServer","data":{"description":"Authorization server linked to a resource server","allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServerBase"},{"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/ResourceServerAuthorizationServerMetadata"}}}]}},"components/schemas/ResourceServerAuthorizationServerBase":{"id":"components/schemas/ResourceServerAuthorizationServerBase","kind":"json-schema","title":"ResourceServerAuthorizationServerBase","data":{"description":"Base authorization server properties shared across resource server types","type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the authorization server","readOnly":true,"example":"aus5rb5mt2H3d1TJd0h7"},"issuer":{"type":"string","format":"uri","description":"OAuth 2.0 issuer identifier for the authorization server","example":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7"},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the authorization server was last updated","readOnly":true,"example":"2025-01-29T10:00:00Z"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the authorization server"},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"status":{"type":"string","description":"Current status of the authorization server","enum":["INACTIVE","ACTIVE","INVALID"],"x-enumDescriptions":{"INACTIVE":"Server is inactive","ACTIVE":"Server is active and operational","INVALID":"Server configuration is invalid or validation failed"},"example":"ACTIVE"},"_links":{"$ref":"#/components/schemas/LinksSelf"}},"required":["id","orn","issuer","status","lastUpdated","_links"]}},"components/schemas/ResourceServerAuthorizationServerMetadata":{"id":"components/schemas/ResourceServerAuthorizationServerMetadata","kind":"json-schema","title":"ResourceServerAuthorizationServerMetadata","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Metadata about the authorization server. For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"OKTA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DISCOVERABLE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" types, these fields"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are resolved automatically. For the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MANUAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" type, these fields are provided as input."},"children":[]}]}]}],"type":"object","properties":{"authorizationEndpoint":{"type":"string","format":"uri","description":"URL of the authorization endpoint","example":"https://{yourOktaDomain}/oauth2/ausXXX/v1/authorize"},"grantTypesSupported":{"type":"array","description":"OAuth 2.0 grant types supported by this authorization server","items":{"type":"string"},"example":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"tokenEndpoint":{"type":"string","format":"uri","description":"URL of the token endpoint","example":"https://{yourOktaDomain}/oauth2/ausXXX/v1/token"}}}},"components/schemas/ResourceServerDescription":{"id":"components/schemas/ResourceServerDescription","kind":"json-schema","title":"ResourceServerDescription","data":{"description":"Description of the resource server","minLength":1,"maxLength":2000,"example":"Example server description","type":"string"}},"components/schemas/ResourceServerDisplayName":{"id":"components/schemas/ResourceServerDisplayName","kind":"json-schema","title":"ResourceServerDisplayName","data":{"description":"Human-readable display name for the resource server","minLength":1,"maxLength":255,"example":"My Server","type":"string"}},"components/schemas/ResourceServerMetadata":{"id":"components/schemas/ResourceServerMetadata","kind":"json-schema","title":"ResourceServerMetadata","data":{"description":"Metadata about the resource server. Includes admin-editable fields and, for discovered\nservers, auto-detected read-only fields.","type":"object","properties":{"description":{"$ref":"#/components/schemas/ResourceServerDescription"},"displayName":{"$ref":"#/components/schemas/ResourceServerDisplayName"}}}},"components/schemas/ResourceServerOperationErrorDetails":{"id":"components/schemas/ResourceServerOperationErrorDetails","kind":"json-schema","title":"ResourceServerOperationErrorDetails","data":{"description":"Details about an error that occurred during the operation","type":"object","properties":{"code":{"type":"string","description":"The error code","example":"E0000001"},"message":{"type":"string","description":"The error message","example":"Unable to delete resource server due to active connections."}}}},"components/schemas/ResourceServerOperationListResponse":{"id":"components/schemas/ResourceServerOperationListResponse","kind":"json-schema","title":"ResourceServerOperationListResponse","data":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ResourceServerOperationResponse"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"}]}}}},"components/schemas/ResourceServerOperationResponse":{"id":"components/schemas/ResourceServerOperationResponse","kind":"json-schema","title":"ResourceServerOperationResponse","data":{"type":"object","properties":{"completed":{"type":"string","description":"Timestamp of when the resource server operation completed","format":"date-time","example":"2025-01-29T10:00:05.000Z"},"created":{"type":"string","description":"Timestamp of when the resource server operation was created","format":"date-time","example":"2025-01-29T10:00:00.000Z"},"errorDetails":{"$ref":"#/components/schemas/ResourceServerOperationErrorDetails"},"id":{"type":"string","description":"ID of the resource server operation","example":"op-1a2b3c4d"},"resource":{"$ref":"#/components/schemas/ResourceServerResource"},"started":{"type":"string","description":"Timestamp of when the resource server operation started","format":"date-time","example":"2025-01-29T10:00:01.000Z"},"status":{"type":"string","description":"The status of the resource server operation","enum":["COMPLETED","SCHEDULED","IN_PROGRESS","FAILED"],"x-enumDescriptions":{"COMPLETED":"The operation completed successfully","SCHEDULED":"The operation is scheduled to run","IN_PROGRESS":"The operation is currently running","FAILED":"The operation failed"}},"type":{"type":"string","description":"The resource server operation type","enum":["resource-server:Register","resource-server:Patch","resource-server:Delete","resource-server:Activate","resource-server:Deactivate","resource-server:RefreshMetadata","resource-server:Discover","resource-server-authorization-server:Link","resource-server-authorization-server:Unlink","resource-server-authorization-server:Patch","client-auth-settings:Create"],"x-enumDescriptions":{"resource-server:Register":"Register a new resource server","resource-server:Patch":"Update an existing resource server","resource-server:Delete":"Delete a resource server","resource-server:Activate":"Activate a resource server","resource-server:Deactivate":"Deactivate a resource server","resource-server:RefreshMetadata":"Refresh metadata from the resource server","resource-server:Discover":"Discover capabilities from a resource server","resource-server-authorization-server:Link":"Link an authorization server to a resource server for OAuth support","resource-server-authorization-server:Unlink":"Unlink an authorization server from a resource server to remove OAuth support","resource-server-authorization-server:Patch":"Update the configuration of an authorization server linked to a resource server","client-auth-settings:Create":"Create client authentication settings through dynamic client registration"}}},"required":["id","type","status","created"]}},"components/schemas/ResourceServerResource":{"id":"components/schemas/ResourceServerResource","kind":"json-schema","title":"ResourceServerResource","data":{"description":"The resource server resource that's associated with the operation. These properties are available after the operation completes successfully.","type":"object","properties":{"id":{"type":"string","description":"The ID of the resource server resource","example":"ems8nUa7p0g4zrZbs2f4"},"status":{"type":"string","description":"The status of the resource server resource","example":"ACTIVE"},"type":{"type":"string","description":"The type of resource","example":"API_SERVER"},"_links":{"$ref":"#/components/schemas/LinksSelf"}},"required":["id","type","status","_links"]}},"components/schemas/ResourceServerStatus":{"id":"components/schemas/ResourceServerStatus","kind":"json-schema","title":"ResourceServerStatus","data":{"description":"Current status of the server in its lifecycle","example":"ACTIVE","type":"string","enum":["ACTIVE","INACTIVE","INVALID"],"x-enumDescriptions":{"INACTIVE":"Server is inactive and ready to be activated","ACTIVE":"Server is active and operational","INVALID":"Server configuration is invalid"}}},"components/schemas/TargetMCPAuth":{"id":"components/schemas/TargetMCPAuth","kind":"json-schema","title":"TargetMCPAuth","data":{"description":"Authentication configuration for target MCP server","x-property-order":["auth_method","target_connection","target_resource","target_custom_as_metadata_url"],"type":"object","properties":{"auth_method":{"type":"string","enum":["third_party_token_exchange","first_party_token_exchange"],"x-enumDescriptions":{"third_party_token_exchange":"Client exchanges a token using OAuth-STS","first_party_token_exchange":"Client exchanges a token with custom authorization server in Okta using ID-JAG"},"description":"Authentication method","example":"first_party_token_exchange"},"target_connection":{"type":"string","minLength":1,"maxLength":255,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Connection name for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"THIRD_PARTY_TOKEN_EXCHANGE"},"children":[]}]}]}],"example":"salesforce-prod"},"target_custom_as_metadata_url":{"type":"string","format":"uri","minLength":1,"maxLength":2048,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.0 metadata URL of the Custom Authorization Server that issues tokens for the target resource. Required when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"auth_method"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"FIRST_PARTY_TOKEN_EXCHANGE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Composed as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://{subdomain}.okta.com/.well-known/oauth-authorization-server/oauth2/{authServerId}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"authServerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the ID of the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/api/openapi/okta-oauth/oauth/customas"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom Authorization Server"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" linked to the target MCP server."},"children":[]}]}]}],"example":"https://{yourOktaDomain}/.well-known/oauth-authorization-server/oauth2/ausXXXX"},"target_resource":{"type":"string","format":"uri","minLength":1,"maxLength":2048,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource server identifier for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"FIRST_PARTY_TOKEN_EXCHANGE"},"children":[]}]}]}],"example":"https://api.example.com"}},"required":["auth_method"]}},"components/schemas/TargetMCPServer":{"id":"components/schemas/TargetMCPServer","kind":"json-schema","title":"TargetMCPServer","data":{"description":"Actual MCP server that provides functionality","x-property-order":["id","name","uri","tools","authorization"],"type":"object","properties":{"authorization":{"$ref":"#/components/schemas/TargetMCPAuth"},"id":{"type":"string","format":"uuid","description":"Unique identifier of this target server","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Server name","example":"usertools"},"tools":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/TargetMCPTool"}},"uri":{"type":"string","format":"uri","minLength":1,"maxLength":2048,"description":"Server URI","example":"https://mcp.usertools.example.com"}},"required":["id","name","uri","tools","authorization"]}},"components/schemas/TargetMCPTool":{"id":"components/schemas/TargetMCPTool","kind":"json-schema","title":"TargetMCPTool","data":{"description":"Tool available on a target MCP server","x-property-order":["id","name","definition"],"type":"object","properties":{"definition":{"$ref":"#/components/schemas/MCPToolDefinition"},"id":{"type":"string","format":"uuid","description":"Unique identifier of this tool","example":"660e8400-e29b-41d4-a716-446655440001"},"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-zA-Z0-9_\\-\\./]+$","description":"Tool name as exposed by the target server","example":"listUsers"}},"required":["id","name","definition"]}},"components/schemas/TenantConfigBundle":{"id":"components/schemas/TenantConfigBundle","kind":"json-schema","title":"TenantConfigBundle","data":{"description":"Per-org configuration bundle for agent gateway relay","x-property-order":["tenant_id","org_id","org_as_metadata_url","virtual_mcp_servers","target_mcp_servers","principals"],"type":"object","properties":{"org_as_metadata_url":{"type":"string","format":"uri","minLength":1,"maxLength":2048,"description":"ORD only. URL of the org authorization server metadata document (RFC 8414). This is used by the relay to resolve the org-level token endpoint for ID-JAG and OAuth STS exchanges.","example":"https://example.okta.com/.well-known/oauth-authorization-server"},"org_id":{"type":"string","description":"Org ID. Uniquely identifies the org.","example":"00osn3jvAIHrXVqpn0i3"},"principals":{"type":"array","maxItems":1000,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Distinct calling clients delegated to this org's Agent Gateway(s), each with a display name. The relay joins the token client_id to Principal.client_id to populate actor.displayName."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/Principal"}},"target_mcp_servers":{"type":"array","description":"Collection of target MCP servers that execute tool requests","maxItems":100,"items":{"$ref":"#/components/schemas/TargetMCPServer"}},"tenant_id":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","description":"Org subdomain used as tenant identifier. Lowercase alphanumeric and hyphens only; hyphen may not appear at start or end. Matches DNS label format.","example":"my-org"},"virtual_mcp_servers":{"type":"array","description":"Collection of Agent Gateways exposed to clients","maxItems":100,"items":{"$ref":"#/components/schemas/VirtualMCPServer"}}},"required":["tenant_id","org_id","virtual_mcp_servers","target_mcp_servers"]}},"components/schemas/ToolAnnotations":{"id":"components/schemas/ToolAnnotations","kind":"json-schema","title":"ToolAnnotations","data":{"description":"Optional tool annotations","x-property-order":["title","read_only_hint","destructive_hint","idempotent_hint","open_world_hint"],"type":"object","properties":{"destructive_hint":{"type":"boolean","example":false},"idempotent_hint":{"type":"boolean","example":true},"open_world_hint":{"type":"boolean","example":false},"read_only_hint":{"type":"boolean","example":true},"title":{"type":"string","maxLength":128,"example":"List Users"}}}},"components/schemas/ToolExecution":{"id":"components/schemas/ToolExecution","kind":"json-schema","title":"ToolExecution","data":{"description":"Tool execution properties","x-property-order":["task_support"],"type":"object","properties":{"task_support":{"type":"string","enum":["forbidden","optional","required"],"description":"Task-augmented execution support level","example":"optional"}}}},"components/schemas/VirtualMCPAttachedAgentSummary":{"id":"components/schemas/VirtualMCPAttachedAgentSummary","kind":"json-schema","title":"VirtualMCPAttachedAgentSummary","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum fields needed to render an attached AI agent in a summary column"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"of the virtual MCP servers list. An agent is \"attached\" when a delegation"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link exists whose "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"from"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the vMCP's authorization server and whose"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"clientOrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the agent ORN. Full agent details continue to live on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/AgentRegistration/operation/getAIAgent"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI agent get endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the AI agent","example":"0oa1aB2cD3eF4gH5iJ6k"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the AI agent"},"children":[]}]}]}],"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:ai-agents:0oa1aB2cD3eF4gH5iJ6k"},"profile":{"type":"object","description":"Minimal profile fields for display","properties":{"name":{"type":"string","description":"Display name of the AI agent","example":"Cursor"}}}},"required":["id","orn"],"readOnly":true}},"components/schemas/VirtualMCPBase":{"id":"components/schemas/VirtualMCPBase","kind":"json-schema","title":"VirtualMCPBase","data":{"description":"Base properties of the virtual MCP resource","type":"object","properties":{"created":{"type":"string","format":"date-time","description":"Timestamp when the virtual MCP was created","readOnly":true,"example":"2025-06-01T10:00:00Z"},"id":{"type":"string","description":"Unique identifier for the virtual MCP","readOnly":true,"example":"wlp1aB2cD3eF4gH5iJ6k"},"lastUpdated":{"type":"string","format":"date-time","description":"Timestamp when the virtual MCP was last updated","readOnly":true,"example":"2025-06-15T14:30:00Z"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the virtual MCP"},"children":[]}]}]}],"readOnly":true,"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:workload-principals:virtual-mcp:wlp1aB2cD3eF4gH5iJ6k"},"profile":{"$ref":"#/components/schemas/VirtualMCPProfile"},"status":{"type":"string","description":"Current status of the virtual MCP in its lifecycle","enum":["INACTIVE","ACTIVE"],"x-enumDescriptions":{"INACTIVE":"Virtual MCP is inactive","ACTIVE":"Virtual MCP is active and operational"},"example":"ACTIVE"}},"required":["id","orn","status","profile","created","lastUpdated"]}},"components/schemas/VirtualMCPCapability":{"id":"components/schemas/VirtualMCPCapability","kind":"json-schema","title":"VirtualMCPCapability","data":{"description":"A capability selected for a virtual MCP server","allOf":[{"$ref":"#/components/schemas/VirtualMCPCapabilityBase"},{"type":"object","properties":{"type":{"type":"string","description":"The type of the capability","example":"TOOL"}},"required":["type"]}]}},"components/schemas/VirtualMCPCapabilityAlias":{"id":"components/schemas/VirtualMCPCapabilityAlias","kind":"json-schema","title":"VirtualMCPCapabilityAlias","data":{"description":"Admin-defined alias that overrides the capability's default name when exposed through the virtual MCP server","minLength":1,"maxLength":255,"example":"get_jira_issues","type":"string"}},"components/schemas/VirtualMCPCapabilityAliasPatchable":{"id":"components/schemas/VirtualMCPCapabilityAliasPatchable","kind":"json-schema","title":"VirtualMCPCapabilityAliasPatchable","data":{"nullable":true,"description":"Admin-defined alias that overrides the capability's default name when exposed through the virtual MCP server. If not provided, defaults to the capability name as reported by the upstream resource server.","minLength":1,"maxLength":255,"example":"get_jira_issues","type":"string"}},"components/schemas/VirtualMCPCapabilityBase":{"id":"components/schemas/VirtualMCPCapabilityBase","kind":"json-schema","title":"VirtualMCPCapabilityBase","data":{"description":"Shared properties for all capability types","type":"object","properties":{"connectionOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the connection that provides authentication data for the resource server this capability is bound to"},"children":[]}]}]}],"example":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k"},"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier for the capability. Use this value in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{capabilityId}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" path parameter."},"children":[]}]}]}],"readOnly":true,"example":"vsc1aB2cD3eF4gH5iJ6k"},"profile":{"$ref":"#/components/schemas/VirtualMCPCapabilityProfile"},"sourceOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the source capability on the upstream resource server"},"children":[]}]}]}],"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k"},"status":{"type":"string","description":"Validity status of the capability relative to the upstream MCP server","readOnly":true,"enum":["VALID","INVALID"],"x-enumDescriptions":{"VALID":"The capability still exists on the upstream MCP server","INVALID":"The upstream MCP server no longer reports this capability after its most recent discovery"},"example":"VALID"},"_embedded":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embedded resources. Only included when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=inputSchema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is specified."},"children":[]}]}]}],"properties":{"inputSchema":{"type":"object","description":"The JSON Schema describing the capability's input parameters","additionalProperties":true}}}},"required":["id","sourceOrn","connectionOrn","status"]}},"components/schemas/VirtualMCPCapabilityProfile":{"id":"components/schemas/VirtualMCPCapabilityProfile","kind":"json-schema","title":"VirtualMCPCapabilityProfile","data":{"description":"Profile for a capability on the virtual MCP","type":"object","properties":{"alias":{"$ref":"#/components/schemas/VirtualMCPCapabilityAlias"},"description":{"type":"string","description":"The description of the capability as reported by the upstream MCP server","example":"Get issues from a repository"},"name":{"type":"string","description":"The name of the capability as reported by the upstream MCP server","example":"get_issues"}},"required":["alias"]}},"components/schemas/VirtualMCPDescription":{"id":"components/schemas/VirtualMCPDescription","kind":"json-schema","title":"VirtualMCPDescription","data":{"description":"Description of the virtual MCP","minLength":1,"maxLength":2000,"example":"Groups all production MCP servers for the engineering team","type":"string"}},"components/schemas/VirtualMCPDisplayName":{"id":"components/schemas/VirtualMCPDisplayName","kind":"json-schema","title":"VirtualMCPDisplayName","data":{"description":"Human-readable display name for the virtual MCP","minLength":1,"maxLength":255,"example":"Production MCP Servers","type":"string"}},"components/schemas/VirtualMCPProfile":{"id":"components/schemas/VirtualMCPProfile","kind":"json-schema","title":"VirtualMCPProfile","data":{"description":"Profile for the virtual MCP, which can be edited by the admin","type":"object","properties":{"description":{"$ref":"#/components/schemas/VirtualMCPDescription"},"displayName":{"$ref":"#/components/schemas/VirtualMCPDisplayName"}}}},"components/schemas/VirtualMCPResourceConnectionSummary":{"id":"components/schemas/VirtualMCPResourceConnectionSummary","kind":"json-schema","title":"VirtualMCPResourceConnectionSummary","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimum fields needed to render a resource connection in a summary column"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"of the virtual MCP servers list. Full details continue to live on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/VirtualMCPConnections/operation/listVirtualMCPConnections"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"connections list endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields mirror "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ResourceConnectionId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ResourceConnectionOrn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ResourceConnectionStatus"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"from the connections spec; they are inlined here (rather than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"$ref"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"-ed cross-tree) so this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"schema resolves cleanly inside the resource-servers bundle, which doesn't include the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ai-agents subtree."},"children":[]}]}]}],"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the resource connection.","example":"rsc1aB2cD3eF4gH5iJ6k"},"orn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the resource connection"},"children":[]}]}]}],"example":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:resource-connections:rsc1aB2cD3eF4gH5iJ6k"},"resource":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimal summary of the resource this connection targets. Mirrors the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resource"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on the full connection schema (see "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ManagedSTSAccessTokenMcpServerResourceData"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the connections spec), but includes only the fields the vMCP list UI needs today."},"children":[]}]}]}],"properties":{"mcpServerId":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the third-party MCP server this connection targets. Field name matches"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ManagedSTSAccessTokenMcpServerResourceData.mcpServerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the full connection"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"schema so callers can navigate to the MCP server management page without parsing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the ORN."},"children":[]}]}]}],"example":"ems8nUa7p0g4zrZbs2f4"},"name":{"type":"string","description":"Display name of the third-party MCP server this connection targets","example":"GitHub MCP"}}},"status":{"type":"string","description":"The status of the resource connection","enum":["ACTIVE","INACTIVE"],"x-enumDescriptions":{"ACTIVE":"The resource connection is active","INACTIVE":"The resource connection is inactive"}}},"required":["id","orn","status"],"readOnly":true}},"components/schemas/VirtualMCPSelectedTool":{"id":"components/schemas/VirtualMCPSelectedTool","kind":"json-schema","title":"VirtualMCPSelectedTool","data":{"description":"Shared properties for all capability types","type":"object","properties":{"connectionOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the connection that provides authentication data for the resource server this capability is bound to"},"children":[]}]}]}],"example":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k"},"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier for the capability. Use this value in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{capabilityId}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" path parameter."},"children":[]}]}]}],"readOnly":true,"example":"vsc1aB2cD3eF4gH5iJ6k"},"profile":{"$ref":"#/components/schemas/VirtualMCPCapabilityProfile"},"sourceOrn":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#okta-resource-name-orn"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the source capability on the upstream resource server"},"children":[]}]}]}],"example":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k"},"status":{"type":"string","description":"Validity status of the capability relative to the upstream MCP server","readOnly":true,"enum":["VALID","INVALID"],"x-enumDescriptions":{"VALID":"The capability still exists on the upstream MCP server","INVALID":"The upstream MCP server no longer reports this capability after its most recent discovery"},"example":"VALID"},"_embedded":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embedded resources. Only included when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=inputSchema"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is specified."},"children":[]}]}]}],"properties":{"inputSchema":{"type":"object","description":"The JSON Schema describing the capability's input parameters","additionalProperties":true}}}},"required":["id","sourceOrn","connectionOrn","status"]}},"components/schemas/VirtualMCPServer":{"id":"components/schemas/VirtualMCPServer","kind":"json-schema","title":"VirtualMCPServer","data":{"description":"Agent Gateway endpoint configuration","x-property-order":["name","resource_identifier","idp_client_id","metadata_url","tools"],"type":"object","properties":{"idp_client_id":{"type":"string","minLength":5,"maxLength":64,"pattern":"^[a-zA-Z0-9_\\-@\\.~]+$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Workload principal entity ID for this Agent Gateway ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wlp*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" prefix).  Used for token exchange and as the stable identitifier for this gateway."},"children":[]}]}]}],"example":"wlp1aB2cD3eF4gH5iJ6k"},"metadata_url":{"type":"string","format":"uri","minLength":1,"maxLength":2048,"description":"URL of the IdP authorization server metadata document","example":"https://dev-123456.okta.com/.well-known/openid-configuration"},"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-zA-Z0-9_\\-\\.]+$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A URI path suffix that uniquely identifies this Agent Gateway, used for request routing. Corresponds to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resourcePath"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the Agent Gateway registration API, and is distinct from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile.displayName"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which is the gateway's display name."},"children":[]}]}]}],"example":"usertools"},"resource_identifier":{"type":"string","format":"uri","minLength":1,"maxLength":2048,"description":"Expected authorization token audience","example":"https://relay.okta.com/mcp/usertools"},"tools":{"type":"array","description":"Enabled Agent Gateway tools","maxItems":100,"items":{"$ref":"#/components/schemas/VirtualMCPTool"}}},"required":["name","resource_identifier","idp_client_id","metadata_url","tools"]}},"components/schemas/VirtualMCPServerAuthorizationServer":{"id":"components/schemas/VirtualMCPServerAuthorizationServer","kind":"json-schema","title":"VirtualMCPServerAuthorizationServer","data":{"allOf":[{"$ref":"#/components/schemas/ResourceServerAuthorizationServer"},{"additionalProperties":true,"type":"object"}]}},"components/schemas/VirtualMCPServerHrefObjectAuthorizationServersLink":{"id":"components/schemas/VirtualMCPServerHrefObjectAuthorizationServersLink","kind":"json-schema","title":"VirtualMCPServerHrefObjectAuthorizationServersLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the authorization servers for the virtual MCP server"}]}},"components/schemas/VirtualMCPServerHrefObjectParentLink":{"id":"components/schemas/VirtualMCPServerHrefObjectParentLink","kind":"json-schema","title":"VirtualMCPServerHrefObjectParentLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the parent virtual MCP server"}]}},"components/schemas/VirtualMCPServerHrefObjectToolsLink":{"id":"components/schemas/VirtualMCPServerHrefObjectToolsLink","kind":"json-schema","title":"VirtualMCPServerHrefObjectToolsLink","data":{"x-okta-ignore-redocly-rules-for-sdk":true,"allOf":[{"$ref":"#/components/schemas/HrefObject"},{"description":"Link to the tools for the virtual MCP server"}]}},"components/schemas/VirtualMCPServerResource":{"id":"components/schemas/VirtualMCPServerResource","kind":"json-schema","title":"VirtualMCPServerResource","data":{"allOf":[{"$ref":"#/components/schemas/VirtualMCPBase"},{"type":"object","properties":{"resourcePath":{"type":"string","description":"A URI path suffix that uniquely identifies this virtual MCP server. The admin controls this value, and Okta uses it to construct the full resource URL at runtime.","pattern":"^[a-zA-Z0-9\\-._~]+$","minLength":1,"maxLength":64,"example":"production"},"resourceUrl":{"type":"string","format":"uri","description":"The fully resolved URL of the virtual MCP server resource","readOnly":true,"example":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/production"},"_embedded":{"$ref":"#/components/schemas/VirtualMCPServerResourceEmbedded"},"_links":{"$ref":"#/components/schemas/VirtualMCPServerResourceLinks"}},"required":["resourcePath","resourceUrl","_links"]}]}},"components/schemas/VirtualMCPServerResourceEmbedded":{"id":"components/schemas/VirtualMCPServerResourceEmbedded","kind":"json-schema","title":"VirtualMCPServerResourceEmbedded","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional embedded resources on the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/VirtualMCPServerResource/operation/listVirtualMCPServers"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"list endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Populated only when the corresponding value is passed via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; each supported value adds one key here."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Not returned on the single-resource "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /virtual-mcp-servers/{virtualMcpServerId}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint."},"children":[]}]}]}],"type":"object","properties":{"attachedAgents":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Summary of the AI agents allow-listed to call this virtual MCP server."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=attachedAgents"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is passed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Full agent details are available at the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/AgentRegistration/operation/getAIAgent"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AI agent get endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/VirtualMCPAttachedAgentSummary"}},"connectedResources":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Summary of the resource connections currently bound to this virtual MCP server."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?expand=connectedResources"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is passed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Full connection details are available at the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#tag/VirtualMCPConnections/operation/listVirtualMCPConnections"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"connections list endpoint"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/VirtualMCPResourceConnectionSummary"}}},"readOnly":true}},"components/schemas/VirtualMCPServerResourceLinks":{"id":"components/schemas/VirtualMCPServerResourceLinks","kind":"json-schema","title":"VirtualMCPServerResourceLinks","data":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"type":"object","properties":{"authorization-servers":{"$ref":"#/components/schemas/VirtualMCPServerHrefObjectAuthorizationServersLink"},"tools":{"$ref":"#/components/schemas/VirtualMCPServerHrefObjectToolsLink"}}}]}},"components/schemas/VirtualMCPTool":{"id":"components/schemas/VirtualMCPTool","kind":"json-schema","title":"VirtualMCPTool","data":{"description":"Tool exposed by an Agent Gateway","x-property-order":["name","target_mcp_server_id","target_mcp_server_tool_id"],"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-zA-Z0-9_\\-\\./]+$","description":"External tool name","example":"user/list"},"target_mcp_server_id":{"type":"string","format":"uuid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UUID of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TargetMCPServer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that owns this tool"},"children":[]}]}]}],"example":"550e8400-e29b-41d4-a716-446655440000"},"target_mcp_server_tool_id":{"type":"string","format":"uuid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UUID of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TargetMCPTool"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" within that server"},"children":[]}]}]}],"example":"660e8400-e29b-41d4-a716-446655440001"}},"required":["name","target_mcp_server_id","target_mcp_server_tool_id"]}},"schema_1974":{"kind":"json-schema","data":{"type":"string"},"id":"schema_1974"},"schema_1975":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":200,"default":20},"id":"schema_1975"},"schema_1976":{"kind":"json-schema","data":{"type":"string","format":"scim-filter","example":"resourceUrl eq \"https://demo-agent.example.com\""},"id":"schema_1976"},"schema_1977":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/A2AServer"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"}]}}},"id":"schema_1977"},"schema_1978":{"kind":"json-schema","data":{"type":"string","example":"wlpx9jQ16k9V8IFEL0g3"},"id":"schema_1978"},"schema_1979":{"kind":"json-schema","data":{"type":"string","format":"scim-filter","example":"status eq \"ACTIVE\""},"id":"schema_1979"},"schema_1980":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/A2AServerAuthorizationServer"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"},{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/A2AServerHrefObjectParentLink"}}}]}}},"id":"schema_1980"},"schema_1981":{"kind":"json-schema","data":{"$ref":"#/components/schemas/AddOktaAuthorizationServerRequest"},"id":"schema_1981"},"schema_1982":{"kind":"json-schema","data":{"type":"object","properties":{"Location":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"required":["Location"]},"id":"schema_1982"},"schema_1983":{"kind":"json-schema","data":{"type":"string","example":"aus5rb5mt2H3d1TJd0h7"},"id":"schema_1983"},"schema_1984":{"kind":"json-schema","data":{"type":"string","format":"scim-filter","example":"metadata.displayName sw \"Example\" and status eq \"ACTIVE\""},"id":"schema_1984"},"schema_1985":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiServer"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"}]}}},"id":"schema_1985"},"schema_1986":{"kind":"json-schema","data":{"type":"object","properties":{"Location":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL to poll for operation status. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/secures-ai/openapi/secures-ai-resource-servers/resourceserveroperations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource Server Operations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"https://{yourOktaDomain}/resource-servers/api/v1/operations/op-1a2b3c4d"}},"required":["Location"]},"id":"schema_1986"},"schema_1987":{"kind":"json-schema","data":{"type":"string","example":"api8nUa7p0g4zrZbs2f4"},"id":"schema_1987"},"schema_1988":{"kind":"json-schema","data":{"$ref":"#/components/schemas/PatchResourceServerRequestBase"},"id":"schema_1988"},"schema_1989":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiServerAuthorizationServer"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"},{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/ApiServerHrefObjectParentLink"}}}]}}},"id":"schema_1989"},"schema_1990":{"kind":"json-schema","data":{"$ref":"#/components/schemas/AddManualAuthorizationServerRequest"},"id":"schema_1990"},"schema_1991":{"kind":"json-schema","data":{"type":"string","example":"eas8nUa7p0g4zrZbs2f4"},"id":"schema_1991"},"schema_1992":{"kind":"json-schema","data":{"$ref":"#/components/schemas/PatchManualAuthorizationServerRequest"},"id":"schema_1992"},"schema_1993":{"kind":"json-schema","data":{"type":"string","format":"scim-filter","example":"metadata.displayName sw \"GitHub\" and status eq \"ACTIVE\""},"id":"schema_1993"},"schema_1994":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MCPServer"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"}]}}},"id":"schema_1994"},"schema_1995":{"kind":"json-schema","data":{"type":"string","example":"ems8nUa7p0g4zrZbs2f4"},"id":"schema_1995"},"schema_1996":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MCPServerAuthorizationServer"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"},{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/HrefObjectParentLink"}}}]}}},"id":"schema_1996"},"schema_1997":{"kind":"json-schema","data":{"type":"string","format":"scim-filter"},"id":"schema_1997"},"schema_1998":{"kind":"json-schema","data":{"type":"object","properties":{"Link":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A link to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"self"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present if there is another page of results."},"children":[]}]}]}]}]},"X-Rate-Limit-Limit":{"type":"integer","minimum":1,"example":60,"description":"The rate-limit ceiling for the current request"},"X-Rate-Limit-Remaining":{"type":"integer","minimum":0,"example":60,"description":"The number of requests left for the current rate-limit window"},"X-Rate-Limit-Reset":{"type":"integer","minimum":0,"example":1609459200,"description":"The time when the rate limit resets, specified in UTC epoch time (in seconds)"}},"required":["X-Rate-Limit-Limit","X-Rate-Limit-Remaining","X-Rate-Limit-Reset"]},"id":"schema_1998"},"schema_1999":{"kind":"json-schema","data":{"type":"string","example":"con1a2b3c4d5e6f7g8h9"},"id":"schema_1999"},"schema_2000":{"kind":"json-schema","data":{"type":"string","format":"scim-filter","example":"profile.displayName sw \"Production\" and status eq \"ACTIVE\""},"id":"schema_2000"},"schema_2001":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["connectedResources","attachedAgents"]}},"id":"schema_2001"},"schema_2002":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VirtualMCPServerResource"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"}]}}},"id":"schema_2002"},"schema_2003":{"kind":"json-schema","data":{"type":"string","example":"wlp1aB2cD3eF4gH5iJ6k"},"id":"schema_2003"},"schema_2004":{"kind":"json-schema","data":{"type":"string","enum":["inputSchema"]},"id":"schema_2004"},"schema_2005":{"kind":"json-schema","data":{"type":"object","required":["data","_links"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VirtualMCPSelectedTool"}},"_links":{"allOf":[{"$ref":"#/components/schemas/LinksSelf"},{"$ref":"#/components/schemas/LinksNext"},{"type":"object","properties":{"parent":{"$ref":"#/components/schemas/VirtualMCPServerHrefObjectParentLink"}}}]}}},"id":"schema_2005"},"schema_2006":{"kind":"json-schema","data":{"type":"object","properties":{"Link":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A link to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"self"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present if there is another page of results."},"children":[]}]}]}]}]}}},"id":"schema_2006"},"schema_2007":{"kind":"json-schema","data":{"type":"string","example":"vsc1aB2cD3eF4gH5iJ6k"},"id":"schema_2007"},"schema_2008":{"kind":"json-schema","data":{"description":"A tool capability selected for a virtual MCP server","$ref":"#/components/schemas/VirtualMCPCapabilityBase"},"id":"schema_2008"}},"exampleStore":{"components/examples/A2AServerAuthorizationServerResponse":{"id":"components/examples/A2AServerAuthorizationServerResponse","value":{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}},"summary":"Okta custom authorization server"},"components/examples/A2AServerResponse":{"id":"components/examples/A2AServerResponse","value":{"a2aServerId":"wlpx9jQ16k9V8IFEL0g3","orn":"orn:okta:directory:00o5rb5mt2H3d1TJd0h7:resource-servers:a2a:wlpx9jQ16k9V8IFEL0g3","resourceUrl":"https://demo-agent.example.com","created":"2025-01-27T08:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3"},"ai-agent":{"href":"https://{yourOktaDomain}/workload-principals/api/v1/ai-agents/wlpx9jQ16k9V8IFEL0g3"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers"}}},"summary":"A2A server"},"components/examples/AddA2AServerOktaAuthorizationServerRequest":{"id":"components/examples/AddA2AServerOktaAuthorizationServerRequest","value":{"type":"OKTA","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"summary":"Add an Okta custom authorization server"},"components/examples/AddApiServerAuthorizationServerRequest":{"id":"components/examples/AddApiServerAuthorizationServerRequest","value":{"type":"MANUAL","issuer":"https://auth.example.com","authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"summary":"Add an authorization server"},"components/examples/AddVirtualMCPServerAuthorizationServerRequest":{"id":"components/examples/AddVirtualMCPServerAuthorizationServerRequest","value":{"type":"OKTA","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"summary":"Add an Okta custom authorization server"},"components/examples/AgentSettingsResponse":{"id":"components/examples/AgentSettingsResponse","value":{"supportedConnectionTypes":["IDENTITY_ASSERTION_CUSTOM_AS","STS_VAULT_SECRET","STS_SERVICE_ACCOUNT","STS_ACCESS_TOKEN"],"maxAgents":10000,"features":["multiAgentAssignment"]},"summary":"AI Agents Settings"},"components/examples/AgentSettingsResponseSupportedPlatforms":{"id":"components/examples/AgentSettingsResponseSupportedPlatforms","value":{"supportedConnectionTypes":["IDENTITY_ASSERTION_CUSTOM_AS","STS_VAULT_SECRET","STS_SERVICE_ACCOUNT","STS_ACCESS_TOKEN"],"maxAgents":10000,"features":["multiAgentAssignment"],"supportedPlatforms":["AWS_BEDROCK_AGENTS","AWS_BEDROCK_AGENTCORE","SALESFORCE_AGENTFORCE","SERVICENOW"]},"summary":"AI Agents Settings with supported platforms"},"components/examples/ApiServerAuthorizationServerResponse":{"id":"components/examples/ApiServerAuthorizationServerResponse","value":{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.external.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.external.com/oauth/authorize","tokenEndpoint":"https://auth.external.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},"summary":"External authorization server"},"components/examples/ApiServerResponse":{"id":"components/examples/ApiServerResponse","value":{"id":"api8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.example.com","status":"ACTIVE","metadata":{"displayName":"Example API","description":"Example API server"},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":2,"clientAuthSettings":5}}},"summary":"Active API server"},"components/examples/ApiServerResponseInactive":{"id":"components/examples/ApiServerResponseInactive","value":{"id":"apiGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:apiGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.sendgrid.com","status":"INACTIVE","metadata":{"displayName":"SendGrid API","description":"SendGrid email delivery API"},"created":"2025-01-30T08:15:00Z","lastUpdated":"2025-01-30T08:20:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":0,"clientAuthSettings":0}}},"summary":"Inactive API server"},"components/examples/ApiServersSettingsResponse":{"id":"components/examples/ApiServersSettingsResponse","value":{"maxApiServers":1000,"maxAuthServersPerApiServer":100,"maxClientAuthSettingsPerApiServer":10,"features":[]},"summary":"API Servers Settings"},"components/examples/AppResourceRegistrationResponse":{"id":"components/examples/AppResourceRegistrationResponse","value":{"resource":{"type":"API_SERVER","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.example.com","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"}}},"authorizationServer":{"orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.example.com","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},"tenantId":"tenant-123","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/apps/0oa1gjh63g214q0Hq0g4"}}},"summary":"App resource registration"},"components/examples/ClientAuthSettingsAgentImportExample":{"id":"components/examples/ClientAuthSettingsAgentImportExample","value":{"id":"con2b3c4d5e6f7g8h9i0","purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:salesforce:0oa3qc3c4d5e6f7ql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]},"created":"2024-01-29T11:30:00.000Z","lastUpdated":"2024-01-29T11:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con2b3c4d5e6f7g8h9i0"}}},"summary":"Client authentication settings for agent import"},"components/examples/ClientAuthSettingsListExample":{"id":"components/examples/ClientAuthSettingsListExample","value":{"data":[{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},{"id":"con3a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con3a2b3c4d5e6f7g8h9"}}},{"id":"con2b3c4d5e6f7g8h9i0","purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:okta_workflows:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]},"created":"2024-01-29T11:30:00.000Z","lastUpdated":"2024-01-29T11:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con2b3c4d5e6f7g8h9i0"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings?after=con2b3c4d5e6f7g8h9i0&limit=20"}}},"summary":"List client authentication settings with both STS and AGENT_IMPORT types"},"components/examples/ClientAuthSettingsSTSExample":{"id":"components/examples/ClientAuthSettingsSTSExample","value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"summary":"Client authentication settings for STS (Security Token Service)"},"components/examples/ClientAuthSettingsSTSMCPExample":{"id":"components/examples/ClientAuthSettingsSTSMCPExample","value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"summary":"Client authentication settings for STS (Security Token Service) with MCP server resource"},"components/examples/CreateApiServerRequest":{"id":"components/examples/CreateApiServerRequest","value":{"resourceUrl":"https://api.example.com","displayName":"Example API","description":"Example API server"},"summary":"Register an API server"},"components/examples/CreateClientAuthSettingsAgentImportExample":{"id":"components/examples/CreateClientAuthSettingsAgentImportExample","value":{"purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:salesforce:0oa3qc3c4d5e6f7ql0g7","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6","clientSecret":"very-secret-string-for-agent-import"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]}},"summary":"Create client authentication settings for agent import"},"components/examples/CreateClientAuthSettingsDCRExample":{"id":"components/examples/CreateClientAuthSettingsDCRExample","value":{"purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My DCR Server Connection","registrationMethod":"DCR","oauthConfiguration":{"scopes":["mcp:connect"]}},"summary":"Create client authentication settings for an MCP server using DCR"},"components/examples/CreateClientAuthSettingsSTSExample":{"id":"components/examples/CreateClientAuthSettingsSTSExample","value":{"purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:jira-on-demand:0oa3qcc5apD5lVyql0g7","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4","clientSecret":"very-secret-string-that-is-never-stored-in-plain-text"},"oauthConfiguration":{"scopes":["api:read","api:write"]}},"summary":"Create client authentication settings for STS"},"components/examples/CreateClientAuthSettingsSTSMCPExample":{"id":"components/examples/CreateClientAuthSettingsSTSMCPExample","value":{"purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4","clientSecret":"very-secret-string-that-is-never-stored-in-plain-text"},"oauthConfiguration":{"scopes":["api:read","api:write"]}},"summary":"Create client authentication settings for STS with MCP server resource"},"components/examples/CreateMCPServerRequest":{"id":"components/examples/CreateMCPServerRequest","value":{"resourceUrl":"https://api.githubcopilot.com/mcp","displayName":"GitHub Copilot MCP","description":"GitHub Copilot Model Context Protocol Server"},"summary":"Register an MCP server"},"components/examples/DiscoverClientAuthSettingsNotFoundExample":{"id":"components/examples/DiscoverClientAuthSettingsNotFoundExample","value":{"errorCode":"E0000007","errorSummary":"Not found: Resource not found: rsc2c8xwvBn4h2Ry50g7 (ResourceServersClientAuthSettings)","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"summary":"Client auth settings not found"},"components/examples/DiscoverConsentRequiredExample":{"id":"components/examples/DiscoverConsentRequiredExample","value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict","errorLink":"E0000195","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[{"errorSummary":"https://auth.github.com/login/oauth/authorize?client_id=abc123&scope=mcp.tools.read","reason":"CONSENT_REQUIRED"}]},"summary":"Consent required for tool discovery"},"components/examples/DiscoverMCPServerNotFoundExample":{"id":"components/examples/DiscoverMCPServerNotFoundExample","value":{"errorCode":"E0000007","errorSummary":"Not found: Resource not found: ems8nUa7p0g4zrZbs2f4 (ExternalMcpServer)","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"summary":"MCP server not found"},"components/examples/DiscoverMCPServerRequestExample":{"id":"components/examples/DiscoverMCPServerRequestExample","value":{"type":"CLIENT_AUTH_SETTINGS","clientAuthSettingsOrn":"orn:okta:idp:00o1n8sbwArJ7OQRw406:client_auth_settings:rsc2c8xwvBn4h2Ry50g7"},"summary":"Discover with client auth settings"},"components/examples/ErrorAccessDenied":{"id":"components/examples/ErrorAccessDenied","value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"summary":"Access Denied"},"components/examples/ErrorApiValidationConflict":{"id":"components/examples/ErrorApiValidationConflict","value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: {0}","errorLink":"E0000195","errorId":"sampleMlLvGUj_YD5v15vkYWX","errorCauses":[]},"summary":"Conflict"},"components/examples/ErrorApiValidationFailed":{"id":"components/examples/ErrorApiValidationFailed","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"summary":"API Validation Failed"},"components/examples/ErrorInternalServer":{"id":"components/examples/ErrorInternalServer","value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000000","errorId":"sampleAlJ82XS2SDB_vaNIWgcA","errorCauses":[]},"summary":"Internal Server Error"},"components/examples/ErrorInvalidTokenProvided":{"id":"components/examples/ErrorInvalidTokenProvided","value":{"errorCode":"E0000011","errorSummary":"Invalid token provided","errorLink":"E0000011","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"summary":"Invalid Token Provided"},"components/examples/ErrorMissingRequiredParameter":{"id":"components/examples/ErrorMissingRequiredParameter","value":{"errorCode":"E0000028","errorSummary":"The request is missing a required parameter.","errorLink":"E0000028","errorId":"sampleiCF-l7mr9XqM1NQ","errorCauses":[]},"summary":"Missing Required Parameter"},"components/examples/ErrorResourceNotFound":{"id":"components/examples/ErrorResourceNotFound","value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"summary":"Resource Not Found"},"components/examples/ErrorTooManyRequests":{"id":"components/examples/ErrorTooManyRequests","value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"summary":"Too Many Requests"},"components/examples/ListA2AServerAuthorizationServersResponse":{"id":"components/examples/ListA2AServerAuthorizationServersResponse","value":{"data":[{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3"}}},"summary":"List of authorization servers for an A2A server"},"components/examples/ListA2AServersResponse":{"id":"components/examples/ListA2AServersResponse","value":{"data":[{"a2aServerId":"wlpx9jQ16k9V8IFEL0g3","orn":"orn:okta:directory:00o5rb5mt2H3d1TJd0h7:resource-servers:a2a:wlpx9jQ16k9V8IFEL0g3","resourceUrl":"https://demo-agent.example.com","created":"2025-01-27T08:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3"},"ai-agent":{"href":"https://{yourOktaDomain}/workload-principals/api/v1/ai-agents/wlpx9jQ16k9V8IFEL0g3"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers?after=wlpx9jQ16k9V8IFEL0g3&limit=20"}}},"summary":"List of A2A servers"},"components/examples/ListApiServerAuthorizationServersResponse":{"id":"components/examples/ListApiServerAuthorizationServersResponse","value":{"data":[{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.example.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},{"id":"easKj9mN3pWs7vXqRz5t","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easKj9mN3pWs7vXqRz5t","issuer":"https://auth.example.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers/easKj9mN3pWs7vXqRz5t"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers?after=aus5rb5mt2H3d1TJd0h7&limit=20"}}},"summary":"List of authorization servers for an API server"},"components/examples/ListApiServersResponse":{"id":"components/examples/ListApiServersResponse","value":{"data":[{"id":"api8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.example.com","status":"ACTIVE","metadata":{"displayName":"Example API","description":"Example API server"},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":2,"clientAuthSettings":5}}},{"id":"apiXj2kL9pQw3vNmYt6r","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:apiXj2kL9pQw3vNmYt6r","resourceUrl":"https://api.twilio.com","status":"ACTIVE","metadata":{"displayName":"Twilio API","description":"Twilio communications API"},"created":"2025-01-28T09:15:00Z","lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiXj2kL9pQw3vNmYt6r"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiXj2kL9pQw3vNmYt6r/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":1,"clientAuthSettings":3}}},{"id":"apiGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:apiGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.sendgrid.com","status":"INACTIVE","metadata":{"displayName":"SendGrid API","description":"SendGrid email delivery API"},"created":"2025-01-27T16:00:00Z","lastUpdated":"2025-01-27T16:45:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":0,"clientAuthSettings":0}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers?after=api5Rf8bK3sQa1nPcVz9&limit=20"}}},"summary":"List of API servers"},"components/examples/ListMCPServerAuthorizationServersResponse":{"id":"components/examples/ListMCPServerAuthorizationServersResponse","value":{"data":[{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.github.com","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://github.com/login/oauth/authorize","tokenEndpoint":"https://github.com/login/oauth/access_token","registrationEndpoint":"https://github.com/login/oauth/register","grantTypesSupported":["authorization_code","refresh_token"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"easKj9mN3pWs7vXqRz5t","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easKj9mN3pWs7vXqRz5t","issuer":"https://auth.example.com","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","registrationEndpoint":"https://auth.example.com/oauth/register","grantTypesSupported":["authorization_code","refresh_token"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"easPt2bL7qXj4sKvMc8n","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easPt2bL7qXj4sKvMc8n","issuer":"https://auth.invalid.com","status":"INVALID","lastUpdated":"2025-01-27T09:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","registrationEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/register","grantTypesSupported":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:token-exchange"],"identityChainingRequestedTokenTypesSupported":["urn:ietf:params:oauth:token-type:id-jag"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"easWq5hR9tNm2vKbXc7p","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easWq5hR9tNm2vKbXc7p","status":"INACTIVE","issuer":"https://auth.newservice.com","lastUpdated":"2025-01-26T12:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},"summary":"List of authorization servers for an MCP server"},"components/examples/ListMCPServerAuthorizationServersResponseEnhanced":{"id":"components/examples/ListMCPServerAuthorizationServersResponseEnhanced","value":{"data":[{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.github.com","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://github.com/login/oauth/authorize","tokenEndpoint":"https://github.com/login/oauth/access_token","registrationEndpoint":"https://github.com/login/oauth/register","grantTypesSupported":["authorization_code","refresh_token"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},{"id":"easKj9mN3pWs7vXqRz5t","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easKj9mN3pWs7vXqRz5t","issuer":"https://auth.example.com","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","registrationEndpoint":"https://auth.example.com/oauth/register","grantTypesSupported":["authorization_code","refresh_token"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers/easKj9mN3pWs7vXqRz5t"}}},{"id":"easPt2bL7qXj4sKvMc8n","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easPt2bL7qXj4sKvMc8n","issuer":"https://auth.invalid.com","status":"INVALID","lastUpdated":"2025-01-27T09:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers/easPt2bL7qXj4sKvMc8n"}}},{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","registrationEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/register","grantTypesSupported":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:token-exchange"],"identityChainingRequestedTokenTypesSupported":["urn:ietf:params:oauth:token-type:id-jag"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}},{"id":"easWq5hR9tNm2vKbXc7p","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easWq5hR9tNm2vKbXc7p","status":"INACTIVE","issuer":"https://auth.newservice.com","lastUpdated":"2025-01-26T12:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers/easWq5hR9tNm2vKbXc7p"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},"summary":"List of authorization servers for an MCP server"},"components/examples/ListMCPServerDiscoveriesResponse":{"id":"components/examples/ListMCPServerDiscoveriesResponse","value":{"data":[{"id":"emd1a2b3c4d5e6f7g8h9","mcpServerId":"ems8nUa7p0g4zrZbs2f4","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rsc2c8xwvBn4h2Ry50g7"},"status":"READY","lastDiscoveredAt":"2025-01-29T12:00:00Z","toolsCount":12,"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery/emd1a2b3c4d5e6f7g8h9"},"mcpServer":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"clientAuthSettings":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/rsc2c8xwvBn4h2Ry50g7"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools?search=credential.clientAuthSettingsId%20eq%20%22rsc2c8xwvBn4h2Ry50g7%22"}}},{"id":"emd9h8g7f6e5d4c3b2a1","mcpServerId":"ems8nUa7p0g4zrZbs2f4","credential":{"authType":"IDENTITY_ASSERTION"},"status":"READY","lastDiscoveredAt":"2025-01-28T10:00:00Z","toolsCount":5,"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery/emd9h8g7f6e5d4c3b2a1"},"mcpServer":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools?search=credential.authType%20eq%20%22IDENTITY_ASSERTION%22"}}},{"id":"emdAb3Cd5Ef7Gh9Ij1Kl","mcpServerId":"ems8nUa7p0g4zrZbs2f4","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rscPq2wE5rTy8uIo4pAs"},"status":"ERROR","toolsCount":0,"errorReason":"Connection refused: MCP server did not respond within the timeout period","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery/emdAb3Cd5Ef7Gh9Ij1Kl"},"mcpServer":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"clientAuthSettings":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/rscPq2wE5rTy8uIo4pAs"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools?search=credential.clientAuthSettingsId%20eq%20%22rscPq2wE5rTy8uIo4pAs%22"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery?limit=20"}}},"summary":"List of MCP server discoveries"},"components/examples/ListMCPServerToolsResponse":{"id":"components/examples/ListMCPServerToolsResponse","value":{"data":[{"id":"emt1a2b3c4d5e6f7g8h9","name":"create_pull_request","description":"Creates a new pull request in a GitHub repository","inputSchema":{"type":"object","required":["repo","title"],"properties":{"repo":{"type":"string","description":"Repository name in owner/repo format"},"title":{"type":"string","description":"Title of the pull request"},"body":{"type":"string","description":"Body content of the pull request"},"head":{"type":"string","description":"Branch to merge from"},"base":{"type":"string","description":"Branch to merge into"}}},"created":"2025-01-29T12:00:00Z","lastUpdated":"2025-01-29T12:00:00Z","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rsc2c8xwvBn4h2Ry50g7"},"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools/emt1a2b3c4d5e6f7g8h9"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},{"id":"emt9h8g7f6e5d4c3b2a1","name":"list_repositories","description":"Lists repositories accessible to the authenticated user","inputSchema":{"type":"object","properties":{"org":{"type":"string","description":"Organization name to filter repositories"},"type":{"type":"string","enum":["all","public","private"],"description":"Type of repositories to list"}}},"created":"2025-01-29T12:00:00Z","lastUpdated":"2025-01-29T12:00:00Z","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rsc2c8xwvBn4h2Ry50g7"},"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools/emt9h8g7f6e5d4c3b2a1"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},{"id":"emtXy3Wv2Ut1Sr0Qp9On","name":"filter_code","description":"Searches for code across repositories","inputSchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Search query string"},"repo":{"type":"string","description":"Repository to search in"}}},"created":"2025-01-29T12:00:00Z","lastUpdated":"2025-01-29T12:00:00Z","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rsc2c8xwvBn4h2Ry50g7"},"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools/emtXy3Wv2Ut1Sr0Qp9On"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}}],"_embedded":{"metadata":{"total":3}},"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools?search=credential.clientAuthSettingsId%20eq%20%22rsc2c8xwvBn4h2Ry50g7%22&limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools?search=credential.clientAuthSettingsId%20eq%20%22rsc2c8xwvBn4h2Ry50g7%22&after=emtXy3Wv2Ut1Sr0Qp9On&limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},"summary":"List of MCP server tools"},"components/examples/ListMCPServersResponse":{"id":"components/examples/ListMCPServersResponse","value":{"data":[{"id":"ems8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.githubcopilot.com/mcp","status":"ACTIVE","authorizationServerCount":2,"metadata":{"displayName":"GitHub Copilot MCP Server","description":"GitHub Copilot Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-29T10:00:00Z","resourceName":"GitHub Copilot MCP","scopesSupported":["mcp.read","mcp.write"]},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery"}}},{"id":"emsXj2kL9pQw3vNmYt6r","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:emsXj2kL9pQw3vNmYt6r","resourceUrl":"https://api.claude.ai/mcp","status":"ACTIVE","authorizationServerCount":1,"metadata":{"displayName":"Claude AI MCP Server","description":"Claude AI Model Context Protocol Server with tool support"},"detectedMetadata":{"lastRefreshedAt":"2025-01-28T14:30:00Z","resourceName":"Claude MCP","scopesSupported":["mcp.tools.read","mcp.tools.execute"]},"created":"2025-01-28T09:15:00Z","lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/metadata/discovery"}}},{"id":"emsGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:emsGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.openai.com/mcp","status":"INACTIVE","authorizationServerCount":1,"metadata":{"displayName":"OpenAI MCP Server","description":"OpenAI Model Context Protocol Server ready to activate"},"detectedMetadata":{"lastRefreshedAt":"2025-01-27T16:45:00Z","resourceName":"OpenAI MCP","scopesSupported":["mcp.api.read","mcp.api.write"]},"created":"2025-01-27T16:00:00Z","lastUpdated":"2025-01-27T16:45:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/discovery"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers?after=ems5Rf8bK3sQa1nPcVz9&limit=20"}}},"summary":"List of MCP servers"},"components/examples/ListVirtualMCPServerAuthorizationServersResponse":{"id":"components/examples/ListVirtualMCPServerAuthorizationServersResponse","value":{"data":[{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}},{"id":"aus9xYz2kL3mN4oP5qR6","orn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:authorization_servers:aus9xYz2kL3mN4oP5qR6","issuer":"https://{yourOktaDomain}/oauth2/aus9xYz2kL3mN4oP5qR6","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus9xYz2kL3mN4oP5qR6/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus9xYz2kL3mN4oP5qR6/v1/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers/aus9xYz2kL3mN4oP5qR6"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"}}},"summary":"List of authorization servers for a virtual MCP server"},"components/examples/ListVirtualMCPServerToolsResponse":{"id":"components/examples/ListVirtualMCPServerToolsResponse","value":{"data":[{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"}},{"id":"vsc7lM8nO9pQ0rS1tU2v","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt7lM8nO9pQ0rS1tU2v","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"INVALID","profile":{"name":"list_issues","description":"List issues from a repository","alias":"list_issues"}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools?after=vsc7lM8nO9pQ0rS1tU2v&limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"}}},"summary":"List of all tools for the virtual MCP server"},"components/examples/ListVirtualMCPServerToolsWithMetadataResponse":{"id":"components/examples/ListVirtualMCPServerToolsWithMetadataResponse","value":{"data":[{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"},"_embedded":{"inputSchema":{"type":"object","properties":{"repo":{"type":"string"},"state":{"type":"string","enum":["open","closed","all"]}}}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools?expand=inputSchema&limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"}}},"summary":"List of all tools for the virtual MCP server with inputSchema expanded"},"components/examples/ListVirtualMCPServersResourceResponse":{"id":"components/examples/ListVirtualMCPServersResourceResponse","value":{"data":[{"id":"wlp1aB2cD3eF4gH5iJ6k","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp1aB2cD3eF4gH5iJ6k","resourcePath":"production","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/production","status":"ACTIVE","profile":{"displayName":"Production MCP Servers","description":"Groups all production MCP servers for the engineering team"},"created":"2025-06-01T10:00:00Z","lastUpdated":"2025-06-15T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools"}},"_embedded":{"connectedResources":[{"id":"rsc1aB2cD3eF4gH5iJ6k","orn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:resource-connections:rsc1aB2cD3eF4gH5iJ6k","status":"ACTIVE","resource":{"mcpServerId":"ems8nUa7p0g4zrZbs2f4","name":"GitHub MCP"}},{"id":"rsc7lM8nO9pQ0rS1tU2v","orn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:resource-connections:rsc7lM8nO9pQ0rS1tU2v","status":"INACTIVE","resource":{"mcpServerId":"ems2wX4yZ5aB6cD7eF8g","name":"Jira MCP"}}],"attachedAgents":[{"id":"0oa1aB2cD3eF4gH5iJ6k","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:ai-agents:0oa1aB2cD3eF4gH5iJ6k","profile":{"name":"Cursor"}}]}},{"id":"wlp7lM8nO9pQ0rS1tU2v","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp7lM8nO9pQ0rS1tU2v","resourcePath":"staging","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/staging","status":"INACTIVE","profile":{"displayName":"Staging MCP Servers","description":"Groups all staging MCP servers for testing"},"created":"2025-06-10T08:00:00Z","lastUpdated":"2025-06-10T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/tools"}}},{"id":"wlp3wX4yZ5aB6cD7eF8g","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp3wX4yZ5aB6cD7eF8g","resourcePath":"dev-tools","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/dev-tools","status":"ACTIVE","profile":{"displayName":"Development MCP Servers"},"created":"2025-06-12T12:00:00Z","lastUpdated":"2025-06-14T09:15:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp3wX4yZ5aB6cD7eF8g"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp3wX4yZ5aB6cD7eF8g/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp3wX4yZ5aB6cD7eF8g/tools"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers?limit=20&expand=connectedResources&expand=attachedAgents"}}},"summary":"List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)"},"components/examples/MCPServerDiscoveryResponse":{"id":"components/examples/MCPServerDiscoveryResponse","value":{"id":"emd1a2b3c4d5e6f7g8h9","mcpServerId":"ems8nUa7p0g4zrZbs2f4","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rsc2c8xwvBn4h2Ry50g7"},"status":"READY","lastDiscoveredAt":"2025-01-29T12:00:00Z","toolsCount":12,"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery/emd1a2b3c4d5e6f7g8h9"},"mcpServer":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"clientAuthSettings":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/rsc2c8xwvBn4h2Ry50g7"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools?search=credential.clientAuthSettingsId%20eq%20%22rsc2c8xwvBn4h2Ry50g7%22"}}},"summary":"Single MCP server discovery"},"components/examples/MCPServerResponse":{"id":"components/examples/MCPServerResponse","value":{"id":"ems8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.githubcopilot.com/mcp","status":"ACTIVE","authorizationServerCount":2,"metadata":{"displayName":"GitHub Copilot MCP Server","description":"GitHub Copilot Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-29T10:00:00Z","resourceName":"GitHub Copilot MCP","scopesSupported":["mcp.read","mcp.write"]},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery"}}},"summary":"Active MCP server"},"components/examples/MCPServerResponseInvalid":{"id":"components/examples/MCPServerResponseInvalid","value":{"id":"emsBv3nM7pKs5tQxRz1w","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems5Rf8bK3sQa1nPcVz9","resourceUrl":"https://api.invalid-config.com/mcp","status":"INVALID","authorizationServerCount":0,"metadata":{"displayName":"Invalid Config MCP Server","description":"MCP server with invalid configuration"},"created":"2025-01-29T13:00:00Z","lastUpdated":"2025-01-29T13:45:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/metadata/discovery"}}},"summary":"Invalid MCP server (validation failed)"},"components/examples/MCPServerResponseRegistered":{"id":"components/examples/MCPServerResponseRegistered","value":{"id":"emsGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:emsGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.openai.com/mcp","status":"INACTIVE","authorizationServerCount":1,"metadata":{"displayName":"OpenAI MCP Server","description":"OpenAI Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-30T08:20:00Z","resourceName":"OpenAI MCP","scopesSupported":["mcp.api.read","mcp.api.write"]},"created":"2025-01-30T08:15:00Z","lastUpdated":"2025-01-30T08:20:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/discovery"}}},"summary":"Inactive MCP server ready to be activated"},"components/examples/MCPServerResponseWithCounts":{"id":"components/examples/MCPServerResponseWithCounts","value":{"id":"ems8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.githubcopilot.com/mcp","status":"ACTIVE","authorizationServerCount":2,"metadata":{"displayName":"GitHub Copilot MCP Server","description":"GitHub Copilot Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-29T10:00:00Z","resourceName":"GitHub Copilot MCP","scopesSupported":["mcp.read","mcp.write"]},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery"}},"_embedded":{"stats":{"authorizationServersCount":2}}},"summary":"Active MCP server with expanded counts"},"components/examples/MCPServerToolResponse":{"id":"components/examples/MCPServerToolResponse","value":{"id":"emt1a2b3c4d5e6f7g8h9","name":"create_pull_request","description":"Creates a new pull request in a GitHub repository","inputSchema":{"type":"object","required":["repo","title"],"properties":{"repo":{"type":"string","description":"Repository name in owner/repo format"},"title":{"type":"string","description":"Title of the pull request"},"body":{"type":"string","description":"Body content of the pull request"},"head":{"type":"string","description":"Branch to merge from"},"base":{"type":"string","description":"Branch to merge into"}}},"created":"2025-01-29T12:00:00Z","lastUpdated":"2025-01-29T12:00:00Z","credential":{"authType":"CLIENT_AUTH_SETTINGS","clientAuthSettingsId":"rsc2c8xwvBn4h2Ry50g7"},"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools/emt1a2b3c4d5e6f7g8h9"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},"summary":"Single MCP server tool"},"components/examples/ManualAuthorizationServerResponse":{"id":"components/examples/ManualAuthorizationServerResponse","value":{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.external.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.external.com/oauth/authorize","tokenEndpoint":"https://auth.external.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},"summary":"External authorization server"},"components/examples/McpServersSettingsResponse":{"id":"components/examples/McpServersSettingsResponse","value":{"maxMcpServers":1000,"maxAuthServersPerMcpServer":100,"maxClientAuthSettingsPerMcpServer":10,"features":["clientAuthSettings"]},"summary":"MCP Servers Settings"},"components/examples/OktaAuthorizationServerResponse":{"id":"components/examples/OktaAuthorizationServerResponse","value":{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}},"summary":"Okta custom authorization server"},"components/examples/PatchApiServerAuthorizationServerRequest":{"id":"components/examples/PatchApiServerAuthorizationServerRequest","value":{"authorizationEndpoint":"https://auth.example.com/v2/oauth/authorize","tokenEndpoint":"https://auth.example.com/v2/oauth/token"},"summary":"Update authorization server endpoints"},"components/examples/PatchApiServerRequestUpdateMetadata":{"id":"components/examples/PatchApiServerRequestUpdateMetadata","value":{"displayName":"Example API (Updated)","description":"Updated description for Example API"},"summary":"Update display name and description"},"components/examples/PatchAppResourceRequest":{"id":"components/examples/PatchAppResourceRequest","value":{"tenantId":"tenant-456"},"summary":"Update tenant identifier"},"components/examples/PatchClientAuthSettingsRotateSecretExample":{"id":"components/examples/PatchClientAuthSettingsRotateSecretExample","value":{"clientCredentials":{"clientSecret":"new-rotated-secret-value"}},"summary":"Rotate client secret only (most common use case)"},"components/examples/PatchClientAuthSettingsSecretAndScopesExample":{"id":"components/examples/PatchClientAuthSettingsSecretAndScopesExample","value":{"clientCredentials":{"clientSecret":"new-secret-after-rotation"},"oauthConfiguration":{"scopes":["api:full_access"]}},"summary":"Update both secret and scopes together"},"components/examples/PatchClientAuthSettingsUpdateNameExample":{"id":"components/examples/PatchClientAuthSettingsUpdateNameExample","value":{"name":"Updated Server Connection"},"summary":"Update connection name"},"components/examples/PatchClientAuthSettingsUpdateOAuthConfigExample":{"id":"components/examples/PatchClientAuthSettingsUpdateOAuthConfigExample","value":{"oauthConfiguration":{"scopes":["agent:read","agent:write","agent:delete"]}},"summary":"Update OAuth configuration scopes"},"components/examples/PatchMCPServerRequestUpdateMetadata":{"id":"components/examples/PatchMCPServerRequestUpdateMetadata","value":{"displayName":"GitHub Copilot MCP (Updated)","description":"Updated description for GitHub Copilot MCP"},"summary":"Update display name and description"},"components/examples/RegisterAppResourceRequest":{"id":"components/examples/RegisterAppResourceRequest","value":{"appInstanceOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:apps:saml:0oa1gjh63g214q0Hq0g4","resource":{"resourceUrl":"https://api.example.com"},"authorizationServer":{"issuer":"https://auth.example.com"},"tenantId":"tenant-123"},"summary":"Register an app resource"},"components/examples/ResourceServerOperationCompletedResponse":{"id":"components/examples/ResourceServerOperationCompletedResponse","value":{"id":"op-1a2b3c4d","type":"resource-server:Register","status":"COMPLETED","created":"2025-01-29T10:00:00.000Z","started":"2025-01-29T10:00:01.000Z","completed":"2025-01-29T10:00:05.000Z","resource":{"id":"api8nUa7p0g4zrZbs2f4","type":"API_SERVER","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}}},"summary":"Completed resource server operation response"},"components/examples/ResourceServerOperationFailedResponse":{"id":"components/examples/ResourceServerOperationFailedResponse","value":{"id":"op-2b3c4d5e","type":"resource-server:Delete","status":"FAILED","created":"2025-01-29T12:00:00.000Z","started":"2025-01-29T12:00:01.000Z","completed":"2025-01-29T12:00:10.000Z","errorDetails":{"code":"E0000001","message":"Unable to delete resource server due to active connections."}},"summary":"Failed resource server operation response"},"components/examples/ResourceServerOperationInProgressResponse":{"id":"components/examples/ResourceServerOperationInProgressResponse","value":{"id":"op-0f1e2d3c","type":"resource-server:Patch","status":"IN_PROGRESS","created":"2025-01-29T11:00:00.000Z","started":"2025-01-29T11:00:01.000Z"},"summary":"In-progress resource server operation response"},"components/examples/TenantConfigBundleExample":{"id":"components/examples/TenantConfigBundleExample","value":{"tenant_id":"my-org","org_id":"00osn3jvAIHrXVqpn0i3","org_as_metadata_url":"https://example.okta.com/.well-known/oauth-authorization-server","virtual_mcp_servers":[{"name":"usertools","resource_identifier":"https://relay.okta.com/mcp/usertools","idp_client_id":"wlp1aB2cD3eF4gH5iJ6k","metadata_url":"https://dev-123456.okta.com/.well-known/openid-configuration","tools":[{"name":"user/list","target_mcp_server_id":"550e8400-e29b-41d4-a716-446655440000","target_mcp_server_tool_id":"660e8400-e29b-41d4-a716-446655440001"},{"name":"user/create","target_mcp_server_id":"550e8400-e29b-41d4-a716-446655440000","target_mcp_server_tool_id":"770e8400-e29b-41d4-a716-446655440002"},{"name":"user/deactivate","target_mcp_server_id":"550e8400-e29b-41d4-a716-446655440000","target_mcp_server_tool_id":"880e8400-e29b-41d4-a716-446655440003"}]},{"name":"salesforce-integration","resource_identifier":"https://relay.okta.com/mcp/salesforce-integration","idp_client_id":"wlp9kJ8hG7fE6dC5bA4z","metadata_url":"https://dev-123456.okta.com/.well-known/openid-configuration","tools":[{"name":"crm/contacts/search","target_mcp_server_id":"990e8400-e29b-41d4-a716-446655440100","target_mcp_server_tool_id":"aa0e8400-e29b-41d4-a716-446655440101"},{"name":"crm/accounts/update","target_mcp_server_id":"990e8400-e29b-41d4-a716-446655440100","target_mcp_server_tool_id":"bb0e8400-e29b-41d4-a716-446655440102"}]}],"target_mcp_servers":[{"id":"550e8400-e29b-41d4-a716-446655440000","name":"usertools","uri":"https://mcp.usertools.example.com","tools":[{"id":"660e8400-e29b-41d4-a716-446655440001","name":"listUsers","definition":{"description":"Lists all users in the organization with optional filters","title":"List Users","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":200,"default":20},"search":{"type":"string","description":"Search query for filtering users"},"status":{"type":"string","enum":["ACTIVE","DEPROVISIONED","STAGED","PROVISIONED","RECOVERY","LOCKED_OUT","PASSWORD_EXPIRED","SUSPENDED"]}}},"output_schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"profile":{"type":"object"}}}},"annotations":{"title":"List Users","read_only_hint":true,"idempotent_hint":true},"execution":{"task_support":"optional"}}},{"id":"770e8400-e29b-41d4-a716-446655440002","name":"createUser","definition":{"description":"Creates a new user in the organization","title":"Create User","input_schema":{"type":"object","required":["profile"],"properties":{"profile":{"type":"object","required":["firstName","lastName","email","login"],"properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string","format":"email"},"login":{"type":"string"}}},"activate":{"type":"boolean","default":true}}},"annotations":{"destructive_hint":false,"idempotent_hint":false},"execution":{"task_support":"required"}}},{"id":"880e8400-e29b-41d4-a716-446655440003","name":"deactivateUser","definition":{"description":"Deactivates a user account","title":"Deactivate User","input_schema":{"type":"object","required":["userId"],"properties":{"userId":{"type":"string","description":"The ID of the user to deactivate"},"sendEmail":{"type":"boolean","default":false,"description":"Whether to send deactivation email"}}},"annotations":{"destructive_hint":true,"idempotent_hint":true},"execution":{"task_support":"required"}}}],"authorization":{"auth_method":"first_party_token_exchange","target_resource":"https://api.example.com"}},{"id":"990e8400-e29b-41d4-a716-446655440100","name":"Salesforce CRM Server","uri":"https://mcp-salesforce.example.com","tools":[{"id":"aa0e8400-e29b-41d4-a716-446655440101","name":"searchContacts","definition":{"description":"Search for contacts in Salesforce CRM","title":"Search Contacts","input_schema":{"type":"object","properties":{"query":{"type":"string","description":"SOQL query string"},"limit":{"type":"integer","default":50}}},"annotations":{"read_only_hint":true,"open_world_hint":true}}},{"id":"bb0e8400-e29b-41d4-a716-446655440102","name":"updateAccount","definition":{"description":"Updates an account in Salesforce CRM","title":"Update Account","input_schema":{"type":"object","required":["accountId","updates"],"properties":{"accountId":{"type":"string"},"updates":{"type":"object","additionalProperties":true}}},"annotations":{"destructive_hint":false,"idempotent_hint":false}}}],"authorization":{"auth_method":"third_party_token_exchange","target_connection":"salesforce-prod"}}],"principals":[{"client_id":"https://claude.ai/oauth/claude-code-client-metadata","display_name":"Claude Code"},{"client_id":"0oa1234567890abcdef","display_name":"Salesforce Data Assistant"}]},"summary":"Example configuration bundle"},"components/examples/VirtualMCPServerAuthorizationServerResponse":{"id":"components/examples/VirtualMCPServerAuthorizationServerResponse","value":{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}},"summary":"Okta custom authorization server"},"components/examples/VirtualMCPServerResourceResponseActive":{"id":"components/examples/VirtualMCPServerResourceResponseActive","value":{"id":"wlp1aB2cD3eF4gH5iJ6k","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp1aB2cD3eF4gH5iJ6k","resourcePath":"production","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/production","status":"ACTIVE","profile":{"displayName":"Production MCP Servers","description":"Groups all production MCP servers for the engineering team"},"created":"2025-06-01T10:00:00Z","lastUpdated":"2025-06-15T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools"}}},"summary":"Active virtual MCP server"},"components/examples/VirtualMCPServerResourceResponseInactive":{"id":"components/examples/VirtualMCPServerResourceResponseInactive","value":{"id":"wlp7lM8nO9pQ0rS1tU2v","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp7lM8nO9pQ0rS1tU2v","resourcePath":"staging","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/staging","status":"INACTIVE","profile":{"displayName":"Staging MCP Servers","description":"Groups all staging MCP servers for testing"},"created":"2025-06-10T08:00:00Z","lastUpdated":"2025-06-10T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/tools"}}},"summary":"Inactive virtual MCP server"},"components/examples/VirtualMCPServerToolResponse":{"id":"components/examples/VirtualMCPServerToolResponse","value":{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"}},"summary":"Tool from a virtual MCP server"},"components/examples/VirtualMCPServerToolWithMetadataResponse":{"id":"components/examples/VirtualMCPServerToolWithMetadataResponse","value":{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"},"_embedded":{"inputSchema":{"type":"object","properties":{"repo":{"type":"string"},"state":{"type":"string","enum":["open","closed","all"]}}}}},"summary":"Tool from a virtual MCP server with inputSchema expanded"},"components/examples/listResourceServerOperationsResponse":{"id":"components/examples/listResourceServerOperationsResponse","value":{"data":[{"id":"op-1a2b3c4d","type":"resource-server:Register","status":"COMPLETED","created":"2025-01-29T10:00:00.000Z","started":"2025-01-29T10:00:01.000Z","completed":"2025-01-29T10:00:05.000Z","resource":{"id":"api8nUa7p0g4zrZbs2f4","type":"API_SERVER","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}}},{"id":"op-5h6j7k8l","type":"resource-server:Activate","status":"COMPLETED","created":"2025-01-29T10:30:00.000Z","started":"2025-01-29T10:30:01.000Z","completed":"2025-01-29T10:30:02.000Z","resource":{"id":"apiXj2kL9pQw3vNmYt6r","type":"API_SERVER","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r"}}}},{"id":"op-0f1e2d3c","type":"resource-server:Patch","status":"IN_PROGRESS","created":"2025-01-29T11:00:00.000Z","started":"2025-01-29T11:00:01.000Z"},{"id":"op-9m4n5p6q","type":"resource-server:RefreshMetadata","status":"COMPLETED","created":"2025-01-29T11:30:00.000Z","started":"2025-01-29T11:30:01.000Z","completed":"2025-01-29T11:30:03.000Z","resource":{"id":"api8nUa7p0g4zrZbs2f4","type":"API_SERVER","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}}},{"id":"op-7r8s9t0u","type":"resource-server-authorization-server:Link","status":"COMPLETED","created":"2025-01-29T12:00:00.000Z","started":"2025-01-29T12:00:01.000Z","completed":"2025-01-29T12:00:02.000Z"},{"id":"op-3v4w5x6y","type":"resource-server:Discover","status":"COMPLETED","created":"2025-01-29T12:15:00.000Z","started":"2025-01-29T12:15:01.000Z","completed":"2025-01-29T12:15:08.000Z","resource":{"id":"api8nUa7p0g4zrZbs2f4","type":"API_SERVER","status":"ACTIVE","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}}},{"id":"op-2b3c4d5e","type":"resource-server:Delete","status":"FAILED","created":"2025-01-29T12:30:00.000Z","started":"2025-01-29T12:30:01.000Z","completed":"2025-01-29T12:30:10.000Z","errorDetails":{"code":"E0000001","message":"Unable to delete Resource server due to active connections."}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/operations"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/operations?after=op-2b3c4d5e"}}},"summary":"List of resource server operations"},"paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/200/content/application~1json/examples/List of A2A servers":{"value":{"data":[{"a2aServerId":"wlpx9jQ16k9V8IFEL0g3","orn":"orn:okta:directory:00o5rb5mt2H3d1TJd0h7:resource-servers:a2a:wlpx9jQ16k9V8IFEL0g3","resourceUrl":"https://demo-agent.example.com","created":"2025-01-27T08:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3"},"ai-agent":{"href":"https://{yourOktaDomain}/workload-principals/api/v1/ai-agents/wlpx9jQ16k9V8IFEL0g3"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers?after=wlpx9jQ16k9V8IFEL0g3&limit=20"}}},"key":"List of A2A servers","summary":"List of A2A servers","id":"paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/200/content/application~1json/examples/List of A2A servers"},"paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1a2a-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/200/content/application~1json/examples/A2A server":{"value":{"a2aServerId":"wlpx9jQ16k9V8IFEL0g3","orn":"orn:okta:directory:00o5rb5mt2H3d1TJd0h7:resource-servers:a2a:wlpx9jQ16k9V8IFEL0g3","resourceUrl":"https://demo-agent.example.com","created":"2025-01-27T08:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3"},"ai-agent":{"href":"https://{yourOktaDomain}/workload-principals/api/v1/ai-agents/wlpx9jQ16k9V8IFEL0g3"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers"}}},"key":"A2A server","summary":"A2A server","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/200/content/application~1json/examples/A2A server"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an A2A server":{"value":{"data":[{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/a2a-servers/wlpx9jQ16k9V8IFEL0g3"}}},"key":"List of authorization servers for an A2A server","summary":"List of authorization servers for an A2A server","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an A2A server"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server":{"value":{"type":"OKTA","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7"},"key":"Add an Okta custom authorization server","summary":"Add an Okta custom authorization server","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an Okta custom authorization server"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/Okta custom authorization server":{"value":{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://{yourOktaDomain}/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","grantTypesSupported":["authorization_code","urn:ietf:params:oauth:grant-type:token-exchange"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/aus5rb5mt2H3d1TJd0h7"}}},"key":"Okta custom authorization server","summary":"Okta custom authorization server","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/Okta custom authorization server"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1a2a-servers~1{a2aServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers/get/responses/200/content/application~1json/examples/List of API servers":{"value":{"data":[{"id":"api8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.example.com","status":"ACTIVE","metadata":{"displayName":"Example API","description":"Example API server"},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":2,"clientAuthSettings":5}}},{"id":"apiXj2kL9pQw3vNmYt6r","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:apiXj2kL9pQw3vNmYt6r","resourceUrl":"https://api.twilio.com","status":"ACTIVE","metadata":{"displayName":"Twilio API","description":"Twilio communications API"},"created":"2025-01-28T09:15:00Z","lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiXj2kL9pQw3vNmYt6r"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiXj2kL9pQw3vNmYt6r/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":1,"clientAuthSettings":3}}},{"id":"apiGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:apiGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.sendgrid.com","status":"INACTIVE","metadata":{"displayName":"SendGrid API","description":"SendGrid email delivery API"},"created":"2025-01-27T16:00:00Z","lastUpdated":"2025-01-27T16:45:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":0,"clientAuthSettings":0}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers?after=api5Rf8bK3sQa1nPcVz9&limit=20"}}},"key":"List of API servers","summary":"List of API servers","id":"paths/~1resource-servers~1api~1v1~1api-servers/get/responses/200/content/application~1json/examples/List of API servers"},"paths/~1resource-servers~1api~1v1~1api-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server":{"value":{"resourceUrl":"https://api.example.com","displayName":"Example API","description":"Example API server"},"key":"Register an API server","summary":"Register an API server","id":"paths/~1resource-servers~1api~1v1~1api-servers/post/requestBody/content/application~1json/examples/Register an API server"},"paths/~1resource-servers~1api~1v1~1api-servers/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Active API server":{"value":{"id":"api8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:api8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.example.com","status":"ACTIVE","metadata":{"displayName":"Example API","description":"Example API server"},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":2,"clientAuthSettings":5}}},"key":"Active API server","summary":"Active API server","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Active API server"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Inactive API server":{"value":{"id":"apiGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:api:apiGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.sendgrid.com","status":"INACTIVE","metadata":{"displayName":"SendGrid API","description":"SendGrid email delivery API"},"created":"2025-01-30T08:15:00Z","lastUpdated":"2025-01-30T08:20:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/apiGh4dW2vYx9kLmPs7q/authorization-servers"}},"_embedded":{"counts":{"authorizationServers":0,"clientAuthSettings":0}}},"key":"Inactive API server","summary":"Inactive API server","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/200/content/application~1json/examples/Inactive API server"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description":{"value":{"displayName":"Example API (Updated)","description":"Updated description for Example API"},"key":"Update display name and description","summary":"Update display name and description","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an API server":{"value":{"data":[{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.example.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},{"id":"easKj9mN3pWs7vXqRz5t","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easKj9mN3pWs7vXqRz5t","issuer":"https://auth.example.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers/easKj9mN3pWs7vXqRz5t"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/api-servers/api8nUa7p0g4zrZbs2f4/authorization-servers?after=aus5rb5mt2H3d1TJd0h7&limit=20"}}},"key":"List of authorization servers for an API server","summary":"List of authorization servers for an API server","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an API server"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server":{"value":{"type":"MANUAL","issuer":"https://auth.example.com","authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"key":"Add an authorization server","summary":"Add an authorization server","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/requestBody/content/application~1json/examples/Add an authorization server"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/External authorization server":{"value":{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.external.com","status":"ACTIVE","metadata":{"authorizationEndpoint":"https://auth.external.com/oauth/authorize","tokenEndpoint":"https://auth.external.com/oauth/token","grantTypesSupported":["authorization_code","refresh_token"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/{resource-type}/{resourceId}/authorization-servers/eas8nUa7p0g4zrZbs2f4"}}},"key":"External authorization server","summary":"External authorization server","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/200/content/application~1json/examples/External authorization server"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints":{"value":{"authorizationEndpoint":"https://auth.example.com/v2/oauth/authorize","tokenEndpoint":"https://auth.example.com/v2/oauth/token"},"key":"Update authorization server endpoints","summary":"Update authorization server endpoints","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update authorization server endpoints"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1authorization-servers~1{authorizationServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1api-servers~1{apiServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/200/content/application~1json/examples/List of MCP servers":{"value":{"data":[{"id":"ems8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.githubcopilot.com/mcp","status":"ACTIVE","authorizationServerCount":2,"metadata":{"displayName":"GitHub Copilot MCP Server","description":"GitHub Copilot Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-29T10:00:00Z","resourceName":"GitHub Copilot MCP","scopesSupported":["mcp.read","mcp.write"]},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery"}}},{"id":"emsXj2kL9pQw3vNmYt6r","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:emsXj2kL9pQw3vNmYt6r","resourceUrl":"https://api.claude.ai/mcp","status":"ACTIVE","authorizationServerCount":1,"metadata":{"displayName":"Claude AI MCP Server","description":"Claude AI Model Context Protocol Server with tool support"},"detectedMetadata":{"lastRefreshedAt":"2025-01-28T14:30:00Z","resourceName":"Claude MCP","scopesSupported":["mcp.tools.read","mcp.tools.execute"]},"created":"2025-01-28T09:15:00Z","lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsXj2kL9pQw3vNmYt6r/metadata/discovery"}}},{"id":"emsGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:emsGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.openai.com/mcp","status":"INACTIVE","authorizationServerCount":1,"metadata":{"displayName":"OpenAI MCP Server","description":"OpenAI Model Context Protocol Server ready to activate"},"detectedMetadata":{"lastRefreshedAt":"2025-01-27T16:45:00Z","resourceName":"OpenAI MCP","scopesSupported":["mcp.api.read","mcp.api.write"]},"created":"2025-01-27T16:00:00Z","lastUpdated":"2025-01-27T16:45:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/discovery"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers?after=ems5Rf8bK3sQa1nPcVz9&limit=20"}}},"key":"List of MCP servers","summary":"List of MCP servers","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/200/content/application~1json/examples/List of MCP servers"},"paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server":{"value":{"resourceUrl":"https://api.githubcopilot.com/mcp","displayName":"GitHub Copilot MCP","description":"GitHub Copilot Model Context Protocol Server"},"key":"Register an MCP server","summary":"Register an MCP server","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/post/requestBody/content/application~1json/examples/Register an MCP server"},"paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server":{"value":{"id":"ems8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.githubcopilot.com/mcp","status":"ACTIVE","authorizationServerCount":2,"metadata":{"displayName":"GitHub Copilot MCP Server","description":"GitHub Copilot Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-29T10:00:00Z","resourceName":"GitHub Copilot MCP","scopesSupported":["mcp.read","mcp.write"]},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery"}}},"key":"Active MCP server","summary":"Active MCP server","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server with expanded counts":{"value":{"id":"ems8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","resourceUrl":"https://api.githubcopilot.com/mcp","status":"ACTIVE","authorizationServerCount":2,"metadata":{"displayName":"GitHub Copilot MCP Server","description":"GitHub Copilot Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-29T10:00:00Z","resourceName":"GitHub Copilot MCP","scopesSupported":["mcp.read","mcp.write"]},"created":"2025-01-29T10:00:00Z","lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/metadata/discovery"}},"_embedded":{"stats":{"authorizationServersCount":2}}},"key":"Active MCP server with expanded counts","summary":"Active MCP server with expanded counts","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Active MCP server with expanded counts"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Inactive MCP server ready to be activated":{"value":{"id":"emsGh4dW2vYx9kLmPs7q","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:emsGh4dW2vYx9kLmPs7q","resourceUrl":"https://api.openai.com/mcp","status":"INACTIVE","authorizationServerCount":1,"metadata":{"displayName":"OpenAI MCP Server","description":"OpenAI Model Context Protocol Server"},"detectedMetadata":{"lastRefreshedAt":"2025-01-30T08:20:00Z","resourceName":"OpenAI MCP","scopesSupported":["mcp.api.read","mcp.api.write"]},"created":"2025-01-30T08:15:00Z","lastUpdated":"2025-01-30T08:20:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsGh4dW2vYx9kLmPs7q/metadata/discovery"}}},"key":"Inactive MCP server ready to be activated","summary":"Inactive MCP server ready to be activated","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Inactive MCP server ready to be activated"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Invalid MCP server (validation failed)":{"value":{"id":"emsBv3nM7pKs5tQxRz1w","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems5Rf8bK3sQa1nPcVz9","resourceUrl":"https://api.invalid-config.com/mcp","status":"INVALID","authorizationServerCount":0,"metadata":{"displayName":"Invalid Config MCP Server","description":"MCP server with invalid configuration"},"created":"2025-01-29T13:00:00Z","lastUpdated":"2025-01-29T13:45:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w"},"refresh-metadata":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/metadata/refresh"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/tools"},"discovery":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/emsBv3nM7pKs5tQxRz1w/metadata/discovery"}}},"key":"Invalid MCP server (validation failed)","summary":"Invalid MCP server (validation failed)","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/200/content/application~1json/examples/Invalid MCP server (validation failed)"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description":{"value":{"displayName":"GitHub Copilot MCP (Updated)","description":"Updated description for GitHub Copilot MCP"},"key":"Update display name and description","summary":"Update display name and description","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/requestBody/content/application~1merge-patch+json/examples/Update display name and description"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/patch/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/409/content/application~1json/examples/Conflict":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: {0}","errorLink":"E0000195","errorId":"sampleMlLvGUj_YD5v15vkYWX","errorCauses":[]},"key":"Conflict","summary":"Conflict","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/409/content/application~1json/examples/Conflict"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}/delete/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an MCP server":{"value":{"data":[{"id":"eas8nUa7p0g4zrZbs2f4","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:eas8nUa7p0g4zrZbs2f4","issuer":"https://auth.github.com","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://github.com/login/oauth/authorize","tokenEndpoint":"https://github.com/login/oauth/access_token","registrationEndpoint":"https://github.com/login/oauth/register","grantTypesSupported":["authorization_code","refresh_token"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-29T10:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"easKj9mN3pWs7vXqRz5t","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easKj9mN3pWs7vXqRz5t","issuer":"https://auth.example.com","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://auth.example.com/oauth/authorize","tokenEndpoint":"https://auth.example.com/oauth/token","registrationEndpoint":"https://auth.example.com/oauth/register","grantTypesSupported":["authorization_code","refresh_token"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-28T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"easPt2bL7qXj4sKvMc8n","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easPt2bL7qXj4sKvMc8n","issuer":"https://auth.invalid.com","status":"INVALID","lastUpdated":"2025-01-27T09:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"aus5rb5mt2H3d1TJd0h7","orn":"orn:okta:idp:00o5rb5mt2H3d1TJd0h7:authorization_servers:aus5rb5mt2H3d1TJd0h7","issuer":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7","status":"ACTIVE","detectedMetadata":{"authorizationEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/authorize","tokenEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/token","registrationEndpoint":"https://dev-123456.okta.com/oauth2/aus5rb5mt2H3d1TJd0h7/v1/register","grantTypesSupported":["authorization_code","refresh_token","urn:ietf:params:oauth:grant-type:token-exchange"],"identityChainingRequestedTokenTypesSupported":["urn:ietf:params:oauth:token-type:id-jag"],"tokenEndpointAuthMethodsSupported":["client_secret_basic","client_secret_post"]},"lastUpdated":"2025-01-27T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}},{"id":"easWq5hR9tNm2vKbXc7p","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:external-authorization-servers:easWq5hR9tNm2vKbXc7p","status":"INACTIVE","issuer":"https://auth.newservice.com","lastUpdated":"2025-01-26T12:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4/authorization-servers?limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/mcp-servers/ems8nUa7p0g4zrZbs2f4"}}},"key":"List of authorization servers for an MCP server","summary":"List of authorization servers for an MCP server","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/200/content/application~1json/examples/List of authorization servers for an MCP server"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1authorization-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/409/content/application~1json/examples/Conflict":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: {0}","errorLink":"E0000195","errorId":"sampleMlLvGUj_YD5v15vkYWX","errorCauses":[]},"key":"Conflict","summary":"Conflict","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/409/content/application~1json/examples/Conflict"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1activate/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/409/content/application~1json/examples/Conflict":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: {0}","errorLink":"E0000195","errorId":"sampleMlLvGUj_YD5v15vkYWX","errorCauses":[]},"key":"Conflict","summary":"Conflict","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/409/content/application~1json/examples/Conflict"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1lifecycle~1deactivate/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1mcp-servers~1{mcpServerId}~1metadata~1refresh/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/200/content/application~1json/examples/List client authentication settings with both STS and AGENT_IMPORT types":{"value":{"data":[{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},{"id":"con3a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con3a2b3c4d5e6f7g8h9"}}},{"id":"con2b3c4d5e6f7g8h9i0","purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:okta_workflows:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]},"created":"2024-01-29T11:30:00.000Z","lastUpdated":"2024-01-29T11:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con2b3c4d5e6f7g8h9i0"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings?after=con2b3c4d5e6f7g8h9i0&limit=20"}}},"key":"List client authentication settings with both STS and AGENT_IMPORT types","summary":"List client authentication settings with both STS and AGENT_IMPORT types","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/200/content/application~1json/examples/List client authentication settings with both STS and AGENT_IMPORT types"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS":{"value":{"purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:jira-on-demand:0oa3qcc5apD5lVyql0g7","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4","clientSecret":"very-secret-string-that-is-never-stored-in-plain-text"},"oauthConfiguration":{"scopes":["api:read","api:write"]}},"key":"Create client authentication settings for STS","summary":"Create client authentication settings for STS","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource":{"value":{"purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4","clientSecret":"very-secret-string-that-is-never-stored-in-plain-text"},"oauthConfiguration":{"scopes":["api:read","api:write"]}},"key":"Create client authentication settings for STS with MCP server resource","summary":"Create client authentication settings for STS with MCP server resource","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for STS with MCP server resource"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import":{"value":{"purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:salesforce:0oa3qc3c4d5e6f7ql0g7","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6","clientSecret":"very-secret-string-for-agent-import"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]}},"key":"Create client authentication settings for agent import","summary":"Create client authentication settings for agent import","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for agent import"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR":{"value":{"purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My DCR Server Connection","registrationMethod":"DCR","oauthConfiguration":{"scopes":["mcp:connect"]}},"key":"Create client authentication settings for an MCP server using DCR","summary":"Create client authentication settings for an MCP server using DCR","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/requestBody/content/application~1json/examples/Create client authentication settings for an MCP server using DCR"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service)":{"value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"key":"Client authentication settings for STS (Security Token Service)","summary":"Client authentication settings for STS (Security Token Service)","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service)"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource":{"value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"key":"Client authentication settings for STS (Security Token Service) with MCP server resource","summary":"Client authentication settings for STS (Security Token Service) with MCP server resource","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for agent import":{"value":{"id":"con2b3c4d5e6f7g8h9i0","purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:salesforce:0oa3qc3c4d5e6f7ql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]},"created":"2024-01-29T11:30:00.000Z","lastUpdated":"2024-01-29T11:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con2b3c4d5e6f7g8h9i0"}}},"key":"Client authentication settings for agent import","summary":"Client authentication settings for agent import","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/201/content/application~1json/examples/Client authentication settings for agent import"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings/post/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)":{"value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"key":"Client authentication settings for STS (Security Token Service)","summary":"Client authentication settings for STS (Security Token Service)","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource":{"value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4","authorizationServerOrn":"orn:okta:directory:00o1n8sbwArJ7OQRw406:external-authorization-servers:eas1gjh63g214q0Hq0g4","name":"My Server Connection","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"key":"Client authentication settings for STS (Security Token Service) with MCP server resource","summary":"Client authentication settings for STS (Security Token Service) with MCP server resource","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service) with MCP server resource"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for agent import":{"value":{"id":"con2b3c4d5e6f7g8h9i0","purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:salesforce:0oa3qc3c4d5e6f7ql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]},"created":"2024-01-29T11:30:00.000Z","lastUpdated":"2024-01-29T11:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con2b3c4d5e6f7g8h9i0"}}},"key":"Client authentication settings for agent import","summary":"Client authentication settings for agent import","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/200/content/application~1json/examples/Client authentication settings for agent import"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name":{"value":{"name":"Updated Server Connection"},"key":"Update connection name","summary":"Update connection name","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update connection name"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)":{"value":{"clientCredentials":{"clientSecret":"new-rotated-secret-value"}},"key":"Rotate client secret only (most common use case)","summary":"Rotate client secret only (most common use case)","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Rotate client secret only (most common use case)"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes":{"value":{"oauthConfiguration":{"scopes":["agent:read","agent:write","agent:delete"]}},"key":"Update OAuth configuration scopes","summary":"Update OAuth configuration scopes","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update OAuth configuration scopes"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together":{"value":{"clientCredentials":{"clientSecret":"new-secret-after-rotation"},"oauthConfiguration":{"scopes":["api:full_access"]}},"key":"Update both secret and scopes together","summary":"Update both secret and scopes together","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/requestBody/content/application~1merge-patch+json/examples/Update both secret and scopes together"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)":{"value":{"id":"con1a2b3c4d5e6f7g8h9","purpose":["STS"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:githubcloud:0oa3qcb4dpD5lVyql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa1gjh63g214q0Hq0g4"},"created":"2024-01-29T10:30:00.000Z","lastUpdated":"2024-01-29T10:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con1a2b3c4d5e6f7g8h9"}}},"key":"Client authentication settings for STS (Security Token Service)","summary":"Client authentication settings for STS (Security Token Service)","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for STS (Security Token Service)"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for agent import":{"value":{"id":"con2b3c4d5e6f7g8h9i0","purpose":["AGENT_IMPORT"],"protocol":"OAUTH2","resourceOrn":"orn:okta:idp:00o3qcb4dpD5lnDql0g7:apps:salesforce:0oa3qc3c4d5e6f7ql0g7","registrationMethod":"STATIC","clientCredentials":{"clientId":"0oa2ijk85h425r2Jt2i6"},"oauthConfiguration":{"scopes":["agent:read","agent:import"]},"created":"2024-01-29T11:30:00.000Z","lastUpdated":"2024-01-29T11:35:00.000Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/client-auth-settings/con2b3c4d5e6f7g8h9i0"}}},"key":"Client authentication settings for agent import","summary":"Client authentication settings for agent import","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/200/content/application~1json/examples/Client authentication settings for agent import"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/400/content/application~1json/examples/API Validation Failed":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: {0}","errorLink":"E0000001","errorId":"sampleiCF-8D5rLW6myqiPItW","errorCauses":[]},"key":"API Validation Failed","summary":"API Validation Failed","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/400/content/application~1json/examples/API Validation Failed"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/patch/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1client-auth-settings~1{clientAuthSettingsId}/delete/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/200/content/application~1json/examples/List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)":{"value":{"data":[{"id":"wlp1aB2cD3eF4gH5iJ6k","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp1aB2cD3eF4gH5iJ6k","resourcePath":"production","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/production","status":"ACTIVE","profile":{"displayName":"Production MCP Servers","description":"Groups all production MCP servers for the engineering team"},"created":"2025-06-01T10:00:00Z","lastUpdated":"2025-06-15T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools"}},"_embedded":{"connectedResources":[{"id":"rsc1aB2cD3eF4gH5iJ6k","orn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:resource-connections:rsc1aB2cD3eF4gH5iJ6k","status":"ACTIVE","resource":{"mcpServerId":"ems8nUa7p0g4zrZbs2f4","name":"GitHub MCP"}},{"id":"rsc7lM8nO9pQ0rS1tU2v","orn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:resource-connections:rsc7lM8nO9pQ0rS1tU2v","status":"INACTIVE","resource":{"mcpServerId":"ems2wX4yZ5aB6cD7eF8g","name":"Jira MCP"}}],"attachedAgents":[{"id":"0oa1aB2cD3eF4gH5iJ6k","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:ai-agents:0oa1aB2cD3eF4gH5iJ6k","profile":{"name":"Cursor"}}]}},{"id":"wlp7lM8nO9pQ0rS1tU2v","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp7lM8nO9pQ0rS1tU2v","resourcePath":"staging","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/staging","status":"INACTIVE","profile":{"displayName":"Staging MCP Servers","description":"Groups all staging MCP servers for testing"},"created":"2025-06-10T08:00:00Z","lastUpdated":"2025-06-10T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/tools"}}},{"id":"wlp3wX4yZ5aB6cD7eF8g","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp3wX4yZ5aB6cD7eF8g","resourcePath":"dev-tools","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/dev-tools","status":"ACTIVE","profile":{"displayName":"Development MCP Servers"},"created":"2025-06-12T12:00:00Z","lastUpdated":"2025-06-14T09:15:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp3wX4yZ5aB6cD7eF8g"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp3wX4yZ5aB6cD7eF8g/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp3wX4yZ5aB6cD7eF8g/tools"}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers?limit=20&expand=connectedResources&expand=attachedAgents"}}},"key":"List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)","summary":"List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/200/content/application~1json/examples/List of virtual MCP servers (with `?expand=connectedResources&expand=attachedAgents`)"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Active virtual MCP server":{"value":{"id":"wlp1aB2cD3eF4gH5iJ6k","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp1aB2cD3eF4gH5iJ6k","resourcePath":"production","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/production","status":"ACTIVE","profile":{"displayName":"Production MCP Servers","description":"Groups all production MCP servers for the engineering team"},"created":"2025-06-01T10:00:00Z","lastUpdated":"2025-06-15T14:30:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools"}}},"key":"Active virtual MCP server","summary":"Active virtual MCP server","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Active virtual MCP server"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Inactive virtual MCP server":{"value":{"id":"wlp7lM8nO9pQ0rS1tU2v","orn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:virtual-mcp:wlp7lM8nO9pQ0rS1tU2v","resourcePath":"staging","resourceUrl":"https://{yourOktaSubdomain}.gateway.okta.com/mcp/staging","status":"INACTIVE","profile":{"displayName":"Staging MCP Servers","description":"Groups all staging MCP servers for testing"},"created":"2025-06-10T08:00:00Z","lastUpdated":"2025-06-10T08:00:00Z","_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v"},"authorization-servers":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/authorization-servers"},"tools":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp7lM8nO9pQ0rS1tU2v/tools"}}},"key":"Inactive virtual MCP server","summary":"Inactive virtual MCP server","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/200/content/application~1json/examples/Inactive virtual MCP server"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server":{"value":{"data":[{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"}},{"id":"vsc7lM8nO9pQ0rS1tU2v","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt7lM8nO9pQ0rS1tU2v","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"INVALID","profile":{"name":"list_issues","description":"List issues from a repository","alias":"list_issues"}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools?limit=20"},"next":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools?after=vsc7lM8nO9pQ0rS1tU2v&limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"}}},"key":"List of all tools for the virtual MCP server","summary":"List of all tools for the virtual MCP server","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server with inputSchema expanded":{"value":{"data":[{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"},"_embedded":{"inputSchema":{"type":"object","properties":{"repo":{"type":"string"},"state":{"type":"string","enum":["open","closed","all"]}}}}}],"_links":{"self":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k/tools?expand=inputSchema&limit=20"},"parent":{"href":"https://{yourOktaDomain}/resource-servers/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k"}}},"key":"List of all tools for the virtual MCP server with inputSchema expanded","summary":"List of all tools for the virtual MCP server with inputSchema expanded","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/200/content/application~1json/examples/List of all tools for the virtual MCP server with inputSchema expanded"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server":{"value":{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"}},"key":"Tool from a virtual MCP server","summary":"Tool from a virtual MCP server","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server with inputSchema expanded":{"value":{"id":"vsc1aB2cD3eF4gH5iJ6k","sourceOrn":"orn:okta:directory:00o1gjjp4jsdR3Sww4x7:resource-servers:mcp:ems8nUa7p0g4zrZbs2f4:tools:emt1aB2cD3eF4gH5iJ6k","connectionOrn":"orn:okta:idp:00o1gjjp4jsdR3Sww4x7:connections:mcn1aB2cD3eF4gH5iJ6k","status":"VALID","profile":{"name":"get_issues","description":"Get issues from a repository","alias":"get_jira_issues"},"_embedded":{"inputSchema":{"type":"object","properties":{"repo":{"type":"string"},"state":{"type":"string","enum":["open","closed","all"]}}}}},"key":"Tool from a virtual MCP server with inputSchema expanded","summary":"Tool from a virtual MCP server with inputSchema expanded","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/200/content/application~1json/examples/Tool from a virtual MCP server with inputSchema expanded"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/403/content/application~1json/examples/Access Denied":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action","errorLink":"E0000006","errorId":"sampleNUSD_8fdkFd8fs8SDBK","errorCauses":[]},"key":"Access Denied","summary":"Access Denied","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/403/content/application~1json/examples/Access Denied"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"errorCode":"E0000007","errorSummary":"Not found: {0}","errorLink":"E0000007","errorId":"sampleMlLvGUj_YD5v16vkYWY","errorCauses":[]},"key":"Resource Not Found","summary":"Resource Not Found","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1resource-servers~1api~1v1~1virtual-mcp-servers~1{virtualMcpServerId}~1tools~1{capabilityId}/get/responses/429/content/application~1json/examples/Too Many Requests"},"paths/~1oauth2~1v1~1sts~1callback/get/responses/429/content/application~1json/examples/Too Many Requests":{"value":{"errorCode":"E0000047","errorSummary":"API call exceeded rate limit due to too many requests.","errorLink":"E0000047","errorId":"sampleQPivGUj_ND5v78vbYWW","errorCauses":[]},"key":"Too Many Requests","summary":"Too Many Requests","id":"paths/~1oauth2~1v1~1sts~1callback/get/responses/429/content/application~1json/examples/Too Many Requests"}},"securitySchemeStore":{"apiToken":{"id":"apiToken","type":"apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass the API token as the Authorization header value prefixed with SSWS: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: SSWS {API Token}"},"children":[]}]}]}],"in":"header","paramName":"Authorization"},"ephemeralJwt":{"id":"ephemeralJwt","type":"apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ORD Ephemeral JWT for interservice authentication. Used by internal Okta services"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(for example, the A0 Relay) to authenticate through short-lived X.509-backed JWTs."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The JWT is signed with an ephemeral private key; the full certificate chain is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"embedded in the JWT "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x5c"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header parameter and validated against the trusted"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Infrastructure CA certificate chain. Pass as: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: SSWS {jwt}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"in":"header","paramName":"Authorization"},"oauth2":{"id":"oauth2","type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass the access_token as the value of the Authorization header: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer {access_token}"},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"/oauth2/v1/authorize","tokenUrl":"/oauth2/v1/token","scopes":{"okta.agentGateway.read":"Allows the app to read agent gateway configuration.","okta.aiAgents.manage":"Allows the app to manage AI agents in your Okta organization.","okta.aiAgents.read":"Allows the app to read information about AI agents in your Okta organization.","okta.authorizationServers.read":"Allows the app to read information about Authorization Servers in your Okta organization.","okta.resourceServers.apiServers.manage":"Allows the app to manage API servers in your Okta organization.","okta.resourceServers.apiServers.read":"Allows the app to read information about API servers in your Okta organization.","okta.resourceServers.clientAuthSettings.manage":"Allows the app to manage client authentication settings for resource servers in your Okta organization.","okta.resourceServers.clientAuthSettings.read":"Allows the app to read client authentication settings for resource servers in your Okta organization.","okta.resourceServers.manage":"Allows the app to manage resource servers in your Okta organization.","okta.resourceServers.mcpServers.manage":"Allows the app to manage MCP servers in your Okta organization.","okta.resourceServers.mcpServers.read":"Allows the app to read information about MCP servers in your Okta organization.","okta.resourceServers.read":"Allows the app to read information about resource servers in your Okta organization.","okta.resourceServers.virtualMcpServers.manage":"Allows the app to manage virtual MCP servers in your Okta organization.","okta.resourceServers.virtualMcpServers.read":"Allows the app to read information about virtual MCP servers in your Okta organization."}}}}},"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com","description":"The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains."}}}]},"options":{"hideInfoMetadata":true,"hideDownloadButtons":true,"hideReplay":true,"layout":"three-panel","sanitize":true,"codeSamples":{"languages":[{"lang":"curl"},{"lang":"C#"},{"lang":"Java"},{"lang":"JavaScript"},{"lang":"Node.js"},{"lang":"Python"},{"lang":"Go"},{"lang":"PHP"},{"lang":"Ruby"},{"lang":"Payload"}]},"feedback":{"hide":true,"settings":{"label":""}},"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/docs/api/_bundle/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers.json?download"},{"url":"/docs/api/_bundle/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Okta for AI Agents","description":"APIs for registering, managing, and securing AI agents and their connections to resources in your Okta org."}},"baseSlug":"/secures-ai/openapi/secures-ai-resource-servers/secures-ai-resource-servers","routesMapping":{}}