Skip to content
Connect an agent

Templates

Get a template

Get a template.

GET/v1/templates/{id}

TL;DR

QuestionAnswer
What does it do?Get a template.
What does it need?An API key or an OAuth access token.
What does it take?id in the path.
What does it return?Status 200 with a body of type Template.
In the SDK?flung.templates.get()
What can go wrong?401 Missing, unknown, revoked or expired API key; 404 No such template in this workspace; 422 The request failed validation; 429 Too many requests for this credential; wait for retry-after seconds. Every failure has the same error shape.

Example

bash
curl -X GET 'https://api.flung.dev/v1/templates/tpl_aaaaaaaaaaaaaaaaaaaaaaaa' \  --header "Authorization: Bearer $FLUNG_API_KEY"

A successful answer looks like this:

json
{  "id": "tpl_aaaaaaaaaaaaaaaaaaaaaaaa",  "name": "string",  "content": "string",  "mediaIds": [    "string"  ],  "accountIds": [    "string"  ],  "platformOverrides": {},  "createdAt": "2026-11-01T09:00:00.000Z",  "updatedAt": "2026-11-01T09:00:00.000Z"}

Path parameters

FieldTypeRequiredDescription
idstringyes

Responses

StatusMeaningBody
200The template.Template
401Missing, unknown, revoked or expired API key.Error
404No such template in this workspace.Error
422The request failed validation.Error
429Too many requests for this credential; wait for retry-after seconds.Error

Response body

A 200 answer has the type Template.

FieldTypeRequiredDescription
idstringyes
namestringyes
contentstringyes
mediaIdsstring[]yes
accountIdsstring[]yes
platformOverridesobjectyes
platformOverrides.xobjectno
platformOverrides.x.contentstringno
platformOverrides.x.boardIdstringno
platformOverrides.instagramobjectno
platformOverrides.instagram.contentstringno
platformOverrides.instagram.boardIdstringno
platformOverrides.facebookobjectno
platformOverrides.facebook.contentstringno
platformOverrides.facebook.boardIdstringno
platformOverrides.threadsobjectno
platformOverrides.threads.contentstringno
platformOverrides.threads.boardIdstringno
platformOverrides.linkedinobjectno
platformOverrides.linkedin.contentstringno
platformOverrides.linkedin.boardIdstringno
platformOverrides.tiktokobjectno
platformOverrides.tiktok.contentstringno
platformOverrides.tiktok.boardIdstringno
platformOverrides.youtubeobjectno
platformOverrides.youtube.contentstringno
platformOverrides.youtube.boardIdstringno
platformOverrides.pinterestobjectno
platformOverrides.pinterest.contentstringno
platformOverrides.pinterest.boardIdstringno
platformOverrides.blueskyobjectno
platformOverrides.bluesky.contentstringno
platformOverrides.bluesky.boardIdstringno
platformOverrides.mastodonobjectno
platformOverrides.mastodon.contentstringno
platformOverrides.mastodon.boardIdstringno
platformOverrides.discordobjectno
platformOverrides.discord.contentstringno
platformOverrides.discord.boardIdstringno
platformOverrides.farcasterobjectno
platformOverrides.farcaster.contentstringno
platformOverrides.farcaster.boardIdstringno
createdAtstringyes
updatedAtstringyes

See also

DocWhy
API referenceEvery endpoint
SchemasEvery request and response type
ErrorsEvery error code and what to do about it