コンテンツにスキップ

/notes

POST
/notes

Authorizations

Request Body

object
content
required

Note content (max 3000 characters/if attachment file exists, allow 0 character)

string
"" <= 3000 characters
hello world!
visibility
required

Note visibility (PUBLIC/HOME/FOLLOWERS/DIRECT)

string
default: PUBLIC
PUBLIC
attachment_file_ids
required

Attachment file IDs (max 16 files)

Array<string>
default: <= 16 items
[
"38477395",
"38477396"
]
contents_warning_comment
required

Contents warning comment (max 256 characters)

string
"" <= 256 characters
This note contains sensitive content
send_to

Send to account ID (if visibility is DIRECT)

string
""
38477395

Responses

200

OK

object
id
required

Note ID

string
38477395
content
required

Note content

string
hello world!
visibility
required

Note visibility

string
PUBLIC
contents_warning_comment
required

Contents warning comment

string
This note contains sensitive content
send_to

Send to account ID

string
38477395
author_id
required

Author account ID

string
38477395
created_at
required

Note created date

string
2021-01-01T00:00:00Z
attachment_files
required

Note Attachment Media

Array<object>
<= 16 items
object
id
required

Attachment Medium id

string
39783475
name
required

Attachment filename

string
image.jpg
author_id
required

Attachment author account id

string
309823457
hash
required

Attachment medium blurhash

string
e9f*5oin{dn
mime
required

Attachment medium mime type

string
image/jpeg
nsfw
required

If true, attachment is nsfw

boolean
url
required

Attachment medium url

string format: uri
https://images.example.com/image.webp
thumbnail
required

Attachment thumbnail url

string
https://images.example.com/image_thumbnail.webp

400

Bad Request

object
error
required
Any of:

This note has too many attachments

string
Allowed values: TOO_MANY_ATTACHMENTS

403

You are silenced

You can’t set note visibility to PUBLIC

object
error
required

You are silenced (You cannot set visibility to public

string
Allowed values: YOU_ARE_SILENCED

404

Not Found

object
error
required
Any of:

Attachment not found

string
Allowed values: ATTACHMENT_NOT_FOUND

500

Internal Server Error

Internal Error

object
error
required

Internal Error

string
Allowed values: INTERNAL_ERROR