---
title: "Resolves a source asynchronously"
method: POST
path: "/v2/source-resolutions-v3"
tags: ["publishing"]
---

# Resolves a source asynchronously

`POST /v2/source-resolutions-v3`

Submits a source for asynchronous resolution. The response contains a source resolution ID that can be used to check the status of the resolution. A source can be any text content, URL, or other data that needs to be processed to generate a title and content. Source resolution has a user-level rate limit of **30 requests / minute**.

## Request body

- object
  - `source` union, required
    - object
      - `sourceType` 'text', required
      - `text` string, required
    - object
      - `sourceType` 'article', required
      - `url` string, required
    - object
      - `sourceType` 'youtube', required
      - `url` string, required
    - object
      - `sourceType` 'twitter', required
      - `url` string, required
    - object
      - `sourceType` 'tiktok', required
      - `url` string, required
    - object
      - `sourceType` 'perplexity-query', required
      - `text` string, required
    - object
      - `sourceType` 'audio', required
      - `url` string, required
    - object
      - `sourceType` 'pdf', required
      - `url` string, required
  - `customInstructions` string

## Response `201`

Default Response

- object
  - `id` string, required

## Other responses

- `403` — Forbidden
- `422` — Validation error
- `500` — Default Response

## Changes

- **2026-08-21** `39e94457ccb2` — 6 info
  - added the optional property `action` to the response with the `403` status
  - added the optional property `action` to the response with the `422` status
  - added the optional property `action` to the response with the `500` status
  - added the optional property `details` to the response with the `403` status
  - …2 more
- **2026-08-11** `51232970f10e` — 1 info
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/blotato/apis/blotato-api/changes/v2/source-resolutions-v3/post.md)

---

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