> For the complete documentation index, see [llms.txt](https://docs.siit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siit.io/workflow/variables-and-secrets.md).

# Variables & Secrets

Store a value once and reference it from any workflow. Variables stay readable for your team; secrets encrypt at rest and are never returned by the API

#### Why it matters

Workflows often need the same value in more than one place: an API key for an external request, a base URL, a channel ID. Until now, that value lived inline in every Workflow that used it. Rotating it meant hunting down each occurrence.

Variables & secrets give you one place to store a value and reference it from any Workflow. Plain variables stay visible so your team can read them at a glance. Secrets encrypt at rest and are never returned by the API, so credentials stop living in plain text inside your Workflow configuration.

#### What you get

* **One settings page for both kinds.** Every variable and secret lives in the same list, with its name, kind, value, description, and when its value was last updated.
* **A ready-to-use reference.** Each entry resolves inside a Workflow as `{{variables.name}}` for a plain value and `{{secrets.name}}` for a secret. Insert it from the picker `/` in the action you are editing; typing the raw string into a field doesn't work.
* **Write-only secrets.** Siit shows only the last four characters of a secret. Rotating one means typing a new value; leaving the field empty keeps the current one.
* **A picker built into the Workflow editor.** Custom variables are available on supported actions. Custom secrets appear only on the **Send External Request** action, so a secret can never end up in a Slack message, a note, or a reply.
* **A dedicated permission.** Every admin can read the list, since building a Workflow requires it. Creating, editing, and deleting a variable or secret requires the `Manage company variables` permission, on by default for owners and admins.

#### How it works

1. An admin creates a variable or secret once, giving it a name, a value, and an optional description.
2. Siit generates a reference string for it (`{{variables.name}}` or `{{secrets.name}}`).
3. That reference is selectable in any Workflow action that supports it.
4. At runtime, Siit resolves the reference to the stored value. Rotating the stored value updates every Workflow that references it, with no need to open each one individually.

#### Where you can use them

| Location                                                  | Custom variables | Custom secrets | Integration tokens |
| --------------------------------------------------------- | ---------------- | -------------- | ------------------ |
| Send External Request (URL, headers, body)                | ✓                | ✓              | ✓                  |
| App access role provisioning (Send External Request)      | ✓                | ✓              | ✓                  |
| Other Workflow actions (Slack message, note, reply, etc.) | ✓                | —              | —                  |
| Message templates                                         | ✓                | —              | —                  |

> **Note:** Secrets are intentionally excluded from any action that renders content a person will read, such as a message or note. This keeps a secret from ever appearing in visible text.

#### Variables in an outbound URL

The URL of a **Send External Request**, and the submit URL of a [custom action](https://docs.siit.io/integrations/custom-integrations.md), take variables like any other field, with a few rules that keep the call pointing where you meant it to:

* The URL must start with `https://`, a custom variable, or a secret. A custom variable at the beginning can contain the base URL.
* Request and requester variables can appear in the hostname, but their values must not contain URL delimiters such as `/`, `:`, or `@`. Keep the hostname fixed when the destination should never depend on request data.
* Variable values are URL-encoded automatically, except for a leading custom variable and secrets, which are inserted as written.
* A path variable that resolves to empty text or contains a `.` or `..` path segment stops the step.

#### Setting it up

1. Go to **Settings → Requests → Variables & secrets** and click **+ New**. Choose the kind: **plain** or **secret**. The kind can't be changed after creation.
2. Give it a name (letters, numbers, and underscores, starting with a letter or underscore), a value, and an optional description.
3. Save. The entry is now usable in your Workflows as `{{variables.name}}` or `{{secrets.name}}`.
4. In any supported Workflow action, open the variable picker and select the entry you need.

#### Integration tokens as secrets

A connected integration can lend its own access token to a **Send External Request**, so you can call that tool's API without copying its credential into Siit a second time.

* Turn it on per integration. Until you do, the token is not exposed and nothing in Siit can reference it.
* Once it is on, the integration appears in **Settings → Requests → Variables & secrets** as a read-only secret named `<provider>_access_token`, with the reference `{{secrets.integrations.<provider>}}`. You cannot edit, rotate or delete it there: it is the connection's own token, and reconnecting the integration is what changes it.
* It resolves only in **Send External Request**, in a workflow or in an app access role's provisioning steps — the same places a custom secret resolves, and nowhere a person reads text.
* Only a role granted that integration sees it in the picker or may save a step that references it. A role without the integration gets the step refused, not a silent empty value.
* It is available for the integrations Siit connects directly. Integrations Siit reaches through a third party don't offer it.

#### Rotating a value

Open the variable or secret and enter a new value. Leaving the value field empty keeps the current one, so you don't need to re-enter a plain variable's value just to update its description.

> **Tip:** Rotating a secret used in several Workflows is a single change. Every reference picks up the new value automatically, so there's no need to edit each Workflow that uses it.

#### Built-in variables

Siit also provides variables from your request, people, and Workflow context. Insert them from the `/` picker; they don't need to be created in Settings. The available groups depend on the trigger and action.

Missing values generally resolve to empty text; in message templates, a missing requester or assignee resolves to `-`. Google Workspace, Okta, and Microsoft Entra group name fields accept only form fields.

**Request**

Available on request and application access triggers, and in message templates.

| Display name                   | Placeholder                                  | Resolves to                                      |
| ------------------------------ | -------------------------------------------- | ------------------------------------------------ |
| Title                          | `{{request.title}}`                          | The request subject                              |
| Description                    | `{{request.description}}`                    | The request body                                 |
| Sequential number              | `{{request.sequential_number}}`              | The request number shown in the inbox            |
| Permalink                      | `{{request.admin_permalink_url}}`            | Link to the request in the admin app             |
| Status                         | `{{request.status}}`                         | Current status                                   |
| Priority                       | `{{request.priority}}`                       | Current priority                                 |
| Service                        | `{{request.associated_to}}`                  | Name of the service the request was submitted on |
| Service category               | `{{request.service_category}}`               | Category of that service                         |
| Equipment                      | `{{request.equipment_names}}`                | Names of the equipment linked to the request     |
| Equipment category             | `{{request.equipment_categories}}`           | Their equipment types                            |
| Equipment serial number        | `{{request.equipment_serial_numbers}}`       | Their serial numbers                             |
| Equipment model                | `{{request.equipment_models}}`               | Their models                                     |
| Equipment lifecycle            | `{{request.equipment_lifecycles}}`           | Their lifecycle, such as In service or Spare     |
| Equipment office location      | `{{request.equipment_office_locations}}`     | The office location each one is attached to      |
| Requester                      | `{{request.requester}}`                      | Requester's display name                         |
| Author uid                     | `{{request.author_uid\|full_name}}`          | Full name of the person who created the request  |
| Assigned to                    | `{{request.assigned_to}}`                    | Display name of the assignee                     |
| Assignee admin                 | `{{request.assignee_admin}}`                 | Display name of the assigned admin               |
| Assignee inbox                 | `{{request.assignee_inbox}}`                 | Name of the assigned inbox                       |
| Followers                      | `{{request.followers}}`                      | Comma-separated list of followers                |
| Tags                           | `{{request.tags_uids\|tag_names}}`           | Comma-separated list of tag names                |
| Created at                     | `{{request.created_at}}`                     | Creation date                                    |
| First replied at               | `{{request.first_replied_at}}`               | Date of the first reply                          |
| First completed at             | `{{request.first_completed_at}}`             | Date the request was first resolved              |
| Completed at                   | `{{request.completed_at}}`                   | Date the request was last resolved               |
| Sla first response time due at | `{{request.sla_first_response_time_due_at}}` | Deadline of the first-response SLA               |
| Sla time to resolve due at     | `{{request.sla_time_to_resolve_due_at}}`     | Deadline of the resolution SLA                   |
| Satisfaction survey rating     | `{{request.satisfaction_survey_rating}}`     | Rating left by the requester, if any             |
| UID                            | `{{request.uid}}`                            | Technical identifier of the request              |

A request can carry several pieces of equipment, from its **Equipment** form answers or from equipment linked to it by hand. Each `request.equipment_…` variable lists them all in one comma-separated value.

**Requester**

Available on request and application access triggers, and in message templates. Values come from the requester's People record; HRIS fields depend on synced data.

| Display name        | Placeholder                                | Resolves to                                                                    |
| ------------------- | ------------------------------------------ | ------------------------------------------------------------------------------ |
| First name          | `{{requester.first_name}}`                 |                                                                                |
| Last name           | `{{requester.last_name}}`                  |                                                                                |
| Full name           | `{{requester.full_name}}`                  |                                                                                |
| Email               | `{{requester.email}}`                      | Work email                                                                     |
| Personal email      | `{{requester.personal_email}}`             |                                                                                |
| Mention             | `{{requester.mention}}`                    | An @mention in Slack or Teams, the full name elsewhere                         |
| Report to           | `{{requester.report_to\|full_name}}`       | Full name of the requester's manager, as set in People                         |
| Job title           | `{{requester.job_title}}`                  |                                                                                |
| Department          | `{{requester.department\|tag_names}}`      |                                                                                |
| Teams               | `{{requester.teams\|tag_names}}`           | Comma-separated list of teams                                                  |
| Office location     | `{{requester.office_location\|tag_names}}` |                                                                                |
| Legal entity        | `{{requester.legal_entity\|tag_names}}`    |                                                                                |
| City                | `{{requester.city}}`                       |                                                                                |
| State               | `{{requester.state}}`                      |                                                                                |
| Country             | `{{requester.country}}`                    |                                                                                |
| Type                | `{{requester.status}}`                     | Employee, External, and so on                                                  |
| Lifecycle           | `{{requester.lifecycle}}`                  | Onboarding, Active, Offboarding, and so on                                     |
| Start date          | `{{requester.job_start_date}}`             |                                                                                |
| End date            | `{{requester.job_leave_date}}`             |                                                                                |
| Probation end date  | `{{requester.probation_end_date}}`         |                                                                                |
| Tenure duration     | `{{requester.tenure}}`                     | Duration between the start date and end date, or today when no end date is set |
| Active applications | `{{requester.company_service_names}}`      | Comma-separated list of applications the person has access to                  |
| Equipments          | `{{requester.equipment_labels}}`           | Comma-separated list of assigned equipment                                     |
| UID                 | `{{requester.uid}}`                        | Technical identifier of the person                                             |

**Assignee Admin**

Available on request and application access triggers, and in message templates. Empty while the request is unassigned.

| Display name | Placeholder                     |
| ------------ | ------------------------------- |
| First name   | `{{assignee_admin.first_name}}` |
| Last name    | `{{assignee_admin.last_name}}`  |
| Full name    | `{{assignee_admin.full_name}}`  |
| Email        | `{{assignee_admin.email}}`      |
| Mention      | `{{assignee_admin.mention}}`    |

**User**

Available on People triggers. The triggering person has the same fields as Requester, using `user.` instead of `requester.`, plus **Age** (`{{user.age}}`).

**Person metadata**

The metadata you store on a People record — the key/value pairs set through the Siit API, the MCP, or a sync — is available as a variable too, one per key: `{{requester.metadata.cost_center}}`, `{{user.metadata.badge_id}}`, `{{assignee_admin.metadata.oncall_group}}`. A **People** form field exposes them the same way, under its own label.

* The picker lists the keys already in use in your workspace, under **Metadata** inside the person's group, up to 50 of them. Only keys made of letters, digits, underscores and hyphens are offered, so a key with a space in it stays out.
* A key with no value on the person resolves to empty text.
* Metadata is not available in message templates.

**Recipient**

Available on **Send message to a person** actions. Values describe the recipient.

| Display name | Placeholder                |
| ------------ | -------------------------- |
| First name   | `{{recipient.first_name}}` |
| Last name    | `{{recipient.last_name}}`  |
| Full name    | `{{recipient.full_name}}`  |
| Email        | `{{recipient.email}}`      |
| Mention      | `{{recipient.mention}}`    |

**Company**

Available in text actions, under **Requester** for request and application access triggers, **User** for People triggers, and **Company** for Date triggers.

| Display name | Placeholder                | Resolves to                                                                   |
| ------------ | -------------------------- | ----------------------------------------------------------------------------- |
| People alias | `{{company.people_alias}}` | The word your company uses for its people, such as "employees" or "teammates" |

**Application access request**

Available on application access triggers only.

| Display name      | Placeholder                               |
| ----------------- | ----------------------------------------- |
| Application       | `{{app_access_request.application_name}}` |
| Role              | `{{app_access_request.role_name}}`        |
| Business reason   | `{{app_access_request.business_reason}}`  |
| App access status | `{{app_access_request.status}}`           |
| App access UID    | `{{app_access_request.uid}}`              |

**Context**

Available on Date triggers, which run on a schedule rather than for a given person or request.

| Display name | Placeholder           | Resolves to                                 |
| ------------ | --------------------- | ------------------------------------------- |
| Date         | `{{context.date}}`    | Today's date, in your company's language    |
| Weekday      | `{{context.weekday}}` | Day of the week as a number, Sunday being 0 |
| Hour         | `{{context.hour}}`    | Current hour, 0 to 23                       |
| Month        | `{{context.month}}`   | Current month as a number                   |
| Year         | `{{context.year}}`    | Current year                                |

**Form fields**

Available when a request trigger is scoped to a service with a form. Every field appears under its label, whether it accepts one value or several.

* Text, number, date, and dropdown fields resolve to the value the requester entered.
* A **People** field exposes the User fields under its label, such as `Approver: Full name`.
* An **Application** field exposes the application's **Name**, **Link**, **Owner**, **Backup owner**, **Lifecycle**, **Status**, and **Teams**.
* An **Equipment** field resolves to the equipment label.
* A field that accepts several values resolves to all of them in one comma-separated list. On a multi-select **People** or **Application** field, each sub-field does the same: `Approvers: Full name` returns every selected person's name.

**Action outputs**

Available in later actions that accept outputs.

| Action                                                                                                                                                                                                                                          | Outputs                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Send External Request                                                                                                                                                                                                                           | HTTP status code of the response                                                                            |
| Create request                                                                                                                                                                                                                                  | UID and sequential number of the request                                                                    |
| Send Slack message                                                                                                                                                                                                                              | Link to the message                                                                                         |
| Create Slack channel                                                                                                                                                                                                                            | Channel ID and channel name                                                                                 |
| Create external ticket                                                                                                                                                                                                                          | Ticket ID, name, type, and URL                                                                              |
| Device management steps (Send Recovery Key, Send Recovery Lock Password, Clear Passcode, Reset Passcode, Clear Activation Lock, Restart Device, Shut Down Device, Lock Device, Unlock Account, Add Device To Groups, Remove Device From Groups) | Equipment, equipment category, serial number, lifecycle, model, and office location of the device it ran on |

The response body of an external request is not exposed. Neither is a secret a step issued: a **Lock Device** step returns the device it locked, never the unlock PIN.

Every action also carries a **slug**, a short name identifying it inside its workflow. Its outputs are readable as `{{actions.<slug>.<output>}}` by any later action in the same branch, and by actions inside its own sub-branches. An action nested in a sub-branch cannot be referenced that way from the parent branch. Slugs are unique within a workflow, and renaming one rewrites every reference to it, so the workflow keeps working. You set a slug through the API, or Assist does when it builds a workflow for you, and the editor shows it under the action's name. An action nobody named still has one, generated by Siit and hidden in the editor.

A [branch condition](https://docs.siit.io/workflow/branching-and-approvals.md) reads an earlier action's output the same way, as `actions.<slug>.<output>`. Renaming a slug updates the conditions that use it.

#### Troubleshooting

* **A Workflow reference isn't resolving.** Check that the variable or secret still exists under **Settings → Requests → Variables & secrets**. Deleting or renaming a variable does not update the Workflows that reference it; the reference resolves to an empty value at runtime instead.
* **I can't create or edit a variable.** You need the `Manage company variables` permission. Any admin can view the list, but changes require this permission to be enabled on your role.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.siit.io/workflow/variables-and-secrets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
