giphy.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.
Analytics
register
analytics.register
Register a GIF view, click, or send via its analytics pingback URL
Risk: write
await corsair.giphy.api.analytics.register({});
| Name | Type | Required | Description |
|---|---|---|---|
pingback_url | string | Yes | Tracking URL from a GIF analytics object (onload, onclick, or onsent) |
customer_id | string | Yes | Identifier assigned to a user in your platform |
ts | number | No | UNIX timestamp in milliseconds of when the action occurred. Default: now |
| Name | Type | Required | Description |
|---|---|---|---|
success | boolean | Yes | — |
Categories
getById
categories.getById
Get subcategories of a specific GIPHY category by ID
Risk: read
await corsair.giphy.api.categories.getById({});
| Name | Type | Required | Description |
|---|---|---|---|
category_id | string | Yes | Category identifier (name_encoded value from categories.list, e.g. “actions”) |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
name: string,
name_encoded?: string,
subcategories?: {
name: string,
name_encoded?: string
}[],
gif?: {
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
gifs
categories.gifs
Fetch GIFs associated with a specific GIPHY category
Risk: read
await corsair.giphy.api.categories.gifs({});
| Name | Type | Required | Description |
|---|---|---|---|
category_id | string | Yes | Category identifier (name_encoded value from categories.list, e.g. “actions”) |
limit | number | No | The maximum number of objects to return. Default: 25 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
list
categories.list
List all categories and subcategories on GIPHY
Risk: read
await corsair.giphy.api.categories.list({});
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
name: string,
name_encoded?: string,
subcategories?: {
name: string,
name_encoded?: string
}[],
gif?: {
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
Channels
search
channels.search
Search GIPHY channels matching a query term
Risk: read
await corsair.giphy.api.channels.search({});
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Term to search through GIPHY channels |
limit | number | No | The maximum number of objects to return. Default: 25, maximum: 50 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
id?: number,
slug?: string,
display_name?: string,
content_type?: string,
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
Emoji
get
emoji.get
Fetch animated emojis from GIPHY
Risk: read
await corsair.giphy.api.emoji.get({});
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | The maximum number of objects to return. Default: 25 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
variations
emoji.variations
Get variations of a specific GIPHY emoji by ID
Risk: read
await corsair.giphy.api.emoji.variations({});
| Name | Type | Required | Description |
|---|---|---|---|
gif_id | string | Yes | GIPHY Emoji GIF ID to get variations for |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
Gifs
getById
gifs.getById
Get details and renditions of a specific GIF by ID
Risk: read
await corsair.giphy.api.gifs.getById({});
| Name | Type | Required | Description |
|---|---|---|---|
gif_id | string | Yes | GIPHY GIF ID |
rating | g | pg | pg-13 | r | No | If the GIF rating exceeds this, the API returns an empty error response |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
getByIds
gifs.getByIds
Get details and renditions for multiple GIFs by their IDs
Risk: read
await corsair.giphy.api.gifs.getByIds({});
| Name | Type | Required | Description |
|---|---|---|---|
ids | string[] | string | Yes | Array of GIF IDs or comma-separated string |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
random
gifs.random
Fetch a random GIF from GIPHY optionally filtered by tag
Risk: read
await corsair.giphy.api.gifs.random({});
| Name | Type | Required | Description |
|---|---|---|---|
tag | string | No | Filters results by specified tag |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
random_id | string | No | Deprecated alias for customer_id, kept for backwards compatibility |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
search
gifs.search
Search all GIPHY GIFs for a word or phrase
Risk: read
await corsair.giphy.api.gifs.search({});
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query term or phrase |
limit | number | No | The maximum number of objects to return. Default: 25 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
lang | string | No | Specify default language for regional content |
random_id | string | No | Deprecated alias for customer_id, kept for backwards compatibility |
customer_id | string | No | Identifier assigned to a user in your platform |
channel_ids | string | No | Filters results by specified channel IDs, separated by commas. Maximum: 5 |
bundle | string | No | Returns upload or clips data |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
translate
gifs.translate
Translate a word or phrase into a GIF using GIPHY translate endpoint
Risk: read
await corsair.giphy.api.gifs.translate({});
| Name | Type | Required | Description |
|---|---|---|---|
s | string | Yes | Search term to translate into a GIF |
weirdness | number | No | Value from 0-10 on the weirdness scale |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
trending
gifs.trending
Fetch currently trending GIFs from GIPHY
Risk: read
await corsair.giphy.api.gifs.trending({});
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | The maximum number of objects to return. Default: 25 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
random_id | string | No | Deprecated alias for customer_id, kept for backwards compatibility |
customer_id | string | No | Identifier assigned to a user in your platform |
bundle | string | No | Returns upload or clips data |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
upload
gifs.upload
Upload an animated GIF or video to GIPHY from a file or a public URL
Risk: write
await corsair.giphy.api.gifs.upload({});
| Name | Type | Required | Description |
|---|---|---|---|
file_base64 | string | No | Animated GIF or video file content as base64. Required when source_image_url is omitted |
file_name | string | No | Filename for the multipart upload part. Default: upload.gif |
source_image_url | string | No | Public URL of the image or video to upload. Required when file_base64 is omitted |
tags | string | No | Comma-delimited list of tags applied to the upload |
source_post_url | string | No | URL of the source of the asset |
username | string | No | Assigned username (approved production apps only) |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
id: string
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
Random Id
get
randomId.get
Generate a privacy-safe random ID to use as customer_id on other endpoints
Risk: read
await corsair.giphy.api.randomId.get({});
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
random_id: string
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
Stickers
random
stickers.random
Fetch a random sticker from GIPHY optionally filtered by tag
Risk: read
await corsair.giphy.api.stickers.random({});
| Name | Type | Required | Description |
|---|---|---|---|
tag | string | No | Filters results by specified tag |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
search
stickers.search
Search GIPHY animated stickers for a word or phrase
Risk: read
await corsair.giphy.api.stickers.search({});
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query term or phrase |
limit | number | No | The maximum number of objects to return. Default: 25 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
lang | string | No | Specify default language for regional content |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
translate
stickers.translate
Translate a word or phrase into a sticker
Risk: read
await corsair.giphy.api.stickers.translate({});
| Name | Type | Required | Description |
|---|---|---|---|
s | string | Yes | Search term to translate into a sticker |
weirdness | number | No | Value from 0-10 on the weirdness scale |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | Yes | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
trending
stickers.trending
Fetch currently trending stickers from GIPHY
Risk: read
await corsair.giphy.api.stickers.trending({});
| Name | Type | Required | Description |
|---|---|---|---|
limit | number | No | The maximum number of objects to return. Default: 25 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
rating | g | pg | pg-13 | r | No | Filters results by specified rating |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
pagination | object | No | — |
meta | object | No | — |
data full type
data full type
{
type?: string,
id: string,
url?: string,
slug?: string,
bitly_gif_url?: string,
bitly_url?: string,
embed_url?: string,
username?: string,
source?: string,
title?: string,
rating?: string,
content_url?: string,
source_tld?: string,
source_post_url?: string,
is_sticker?: number,
import_datetime?: string,
trending_datetime?: string,
images?: {
},
user?: {
avatar_url?: string,
banner_image?: string,
banner_url?: string,
profile_url?: string,
username?: string,
display_name?: string,
description?: string,
instagram_url?: string,
website_url?: string,
is_verified?: boolean
}
}[]
pagination full type
pagination full type
{
total_count?: number,
count?: number,
offset?: number
}
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
Tags
autocomplete
tags.autocomplete
Autocomplete a tag term on the GIPHY network
Risk: read
await corsair.giphy.api.tags.autocomplete({});
| Name | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Tag term to autocomplete |
limit | number | No | The maximum number of objects to return. Default: 5 |
offset | number | No | Specifies the starting position of the results. Default: 0 |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
meta | object | No | — |
data full type
data full type
{
name: string
}[]
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
related
tags.related
List tag terms related to the given tag on GIPHY
Risk: read
await corsair.giphy.api.tags.related({});
| Name | Type | Required | Description |
|---|---|---|---|
term | string | Yes | Tag term to find related tags for |
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | — |
meta | object | No | — |
data full type
data full type
{
name: string
}[]
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}
trending
tags.trending
List the most popular trending search terms on GIPHY
Risk: read
await corsair.giphy.api.tags.trending({});
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | string | No | Identifier assigned to a user in your platform |
| Name | Type | Required | Description |
|---|---|---|---|
data | string[] | Yes | — |
meta | object | No | — |
meta full type
meta full type
{
status?: number,
msg?: string,
response_id?: string
}