{
  "title": "Codeunit 4321 Agent",
  "url": "https://jonas-paprotka.de/ref/codeunit/4321-agent/",
  "author": "Jonas Paprotka",
  "license": "Content © 2026 Jonas Paprotka. Quote freely with attribution and a link.",
  "subject": "Microsoft Dynamics 365 Business Central",
  "checked": "2026-09-20",
  "source": {
    "feed": "https://dynamicssmb2.pkgs.visualstudio.com/DynamicsBCPublicFeeds/_packaging/MSSymbols/nuget/v3/index.json",
    "package": "Microsoft.SystemApplication.symbols.63ca2fa4-4f03-4f2b-a480-172fef340d3f",
    "build": "28.5.54151.54365",
    "code": {
      "25": {
        "url": "https://jonas-paprotka.de/ref/codeunit/4321-agent/source/25/",
        "repo": "https://github.com/microsoft/BCApps",
        "branch": "releases/25.x",
        "commit": "68d52c129129c83b2e396a473aaa5b2ce61d2eed",
        "path": "src/System Application/App/Agent/Setup/Agent.Codeunit.al",
        "license": "MIT"
      },
      "26": {
        "url": "https://jonas-paprotka.de/ref/codeunit/4321-agent/source/26/",
        "repo": "https://github.com/microsoft/BCApps",
        "branch": "releases/26.x",
        "commit": "78c4acf0d64a8eee157ea80164fa8fc2acffc9eb",
        "path": "src/System Application/App/Agent/Setup/Agent.Codeunit.al",
        "license": "MIT"
      },
      "27": {
        "url": "https://jonas-paprotka.de/ref/codeunit/4321-agent/source/27/",
        "repo": "https://github.com/microsoft/BCApps",
        "branch": "releases/27.x",
        "commit": "1749020b4c9445a43e4f7f540e89b7fa76ec25fd",
        "path": "src/System Application/App/Agent/Setup/Agent.Codeunit.al",
        "license": "MIT"
      },
      "28": {
        "url": "https://jonas-paprotka.de/ref/codeunit/4321-agent/source/28/",
        "repo": "https://github.com/microsoft/BCApps",
        "branch": "releases/28.x",
        "commit": "740f59156b249f8ed7cba2e28423f03ae7b07233",
        "path": "src/System Application/App/Agent/Setup/Agent.Codeunit.al",
        "license": "MIT"
      },
      "29": {
        "url": "https://jonas-paprotka.de/ref/codeunit/4321-agent/source/29/",
        "repo": "https://github.com/microsoft/BCApps",
        "branch": "releases/29.x",
        "commit": "a66254c3b8b5bb1cea290dc8f9d097aec4381153",
        "path": "src/System Application/App/Agent/Setup/Agent.Codeunit.al",
        "license": "MIT"
      }
    },
    "note": "Presence per major, highest build of each; 17 is the oldest major on the feed. Local procedures are not listed."
  },
  "object": {
    "type": "codeunit",
    "id": 4321,
    "name": "Agent",
    "app": "System Application",
    "appByVersion": [
      {
        "app": "System Application",
        "from": 25
      }
    ],
    "nameByVersion": [
      {
        "name": "Agent",
        "from": 25
      }
    ],
    "namespace": "System.Agents",
    "versions": "25-28",
    "majors": [
      25,
      26,
      27,
      28
    ],
    "extends": null,
    "sourceTable": null,
    "sourceFile": "Agent/Setup/Agent.Codeunit.al",
    "obsolete": null,
    "obsoleteSeenFrom": null,
    "byVersion": {
      "25": {
        "app": "system-application",
        "name": "Agent",
        "ns": "System.Agents",
        "obsolete": null,
        "target": "",
        "sourceTable": "",
        "counts": {
          "fields": 0,
          "keys": 0,
          "methods": 12,
          "values": 0
        },
        "stub": false
      },
      "26": {
        "app": "system-application",
        "name": "Agent",
        "ns": "System.Agents",
        "obsolete": null,
        "target": "",
        "sourceTable": "",
        "counts": {
          "fields": 0,
          "keys": 0,
          "methods": 12,
          "values": 0
        },
        "stub": false
      },
      "27": {
        "app": "system-application",
        "name": "Agent",
        "ns": "System.Agents",
        "obsolete": null,
        "target": "",
        "sourceTable": "",
        "counts": {
          "fields": 0,
          "keys": 0,
          "methods": 23,
          "values": 0
        },
        "stub": false
      },
      "28": {
        "app": "system-application",
        "name": "Agent",
        "ns": "System.Agents",
        "obsolete": null,
        "target": "",
        "sourceTable": "",
        "counts": {
          "fields": 0,
          "keys": 0,
          "methods": 27,
          "values": 0
        },
        "stub": false
      }
    },
    "fields": [],
    "keys": [],
    "procedures": [
      {
        "name": "Create",
        "sig": "(Enum Agent Metadata Provider, Code[50], Text[80], var Record Agent Access Control)",
        "returns": "Guid",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26
        ],
        "range": "25-26",
        "first": 25,
        "last": 26,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 26,
            "returns": "Guid",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "Activate",
        "sig": "(Guid)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "Deactivate",
        "sig": "(Guid)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetDisplayName",
        "sig": "(Guid)",
        "returns": "Text[80]",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "Text[80]",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetUserName",
        "sig": "(Guid)",
        "returns": "Code[50]",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "Code[50]",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "SetDisplayName",
        "sig": "(Guid, Text[80])",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "SetInstructions",
        "sig": "(Guid, SecretText)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "IsActive",
        "sig": "(Guid)",
        "returns": "Boolean",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "Boolean",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "SetProfile",
        "sig": "(Guid, var Record All Profile)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "AssignPermissionSet",
        "sig": "(Guid, var Record Aggregate Permission Set)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26
        ],
        "range": "25-26",
        "first": 25,
        "last": 26,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 26,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetUserAccess",
        "sig": "(Guid, var Record Agent Access Control)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "UpdateAccess",
        "sig": "(Guid, var Record Agent Access Control)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          25,
          26,
          27,
          28
        ],
        "range": "25-28",
        "first": 25,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 25,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "Create",
        "sig": "(Enum Agent Metadata Provider, var Code[50], Text[80], var Record Agent Access Control)",
        "returns": "Guid",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "Guid",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "PopulateDefaultProfile",
        "sig": "(Text[30], Guid, var Record All Profile)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "SetProfile",
        "sig": "(Guid, Text, Guid)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "UpdateLocalizationSettings",
        "sig": "(Guid, Integer, Integer, Text[180])",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetUserSettings",
        "sig": "(Guid, var Record User Settings)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "UpdateAccessControl",
        "sig": "(Guid, var Record Access Control Buffer)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetAccessControl",
        "sig": "(Guid, var Record Access Control Buffer)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetAgentAccessControl",
        "sig": "(Guid, var Record Agent Access Control)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "UpdateAgentAccessControl",
        "sig": "(Guid, var Record Agent Access Control)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "ProfileLookup",
        "sig": "(var Record User Settings)",
        "returns": "Boolean",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "Boolean",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "UpdateLocalizationSettings",
        "sig": "(Guid, var Record User Settings)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "AssignPermissionSet",
        "sig": "(Guid, var Record Access Control Buffer)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "OpenSetupPageId",
        "sig": "(Enum Agent Metadata Provider, Guid)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          27,
          28
        ],
        "range": "27-28",
        "first": 27,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 27,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetModelId",
        "sig": "(Guid)",
        "returns": "Code[30]",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          28
        ],
        "range": "28",
        "first": 28,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 28,
            "to": 28,
            "returns": "Code[30]",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "GetModelName",
        "sig": "(Guid)",
        "returns": "Text[70]",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          28
        ],
        "range": "28",
        "first": 28,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 28,
            "to": 28,
            "returns": "Text[70]",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "SetModelId",
        "sig": "(Guid, Code[30])",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          28
        ],
        "range": "28",
        "first": 28,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 28,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      },
      {
        "name": "SetModelIdToAuto",
        "sig": "(Guid)",
        "returns": "",
        "kind": "procedure",
        "access": "public",
        "obsolete": null,
        "majors": [
          28
        ],
        "range": "28",
        "first": 28,
        "last": 28,
        "obsoleteSince": null,
        "spans": [
          {
            "from": 28,
            "to": 28,
            "returns": "",
            "kind": "procedure",
            "access": "public",
            "obsolete": null
          }
        ]
      }
    ],
    "events": [],
    "values": []
  }
}