POST /api/v1/agentPools/{poolId}/updates
Creates an agent pool update
Servers
- https://{yourOktaDomain}
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
poolId |
String | Yes |
ID of the agent pool for which the settings apply to |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | No |
ID of the agent pool update |
_links |
Object | No |
Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations. |
agents[] |
Array | No | |
agents[].id |
String | No |
Unique identifier for the agent that's generated during installation |
agents[]._links |
Object | No |
Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations. |
agents[].isHidden |
Boolean | No |
Determines if an agent is hidden from the Admin Console |
agents[].lastConnection |
Integer | No |
Unix timestamp in milliseconds when the agent last connected to Okta |
agents[].name |
String | No |
Agent name |
agents[].poolId |
String | No |
Pool ID |
agents[].updateMessage |
String | No |
Status message of the agent |
agents[].isLatestGAedVersion |
Boolean | No |
Determines if the agent is on the latest generally available version |
agents[].version |
String | No |
Agent version number |
agents[].type |
String | No |
Agent types that are being monitored Valid values:
|
agents[].operationalStatus |
String | No |
Operational status of a given agent Valid values:
|
agents[].updateStatus |
String | No |
Status for one agent regarding the status to auto-update that agent Valid values:
|
sortOrder |
Integer | No |
Specifies the sort order |
name |
String | No |
Name of the agent pool update |
targetVersion |
String | No |
The agent version to update to |
agentType |
String | No |
Agent types that are being monitored Valid values:
|
notifyAdmin |
Boolean | No |
Indicates if the admin is notified about the update |
enabled |
Boolean | No |
Indicates if auto-update is enabled for the agent pool |
schedule |
Object | No |
The schedule of auto-update configured by the admin |
schedule.timezone |
String | No |
Timezone of where the scheduled job takes place |
schedule.delay |
Integer | No |
Delay in days |
schedule.cron |
String | No |
The schedule of the update in cron format. The cron settings are limited to only the day of the month or the nth-day-of-the-week configurations. For example, |
schedule.duration |
Integer | No |
Duration in minutes |
schedule.lastUpdated |
String | No |
Timestamp when the update finished (only for a successful or failed update, not for a cancelled update). Null is returned if the job hasn't finished once yet. |
status |
String | No |
Overall state for the auto-update job from the admin perspective Valid values:
|
reason |
String | No |
Reason for the update |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.