---
title: "Issue signed workspace app token"
method: POST
path: "/api/v2/workspaceproxies/me/issue-signed-app-token"
tags: ["Enterprise"]
---

# Issue signed workspace app token

`POST /api/v2/workspaceproxies/me/issue-signed-app-token`

## Request body

- WorkspaceappsIssueTokenRequest
  - `app_hostname` string — AppHostname is the optional hostname for subdomain apps on the external proxy. It must start with an asterisk.
  - `app_path` string — AppPath is the path of the user underneath the app base path.
  - `app_query` string — AppQuery is the query parameters the user provided in the app request.
  - `app_request` WorkspaceappsRequest
    - `access_method` 'path' | 'subdomain' | 'terminal'
    - `agent_name_or_id` string — AgentNameOrID is not required if the workspace has only one agent.
    - `app_prefix` string — Prefix is the prefix of the subdomain app URL. Prefix should have a trailing "---" if set.
    - `app_slug_or_port` string
    - `base_path` string — BasePath of the app. For path apps, this is the path prefix in the router for this particular app. For subdomain apps, this should be "/". This is used for setting the cookie path.
    - `username_or_id` string — For the following fields, if the AccessMethod is AccessMethodTerminal, then only AgentNameOrID may be set and it must be a UUID. The other fields must be left blank.
    - `workspace_name_or_id` string
  - `path_app_base_url` string — PathAppBaseURL is required.
  - `session_token` string — SessionToken is the session token provided by the user.

## Response `201`

Created

- WsproxysdkIssueSignedAppTokenResponse
  - `signed_token_str` string — SignedTokenStr should be set as a cookie on the response.

---

[API](https://skmtc.net/coder/apis/coder-api.md) · [All operations](https://skmtc.net/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coder/coder-api/revisions/333502cb4be3/schema)