Skip to content

Request Publication

POST
/api/v1/social-publications
curl --request POST \
--url https://api.ultimateteam.ai/api/v1/social-publications \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <X-API-Key>' \
--data '{ "account_id": "example", "article_title": "example", "article_url": "example", "connector_instance_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "content": "example", "media": [ { "content_type": "image/jpeg", "generation": 1, "sha256": "example", "size_bytes": 1 } ], "platform": "example", "social_post_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'
Media typeapplication/json
SocialPublication

The immutable owner-reviewed provider account, text and media identity.

object
account_id
required
Account Id
string
>= 1 characters <= 255 characters
article_title
Any of:
string
>= 1 characters <= 399 characters
article_url
Any of:
string
<= 2048 characters
connector_instance_id
required
Connector Instance Id
string format: uuid
content
required
Content
string
>= 1 characters <= 63206 characters
media
Media
Array<object>
<= 10 items
SocialMediaAsset
object
content_type
required
Content Type
string
Allowed values: image/jpeg image/png image/gif video/mp4
generation
required
Generation
integer
> 0
sha256
required
Sha256
string
/^[0-9a-f]{64}$/
size_bytes
required
Size Bytes
integer
> 0 <= 20971520
platform
required
Platform
string
/^(x_twitter|twitter|linkedin|facebook|instagram)$/
social_post_id
required
Social Post Id
string format: uuid

Successful Response

Media typeapplication/json
SocialTaskResponse
object
social_post_id
required
Social Post Id
string format: uuid
status
required
Status
string
task_id
required
Task Id
string format: uuid
Examplegenerated
{
"social_post_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"status": "example",
"task_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}