Skip to main content

This browser is no longer supported.

Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.

Download Microsoft Edge More info about Internet Explorer and Microsoft Edge
microsoft-foundry.rest.security.o-auth2-auth

Agent Microsoft 365 Publishing

Get Microsoft 365 publish defaults

GET /agents/{agent_name}/microsoft365/publishdefaults

Returns default and previously-published values used to pre-populate a Microsoft 365 publish request for a Foundry agent.

Path parameters

agent_name string required

The name of the agent to get publish defaults for.

Query parameters

publishAsDigitalWorker boolean

When true, returns defaults for publishing the agent as an autopilot (digital worker) agent.

api-version string required

The API version to use for this operation.

Responses

The request has succeeded.

Body

Content-Type: application/json
appPublishScope string | enum

The publish scope for the generated Microsoft Teams app.

Any of the following:
string
enum
PersonalSharedTenant
agentName string

The agent name.

agentDisplayName string

The user-facing display name for the agent. Defaults to the agent name if not previously overridden.

appRegistrationClientId string

The app-registration client id associated with the agent.

botServiceArmId string

ARM resource id of the Azure Bot Service associated with the previously-published app, if any.

appVersion string

The most recently published app version.

recommendedNextAppVersion string

The recommended next app version (the most recent app version, incremented).

titleId string

The Microsoft 365 title id of the previously-published app, if any.

teamsAppId string

The Microsoft Teams app id of the previously-published app, if any.

shortDescription string

Short, one-line description shown in the Teams app listing.

fullDescription string

Full description shown on the Teams app details page.

developerName string

Display name of the developer / publisher.

developerWebsiteUrl string

Developer / publisher website URL.

privacyUrl string

Privacy policy URL.

termsOfUseUrl string

Terms-of-use URL.

Client error

Body

Content-Type: application/json
error OpenAI.Error required
code string | null required
message string required
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
Any of the following:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string required

The public continuation instruction.

details OpenAI.Error[]
additionalInfo object
debugInfo object

Server error

Body

Content-Type: application/json
error OpenAI.Error required
code string | null required
message string required
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
Any of the following:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string required

The public continuation instruction.

details OpenAI.Error[]
additionalInfo object
debugInfo object

Request

GET /agents/{agent_name}/microsoft365/publishdefaults HTTP/1.1

Response

Status: 200
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
en-us
Your Privacy Choices
  • AI Disclaimer
  • Previous Versions
  • Blog
  • Contribute
  • Privacy
  • Consumer Health Privacy
  • Terms of Use
  • Trademarks
  • © Microsoft 2026