---
title: "Create a one-time OpenPost Image Editor composer return token"
method: POST
path: "/image-editor/return-tokens"
tags: ["OpenPost Image Editor"]
---

# Create a one-time OpenPost Image Editor composer return token

`POST /image-editor/return-tokens`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/image-editor/return-tokens`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Request body

- CreateImageEditorReturnTokenInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `constraints` object, required
  - `max_selection` integer, required
  - `purpose` string, required
  - `return_url` string, required
  - `workspace_id` string, required

## Response `201`

Created

- CreateImageEditorReturnTokenOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `expires_at` string, required
  - `token` string, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)