Update a suggestion - YALG Developer Docs

Update a suggestion

curl --request PATCH \
  --url https://api.yalg.ai/v1/youtube-suggestions/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "How to turn stories into content",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "status": "new"
}
'

{
  "id": "018f9f52-3661-7657-81c0-bf1d02a1a50e",
  "title": "How to turn stories into content",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "status": "new",
  "createdAt": "2026-06-20T17:24:39.000Z",
  "updatedAt": "2026-06-20T17:24:39.000Z"
}

PATCH

/

v1

/

youtube-suggestions

/

{id}

Update a suggestion

curl --request PATCH \
  --url https://api.yalg.ai/v1/youtube-suggestions/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "How to turn stories into content",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "status": "new"
}
'

{
  "id": "018f9f52-3661-7657-81c0-bf1d02a1a50e",
  "title": "How to turn stories into content",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "status": "new",
  "createdAt": "2026-06-20T17:24:39.000Z",
  "updatedAt": "2026-06-20T17:24:39.000Z"
}

Authorizations

x-api-key

string

header

default:yalg_live_your_api_key

required

YALG Developer API key. Send it in the x-api-key header from a server-side environment only.

Path Parameters

id

string

required

UUID of the suggestion to update

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json

title

string

Video title

Maximum string length: 200

Example:

"10 Tips to Master TypeScript in 2024"

description

string

Video description

Example:

"In this video, we explore the best practices for TypeScript development..."

hook

string

Video hook/intro

Example:

"Are you still writing JavaScript like it's 2015? Here's what you're missing..."

tags

string[]

Video tags

Example:

["typescript", "programming", "tutorial"]

keywords

string[]

SEO keywords

Example:

[
  "typescript tutorial",
  "learn typescript",
  "typescript 2024"
]

category

enum<string>

Video category

Available options:

tutorial,

review,

vlog,

educational,

entertainment,

news,

how_to,

interview,

documentary,

other

Example:

"tutorial"

estimatedDuration

string

Estimated video duration

Example:

"15-20 minutes"

targetAudience

string

Target audience description

Example:

"Intermediate JavaScript developers looking to level up"

status

enum<string>

Suggestion status

Available options:

pending,

approved,

rejected,

used

Example:

"approved"

Response

Suggestion updated successfully

YouTube suggestion tracked by YALG.

id

string<uuid>

Suggestion identifier.

Example:

"018f9f40-7d7b-7712-9b0f-2e5d9fd5df3f"

title

string

Example:

"How to turn stories into posts"

url

string<uri>

status

string

Example:

"new"

createdAt

string<date-time>

Example:

"2026-06-20T17:24:39.000Z"

updatedAt

string<date-time>

Example:

"2026-06-20T17:24:39.000Z"

⌘I