---
title: "Create delegated authorization"
method: POST
path: "/api/v1/oauth/authorization-grant/delegate"
tags: ["General.OAuth", "ENTERPRISE", "REGION.US"]
---

# Create delegated authorization

`POST /api/v1/oauth/authorization-grant/delegate`

Creates a delegated scoped authorization code for a user. The difference between this and `authorization-grant` is that this endpoint allows the client to specify an actor client that is allowed to use the authorization code. This is useful when a client wants to delegate access to another client.

## Response `200`

Authorization code successfully created.

- OAuth2AuthorizeResponse
  - `code` string, required — Authorization code which is single-use only and short-lived. It should be treated as opaque (no defined format).

## Other responses

- `400` — Error envelope. `errorDetails` is omitted when empty. This service returns more descriptive errors than the published contract; the machine-readable codes and human-readable messages are stable.
- `401` — Error envelope. `errorDetails` is omitted when empty. This service returns more descriptive errors than the published contract; the machine-readable codes and human-readable messages are stable.
- `404` — Error envelope. `errorDetails` is omitted when empty. This service returns more descriptive errors than the published contract; the machine-readable codes and human-readable messages are stable.
- `409` — Error envelope. `errorDetails` is omitted when empty. This service returns more descriptive errors than the published contract; the machine-readable codes and human-readable messages are stable.
- `500` — Error envelope. `errorDetails` is omitted when empty. This service returns more descriptive errors than the published contract; the machine-readable codes and human-readable messages are stable.

---

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