---
title: "Okta"
description: "Reference for the Tracecat Okta integration: registered actions, required secrets, expected inputs, and example workflow usage."
---

{/* Auto-generated by scripts/generate_tool_docs.py; do not edit by hand. */}
## Create message

Action ID: `tools.okta_oar.create_message`

Create a message in an Okta Access Request ticket.

Reference: [https://developer.okta.com/docs/api/iga/openapi/governance-production-requests-admin-v1-reference/requests/#tag/Requests/operation/createRequestMessage](https://developer.okta.com/docs/api/iga/openapi/governance-production-requests-admin-v1-reference/requests/#tag/Requests/operation/createRequestMessage)

### Secrets

Required secrets:

- `okta`: required values `OKTA_API_TOKEN`.

### Input fields

<ParamField path="message" type="string" required>

Message content to add to the request

</ParamField>

<ParamField path="request_id" type="string" required>

ID of the access request to add message to

</ParamField>

<ParamField path="base_url" type="string | null">

Okta domain base URL (e.g., 'https://your-org.okta.com')

Default: `null`.

</ParamField>

## Get requests

Action ID: `tools.okta_oar.get_requests`

Get Okta Access Request tickets with optional filtering and pagination.

Reference: [https://developer.okta.com/docs/api/iga/openapi/governance-production-requests-admin-v1-reference/requests/](https://developer.okta.com/docs/api/iga/openapi/governance-production-requests-admin-v1-reference/requests/)

### Secrets

Required secrets:

- `okta`: required values `OKTA_API_TOKEN`.

### Input fields

<ParamField path="after" type="string">

Pagination cursor for retrieving next set of results

Default: `""`.

</ParamField>

<ParamField path="base_url" type="string | null">

Okta domain base URL (e.g., 'https://your-org.okta.com')

Default: `null`.

</ParamField>

<ParamField path="filter" type="string">

Filter expression for requests

Default: `""`.

</ParamField>

<ParamField path="limit" type="string">

Number of requests to return (default 20)

Default: `"20"`.

</ParamField>

<ParamField path="order_by" type="string">

Field to order results by

Default: `""`.

</ParamField>

## Get specific request

Action ID: `tools.okta_oar.get_specific_request`

Get a specific Okta Access Request ticket by ID.

Reference: [https://developer.okta.com/docs/api/iga/openapi/governance-production-requests-admin-v1-reference/requests/#tag/Requests/operation/getRequest](https://developer.okta.com/docs/api/iga/openapi/governance-production-requests-admin-v1-reference/requests/#tag/Requests/operation/getRequest)

### Secrets

Required secrets:

- `okta`: required values `OKTA_API_TOKEN`.

### Input fields

<ParamField path="request_id" type="string" required>

ID of the access request to retrieve

</ParamField>

<ParamField path="base_url" type="string | null">

Okta domain base URL (e.g., 'https://your-org.okta.com')

Default: `null`.

</ParamField>

## Get user

Action ID: `tools.okta_oar.get_user`

Get an Okta user by ID.

Reference: [https://developer.okta.com/docs/api/openapi/okta-management/management/tags/user/#get-user](https://developer.okta.com/docs/api/openapi/okta-management/management/tags/user/#get-user)

### Secrets

Required secrets:

- `okta`: required values `OKTA_API_TOKEN`.

### Input fields

<ParamField path="user_id" type="string" required>

User ID, login, or email of the user to retrieve

</ParamField>

<ParamField path="base_url" type="string | null">

Okta domain base URL (e.g., 'https://your-org.okta.com')

Default: `null`.

</ParamField>
