---
title: "Submit elevation request"
method: POST
path: "/elevate"
tags: ["elevate"]
---

# Submit elevation request

`POST /elevate`

Submit an elevation request with dynamic or static parameters

## Request body

- ModelsElevateRequest
  - `authenticator` string — Which provider to use for authentication
  - `duration` string — Duration in ISO 8601 format
  - `identities` string[] — Optional identities to elevate, if empty the requesting user is used
  - `providers` string[] — A role can be applied to multiple providers
  - `reason` string
  - `role` GithubComThandIoAgentInternalModelsRole
    - `authenticators` string[] — All the auth providers that the role can use. If empty then any provider can be used
    - `description` string
    - `enabled` boolean — By default enable the role
    - `groups` GithubComThandIoAgentInternalModelsGroups
      - `allow` string[]
      - `deny` string[]
    - `inherits` string[] — roles to inherit from or provider specific roles/policies etc
    - `name` string
    - `permissions` GithubComThandIoAgentInternalModelsPermissions
      - `allow` string[]
      - `deny` string[]
    - `providers` string[] — providers that can assign this role
    - `resources` GithubComThandIoAgentInternalModelsResources
      - `allow` string[]
      - `deny` string[]
    - `scopes` GithubComThandIoAgentInternalModelsRoleScopes
      - `domains` string[]
      - `groups` string[]
      - `users` string[]
    - `version` VersionVersion
    - `workflows` string[] — The workflows to execute
  - `session` GithubComThandIoAgentInternalModelsLocalSession
    - `endpoint` string — Optional endpoint associated with the session
    - `expiry` string — Expiry time of the session
    - `session` string — Encoded session token
    - `version` integer — Version of the session config
  - `workflow` string

## Response `200`

Elevation request submitted

- object

## Other responses

- `400` — Bad request

---

[API](https://skmtc.dev/thand-io/apis/thand-agent-api.md) · [All operations](https://skmtc.dev/thand-io/apis/thand-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thand-io/thand-agent-api/revisions/e76e9fea1cf9/schema)