> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta

> Reference for the Tracecat Okta integration: registered actions, required secrets, expected inputs, and example workflow usage.

## 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](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](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](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](https://your-org.okta.com)')

  Default: `null`.
</ParamField>