Skip to main content
PATCH
Update a suggestion

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:
keywords
string[]

SEO keywords

Example:
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"